CreateRestoreTestingSelection - AWS Backup

CreateRestoreTestingSelection

This request can be sent after CreateRestoreTestingPlan request returns successfully. This is the second part of creating a resource testing plan, and it must be completed sequentially.

This consists of RestoreTestingSelectionName, ProtectedResourceType, and one of the following:

  • ProtectedResourceArns

  • ProtectedResourceConditions

Each protected resource type can have one single value.

A restore testing selection can include a wildcard value ("*") for ProtectedResourceArns along with ProtectedResourceConditions. Alternatively, you can include up to 30 specific protected resource ARNs in ProtectedResourceArns.

Cannot select by both protected resource types AND specific ARNs. Request will fail if both are included.

Request Syntax

PUT /restore-testing/plans/RestoreTestingPlanName/selections HTTP/1.1 Content-type: application/json { "CreatorRequestId": "string", "RestoreTestingSelection": { "IamRoleArn": "string", "ProtectedResourceArns": [ "string" ], "ProtectedResourceConditions": { "StringEquals": [ { "Key": "string", "Value": "string" } ], "StringNotEquals": [ { "Key": "string", "Value": "string" } ] }, "ProtectedResourceType": "string", "RestoreMetadataOverrides": { "string" : "string" }, "RestoreTestingSelectionName": "string", "ValidationWindowHours": number } }

URI Request Parameters

The request uses the following URI parameters.

RestoreTestingPlanName

Input the restore testing plan name that was returned from the related CreateRestoreTestingPlan request.

Required: Yes

Request Body

The request accepts the following data in JSON format.

CreatorRequestId

This is an optional unique string that identifies the request and allows failed requests to be retried without the risk of running the operation twice. If used, this parameter must contain 1 to 50 alphanumeric or '-_.' characters.

Type: String

Required: No

RestoreTestingSelection

This consists of RestoreTestingSelectionName, ProtectedResourceType, and one of the following:

  • ProtectedResourceArns

  • ProtectedResourceConditions

Each protected resource type can have one single value.

A restore testing selection can include a wildcard value ("*") for ProtectedResourceArns along with ProtectedResourceConditions. Alternatively, you can include up to 30 specific protected resource ARNs in ProtectedResourceArns.

Type: RestoreTestingSelectionForCreate object

Required: Yes

Response Syntax

HTTP/1.1 201 Content-type: application/json { "CreationTime": number, "RestoreTestingPlanArn": "string", "RestoreTestingPlanName": "string", "RestoreTestingSelectionName": "string" }

Response Elements

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

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

CreationTime

This is the time the resource testing selection was created successfully.

Type: Timestamp

RestoreTestingPlanArn

This is the ARN of the restore testing plan with which the restore testing selection is associated.

Type: String

RestoreTestingPlanName

Unique string that is the name of the restore testing plan.

The name cannot be changed after creation. The name consists of only alphanumeric characters and underscores. Maximum length is 50.

Type: String

RestoreTestingSelectionName

This is the unique name of the restore testing selection that belongs to the related restore testing plan.

Type: String

Errors

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

AlreadyExistsException

The required resource already exists.

HTTP Status Code: 400

InvalidParameterValueException

Indicates that something is wrong with a parameter's value. For example, the value is out of range.

HTTP Status Code: 400

LimitExceededException

A limit in the request has been exceeded; for example, a maximum number of items allowed in a request.

HTTP Status Code: 400

MissingParameterValueException

Indicates that a required parameter is missing.

HTTP Status Code: 400

ResourceNotFoundException

A resource that is required for the action doesn't exist.

HTTP Status Code: 400

ServiceUnavailableException

The request failed due to a temporary failure of the server.

HTTP Status Code: 500

See Also

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