Groups Api Get Ssh Mfa Fallback

Groups Api Get Ssh Mfa Fallback
Get a Group's SSH MFA fallback

Accessible to every authenticated role. The Group's 'Require MFA for all SSH users' setting. It is on exactly when the shared Console-managed catch-all Policy (one Policy for all Groups) is attached to the Group. state separates saved from published: PENDING_ON and PENDING_OFF need a Group Publish, and neither says what a host has applied.

Request
URI
GET
https://{api_host}/api/v1/groups/{id}/ssh-mfa-fallback
COPY
Path Parameters
integer
id
Required  

Security Group id

id example
1

Authentication
This operation uses the following authentication methods.
Responses
200

200 OK successful response envelope. The fallback setting and its state

Returns SshMfaFallbackDto of type(s) application/json
{
    "groupId": 1,
    "state": "PENDING_ON",
    "enabled": true,
    "policyId": 12,
    "ruleId": 345,
    "publishedVersion": 4,
    "groupHasPendingChanges": true,
    "manualCatchAlls": [],
    "credentialsInBundle": 2
}
integer As int64 As int64
groupId
Required  

Security Group id

string
state
Required  

OFF, PENDING_ON (saved, not published), ON (published) or PENDING_OFF (removal saved, not published). Says nothing about what a host has applied.

Enumeration: OFF, PENDING_ON, ON, PENDING_OFF
boolean
enabled
Required  

True when the shared managed Policy is attached to the Group (ON or PENDING_ON).

integer As int64 As int64
policyId
Optional

Id of the shared Console-managed Policy, when it exists

integer As int64 As int64
ruleId
Optional

Id of the shared Console-managed catch-all rule, when it exists

integer As int64 As int64
publishedVersion
Required  

The Group's last published revision.

boolean
groupHasPendingChanges
Required  

True when the Group has changes that a Publish would send

array of object
manualCatchAlls
Required  

Catch-all SSH MFA rules an administrator authored in the Policies attached to the Group

integer As int32 As int32
credentialsInBundle
Required  

How many MFA credentials (enabled, enrolled users) the Group's bundle would carry on publish. Zero means no seed reaches the hosts, so an all-users rule may not be enforced.


400

400 Bad Request: INVALID_ARGUMENT when the id path variable is not a number

Returns ApiErrorResponse of type(s) application/json
{
    "errorCode": "string",
    "message": "string",
    "path": "string",
    "timestamp": "string",
    "reason": "string"
}
errorCode
Required  

Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.

string
message
Required  

Human-readable error description

string
path
Required  

Request URI path that produced the error

string As date-time As date-time
timestamp
Required  

Timestamp when the error occurred as an ISO 8601 date-time with offset

string
reason
Optional

A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.


401

401 Unauthorized: UNAUTHENTICATED when the VTP_SESSION cookie is missing, unknown, expired or revoked

Returns Unauthenticated of type(s) application/json
{
    "errorCode": "string",
    "message": "string",
    "path": "string",
    "timestamp": "string",
    "reason": "string"
}
errorCode
Required  

Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.

string
message
Required  

Human-readable error description

string
path
Required  

Request URI path that produced the error

string As date-time As date-time
timestamp
Required  

Timestamp when the error occurred as an ISO 8601 date-time with offset

string
reason
Optional

A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.


404

404 Not Found: SECURITY_GROUP_NOT_FOUND

Returns ApiErrorResponse of type(s) application/json
{
    "errorCode": "string",
    "message": "string",
    "path": "string",
    "timestamp": "string",
    "reason": "string"
}
errorCode
Required  

Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.

string
message
Required  

Human-readable error description

string
path
Required  

Request URI path that produced the error

string As date-time As date-time
timestamp
Required  

Timestamp when the error occurred as an ISO 8601 date-time with offset

string
reason
Optional

A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.


Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/api/v1/groups/{id}/ssh-mfa-fallback