Request Syntax Request Parameters Response Syntax Response Elements Errors See Also

CreateResiliencyGroup

Creates a resiliency group. A resiliency group lets you group Direct Connect connections together and manage them as a single unit to meet a target resiliency model.

Request Syntax


{
   "clientToken": "string",
   "intendedResiliencyModel": "string",
   "resiliencyGroupName": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

clientToken

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 128.

Required: No

intendedResiliencyModel

The resiliency model that the resiliency group is intended to meet. The valid values are maximum-resiliency, high-resiliency, and basic-resiliency.

Type: String

Valid Values: maximum-resiliency | high-resiliency | basic-resiliency

Required: Yes

resiliencyGroupName

The name of the resiliency group.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Pattern: ^[a-zA-Z0-9_\-]+$

Required: Yes

tags

The tags to associate with the resiliency group.

Type: Array of Tag objects

Array Members: Minimum number of 1 item.

Required: No

Response Syntax


{
   "resiliencyGroup": { 
      "ownerAccount": "string",
      "resiliencyGroupArn": "string",
      "resiliencyGroupId": "string",
      "resiliencyGroupName": "string",
      "resiliencyGroupType": "string",
      "state": "string",
      "tags": [ 
         { 
            "key": "string",
            "value": "string"
         }
      ]
   }
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

resiliencyGroup

Information about the resiliency group.

Type: ResiliencyGroup object

Errors

For information about the errors that are common to all actions, see Common Error Types.

DirectConnectClientException

One or more parameters are not valid.

HTTP Status Code: 400

DirectConnectServerException

A server-side error occurred.

HTTP Status Code: 400

DuplicateTagKeysException

A tag key was specified more than once.

HTTP Status Code: 400

LimitExceededException

The rate limiter limit has been exceeded for the connection. You cannot add more rate limiters to virtual interfaces on this connection.

HTTP Status Code: 400

TooManyTagsException

You have reached the limit on the number of tags that can be assigned.

HTTP Status Code: 400