GetReadinessCheckStatus - Amazon Route 53 Application Recovery Controller

GetReadinessCheckStatus

URI

/readinesschecks/readinessCheckName/status

HTTP methods

GET

Operation ID: GetReadinessCheckStatus

Gets the readiness status for an individual readiness check. To see the overall readiness status for a recovery group, that considers the readiness status for all the readiness checks in a recovery group, use GetRecoveryGroupReadinessSummary.

Path parameters
NameTypeRequiredDescription
readinessCheckNameStringTrue

Name of a readiness check.

Query parameters
NameTypeRequiredDescription
nextTokenStringFalse

The token that identifies which batch of results you want to see.

maxResultsStringFalse

The number of objects that you want to return with this call.

Responses
Status codeResponse modelDescription
200GetReadinessCheckStatusOutput

200 response - Success.

400None

400 response - Multiple causes. For example, you might have a malformed query string, an input parameter might be out of range, or you used parameters together incorrectly.

403None

403 response - Access denied exception. You do not have sufficient access to perform this action.

404None

404 response - Malformed query string. The query string contains a syntax error or resource not found.

429None

429 response - Limit exceeded exception or too many requests exception.

500None

500 response - Internal service error or temporary service error. Retry the request.

OPTIONS

Enables CORS by returning correct headers.

Path parameters
NameTypeRequiredDescription
readinessCheckNameStringTrue

Name of a readiness check.

Responses
Status codeResponse modelDescription
200None

200 response - Success.

Schemas

Response bodies

{ "nextToken": "string", "readiness": enum, "messages": [ { "messageText": "string" } ], "resources": [ { "componentId": "string", "readiness": enum, "resourceArn": "string", "lastCheckedTimestamp": "string" } ] }

Properties

GetReadinessCheckStatusOutput

Result of a GetReadinessCheckStatus operation.

PropertyTypeRequiredDescription
messages

Array of type Message

True

Top level messages for readiness check status

nextToken

string

True

The token that identifies which batch of results you want to see.

readiness

Readiness

True

The readiness at rule level.

resources

Array of type ResourceResult

True

Summary of the readiness of resources.

Message

Information relating to readiness check status.

PropertyTypeRequiredDescription
messageText

string

False

The text of a readiness check message.

Readiness

The readiness status.

  • READY

  • NOT_READY

  • UNKNOWN

  • NOT_AUTHORIZED

ResourceResult

The result of a successful Resource request, with status for an individual resource.

PropertyTypeRequiredDescription
componentId

string

False

The component id of the resource.

lastCheckedTimestamp

string

True

The time (UTC) that the resource was last checked for readiness, in ISO-8601 format.

readiness

Readiness

True

The readiness of a resource.

resourceArn

string

False

The Amazon Resource Name (ARN) of the resource.

See also

For more information about using this API in one of the language-specific AWS SDKs and references, see the following:

GetReadinessCheckStatus