ListRecoveryGroups, CreateRecoveryGroup - Amazon Route 53 Application Recovery Controller

ListRecoveryGroups, CreateRecoveryGroup

URI

/recoverygroups

HTTP methods

GET

Operation ID: ListRecoveryGroups

Lists the recovery groups in an account.

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
200ListRecoveryGroupsResult

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.

429None

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

500None

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

POST

Operation ID: CreateRecoveryGroup

Creates a recovery group in an account. A recovery group corresponds to an application and includes a list of the cells that make up the application.

Responses
Status codeResponse modelDescription
200RecoveryGroupOutput

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.

409None

409 response - Conflict exception. You might be using a predefined variable.

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

Enable CORS by returning correct headers

Responses
Status codeResponse modelDescription
200None

200 response - Success.

Schemas

Request bodies

{ "cells": [ "string" ], "recoveryGroupName": "string", "tags": { } }

Response bodies

{ "nextToken": "string", "recoveryGroups": [ { "cells": [ "string" ], "recoveryGroupName": "string", "recoveryGroupArn": "string", "tags": { } } ] }
{ "cells": [ "string" ], "recoveryGroupName": "string", "recoveryGroupArn": "string", "tags": { } }

Properties

ListRecoveryGroupsResult

The result of a successful ListRecoveryGroups request.

PropertyTypeRequiredDescription
nextToken

string

False

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

recoveryGroups

Array of type RecoveryGroupOutput

False

A list of recovery groups.

RecoveryGroupCreateParameters

Parameters used to create a recovery group. A recovery group corresponds to your application and includes the cells that make up the application.

PropertyTypeRequiredDescription
cells

Array of type string

False

A list of the cell Amazon Resource Names (ARNs) in the recovery group.

recoveryGroupName

string

True

The name of the recovery group to create.

tags

Tags

False

RecoveryGroupOutput

A representation of the application, typically containing multiple cells.

PropertyTypeRequiredDescription
cells

Array of type string

True

A list of a cell's Amazon Resource Names (ARNs).

recoveryGroupArn

string

MaxLength: 256

True

The Amazon Resource Name (ARN) for the recovery group.

recoveryGroupName

string

Pattern: \A[a-zA-Z0-9_]+\z

MaxLength: 64

True

The name of the recovery group.

tags

Tags

False

The tags associated with the recovery group.

Tags

A collection of tags associated with a resource.

PropertyTypeRequiredDescription

*

string

False

See also

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

ListRecoveryGroups

CreateRecoveryGroup