AWS Recovery Details
API to get AWS recovery details
Path Parameters
- accountId int64 required
Cloud Rewind account ID.
- projectId string required
Cloud Rewind project ID.
- assemblyId int64 required
AWS cloud assembly ID.
Query Parameters
- id string required
AWS Recovery ID
- 200
- 401
- 403
- 404
- 409
- 412
- 500
OK
- application/json
- Schema
- Example (from schema)
Schema
- id string
Id of the recovery
- recoveryName string
Name of the recovery
- recoveryScope string
Defines the boundary within which the AWS resource recovery had happened.
- recoveryMode string
Specifies how resources were handled during the recovery process.
- recoveryStatus string
Possible values: [
pending
,in-progress
,aborted
,partially-completed
,completed
,failed
]Status of the recovery process.
Value Description pending The recovery process is in draft or pending state. in-progress The recovery or deployment is currently in progress. aborted The recovery process was aborted. partially-completed The recovery completed partially; some resources may not be fully recovered. completed The recovery process completed successfully. failed The recovery process has failed. - recoveryStartTime date-time
The start time of the recovery operation
- recoveryEndTime date-time
The end time of the recovery operation
- recoveryDuration int64
The duration of the recovery operation in milliseconds
- recoveryErrorMessage string
Message contains the recovery failure reasons if the recovery operation fails
- resetStatus string
Possible values: [
pending
,in-progress
,stalled
,completed
,failed
]Status of the reset operation.
Value Description pending The reset operation is pending and has not started yet. in-progress The reset operation is currently in progress. stalled The reset operation is stalled (reset is not allowed if any restore is running on the timeline). completed The reset operation completed successfully. failed The reset operation failed or the pre-reset web hook failed. - resetStartTime date-time
The start time of the recovery reset operation
- resetEndTime date-time
The end time of the recovery reset operation
- resetDuration int64
The duration of the recovery reset operation in milliseconds
- resetErrorMessage string
Message contains the reset failure reasons if the reset operation fails
resourceFilterStrategy object
Resource filter strategy used for filtering resources during the recovery process.
type stringPossible values: [
all
,custom
,tags
]Type of resource filter strategy.
Value Description all Include all the protected resources for recovery custom Filter resources based on a custom resource filter tags Filter resources based on matching resource tags tagFilter object
Defines the tag filter for
tags
based resource filtering.tagFilterCondition stringPossible values: [
match-all-tags
,match-any-tags
]Condition to apply between the resource tags for
tags
based resource filtering.Value Description match-all-tags Match resources that must have all specified tags match-any-tags Match resources that have any of the specified tags tags object[]
List of tags to filter resources
key stringKey of the tag
value stringValue of the tag
resourceFilter object
Defines the resource filter for
manual
based resource filtering.resources string[]IDs of the cloud resources for recovery
crossRegionConfiguration object
Configuration for cross-region resource recovery, required if
cross-region
recovery scope is used.recoveryRegion stringPossible values: [
us-east-1
,us-east-2
,us-west-1
,us-west-2
,ap-south-1
,ap-south-2
,ap-northeast-3
,ap-northeast-2
,ap-northeast-1
,ap-southeast-1
,ap-southeast-2
,ap-southeast-3
,ca-central-1
,eu-central-1
,eu-central-2
,eu-west-1
,eu-west-2
,eu-west-3
,eu-north-1
,sa-east-1
,af-south-1
,ap-east-1
,eu-south-1
,eu-south-2
,me-central-1
,me-south-1
,il-central-1
]Region where the recovery will take place
crossAccountConfiguration object
Configuration for Cross Account resource recovery, required if
cross-account
recovery scope is used.recoveryRegion stringPossible values: [
us-east-1
,us-east-2
,us-west-1
,us-west-2
,ap-south-1
,ap-south-2
,ap-northeast-3
,ap-northeast-2
,ap-northeast-1
,ap-southeast-1
,ap-southeast-2
,ap-southeast-3
,ca-central-1
,eu-central-1
,eu-central-2
,eu-west-1
,eu-west-2
,eu-west-3
,eu-north-1
,sa-east-1
,af-south-1
,ap-east-1
,eu-south-1
,eu-south-2
,me-central-1
,me-south-1
,il-central-1
]Region where the cross account recovery will take place
cloudConnectionId int64ID of the cloud connection for cross account recovery
crossZoneConfiguration object
Configuration for Cross zone resource recovery, required if
cross-zone
recovery scope is used.subnetMapping object
Maps a source subnet to a target subnet to enable resource recovery across different availability zones.
Format: {"source-subnet": "target-subnet"}.property name*
stringexistingNetworkConfiguration object
Configuration for existing network recovery, required if
reuse-existing
recovery mode is used.vpcId stringID of the VPC where the existing network resources are located
subnetMapping object
Maps a source subnet to a target subnet to enable resource recovery across different availability zones.
Format: {"source-subnet": "target-subnet"}.property name*
stringipAddressAllocationType stringPossible values: [
default
,dhcp
]Type of IP address allocation for AWS resources during recovery.
Value Description default Allocates the same source IP address to the recovery resource.
If the source IP is unavailable, a new IP address will be assigned.dhcp Allocate a new IP address for the recovery resource. newNetworkConfiguration object
Configuration for new network recovery, required if
rebuild
recovery mode is used.zoneMapping object
Enables resource recovery across Availability Zones using a new network configuration through zone mapping. This configuration is applicable only for same-region recovery scenarios.
Format: {"source-zone": "target-zone"}.property name*
stringdisableInboundTraffic booleanThis configuration blocks inbound traffic for the new network setup
disableOutboundTraffic booleanThis configuration blocks outbound traffic for the new network setup
extendedConfigurations object
Enables extended settings to support advanced resource recovery operations
useExistingLoadBalancer booleanAttaches the recovery resource to an already recovered load balancer. This option is applicable only for
reuse-existing
anduse-source
recovery scenarios.updateDnsRecords booleanUpdate the existing DNS Records associated with the recovery resources configuration
enableSshKeyImport booleanEnable SSH key import for the recovery resources
skipRecoveredResourceAutoProtection booleanEnable to skip auto-protection for recovered resources.
scheduleResetConfiguration object
Optional schedule reset configuration for the auto recovery reset
resetFrequency stringPossible values: [
hours
,days
]Frequency at which the recovery reset should be scheduled.
Value Description hours Resets the recovery in hours days Resets the recovery in days resetInterval int32Number representing the reset interval, e.g., '2 hours', '2 days'
webhookDetails object[]
Recovery webhook configuration for the recovery.
url stringURL to which the webhook will send notifications
webhookType stringType of the webhook
status stringStatus of the webhook trigger
httpMethod stringHTTP method used for the webhook
httpStatusCode int32HTTP status code received from the webhook trigger
timeout int32Timeout duration for the webhook trigger
errorMessage stringMessage containing the error details if the webhook trigger fails
{
"id": "string",
"recoveryName": "string",
"recoveryScope": "string",
"recoveryMode": "string",
"recoveryStatus": "pending",
"recoveryStartTime": "2025-08-28",
"recoveryEndTime": "2025-08-28",
"recoveryDuration": 0,
"recoveryErrorMessage": "string",
"resetStatus": "pending",
"resetStartTime": "2025-08-28",
"resetEndTime": "2025-08-28",
"resetDuration": 0,
"resetErrorMessage": "string",
"resourceFilterStrategy": {
"type": "all",
"tagFilter": {
"tagFilterCondition": "match-all-tags",
"tags": [
{
"key": "string",
"value": "string"
}
]
},
"resourceFilter": {
"resources": [
"string"
]
}
},
"crossRegionConfiguration": {
"recoveryRegion": "us-east-1"
},
"crossAccountConfiguration": {
"recoveryRegion": "us-east-1",
"cloudConnectionId": 0
},
"crossZoneConfiguration": {
"subnetMapping": {
"source-subnet-1": "target-subnet-1"
}
},
"existingNetworkConfiguration": {
"vpcId": "string",
"subnetMapping": {
"source-subnet-1": "target-subnet-1"
},
"ipAddressAllocationType": "default"
},
"newNetworkConfiguration": {
"zoneMapping": {
"us-east-1a": "us-east-1b"
},
"disableInboundTraffic": true,
"disableOutboundTraffic": true
},
"extendedConfigurations": {
"useExistingLoadBalancer": true,
"updateDnsRecords": true,
"enableSshKeyImport": true,
"skipRecoveredResourceAutoProtection": true
},
"scheduleResetConfiguration": {
"resetFrequency": "hours",
"resetInterval": 0
},
"webhookDetails": [
{
"url": "string",
"webhookType": "string",
"status": "string",
"httpMethod": "string",
"httpStatusCode": 0,
"timeout": 0,
"errorMessage": "string"
}
]
}
Unauthorized
- */*
- Schema
- Example (from schema)
Schema
errors object[]
code stringmessage stringtype stringfieldErrors object
property name*
string- message string
- requiredPermissions string[]
{
"errors": [
{
"code": "string",
"message": "string",
"type": "string"
}
],
"fieldErrors": {},
"message": "string",
"requiredPermissions": [
"string"
]
}
Forbidden
- */*
- Schema
- Example (from schema)
Schema
errors object[]
code stringmessage stringtype stringfieldErrors object
property name*
string- message string
- requiredPermissions string[]
{
"errors": [
{
"code": "string",
"message": "string",
"type": "string"
}
],
"fieldErrors": {},
"message": "string",
"requiredPermissions": [
"string"
]
}
Not Found
- */*
- Schema
- Example (from schema)
Schema
errors object[]
code stringmessage stringtype stringfieldErrors object
property name*
string- message string
- requiredPermissions string[]
{
"errors": [
{
"code": "string",
"message": "string",
"type": "string"
}
],
"fieldErrors": {},
"message": "string",
"requiredPermissions": [
"string"
]
}
Conflict
- */*
- Schema
- Example (from schema)
Schema
errors object[]
code stringmessage stringtype stringfieldErrors object
property name*
string- message string
- requiredPermissions string[]
{
"errors": [
{
"code": "string",
"message": "string",
"type": "string"
}
],
"fieldErrors": {},
"message": "string",
"requiredPermissions": [
"string"
]
}
Precondition Failed
- */*
- Schema
- Example (from schema)
Schema
errors object[]
code stringmessage stringtype stringfieldErrors object
property name*
string- message string
- requiredPermissions string[]
{
"errors": [
{
"code": "string",
"message": "string",
"type": "string"
}
],
"fieldErrors": {},
"message": "string",
"requiredPermissions": [
"string"
]
}
Internal Server Error
- */*
- Schema
- Example (from schema)
Schema
errors object[]
code stringmessage stringtype stringfieldErrors object
property name*
string- message string
- requiredPermissions string[]
{
"errors": [
{
"code": "string",
"message": "string",
"type": "string"
}
],
"fieldErrors": {},
"message": "string",
"requiredPermissions": [
"string"
]
}