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 withProtectedResourceConditions
. Alternatively, you can include up to 30 specific protected resource ARNs inProtectedResourceArns
.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
-
The time that the resource testing selection was created.
Type: Timestamp
- RestoreTestingPlanArn
-
The ARN of the restore testing plan with which the restore testing selection is associated.
Type: String
- RestoreTestingPlanName
-
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
-
The name of the restore testing selection for 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 Amazon SDKs, see the following: