RetryDataReplicationCommand

Suggest an Edit
  • WARNING: RetryDataReplication is deprecated

WARNING: RetryDataReplication is deprecated. Causes the data replication initiation sequence to begin immediately upon next Handshake for the specified Source Server ID, regardless of when the previous initiation started. This command will work only if the Source Server is stalled or is in a DISCONNECTED or STOPPED state.

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { DrsClient, RetryDataReplicationCommand } from "@aws-sdk/client-drs"; // ES Modules import
// const { DrsClient, RetryDataReplicationCommand } = require("@aws-sdk/client-drs"); // CommonJS import
const client = new DrsClient(config);
const input = { // RetryDataReplicationRequest
  sourceServerID: "STRING_VALUE", // required
};
const command = new RetryDataReplicationCommand(input);
const response = await client.send(command);
// { // SourceServer
//   sourceServerID: "STRING_VALUE",
//   arn: "STRING_VALUE",
//   tags: { // TagsMap
//     "<keys>": "STRING_VALUE",
//   },
//   recoveryInstanceId: "STRING_VALUE",
//   lastLaunchResult: "STRING_VALUE",
//   dataReplicationInfo: { // DataReplicationInfo
//     lagDuration: "STRING_VALUE",
//     etaDateTime: "STRING_VALUE",
//     replicatedDisks: [ // DataReplicationInfoReplicatedDisks
//       { // DataReplicationInfoReplicatedDisk
//         deviceName: "STRING_VALUE",
//         totalStorageBytes: Number("long"),
//         replicatedStorageBytes: Number("long"),
//         rescannedStorageBytes: Number("long"),
//         backloggedStorageBytes: Number("long"),
//         volumeStatus: "STRING_VALUE",
//       },
//     ],
//     dataReplicationState: "STRING_VALUE",
//     dataReplicationInitiation: { // DataReplicationInitiation
//       startDateTime: "STRING_VALUE",
//       nextAttemptDateTime: "STRING_VALUE",
//       steps: [ // DataReplicationInitiationSteps
//         { // DataReplicationInitiationStep
//           name: "STRING_VALUE",
//           status: "STRING_VALUE",
//         },
//       ],
//     },
//     dataReplicationError: { // DataReplicationError
//       error: "STRING_VALUE",
//       rawError: "STRING_VALUE",
//     },
//     stagingAvailabilityZone: "STRING_VALUE",
//     stagingOutpostArn: "STRING_VALUE",
//   },
//   lifeCycle: { // LifeCycle
//     addedToServiceDateTime: "STRING_VALUE",
//     firstByteDateTime: "STRING_VALUE",
//     elapsedReplicationDuration: "STRING_VALUE",
//     lastSeenByServiceDateTime: "STRING_VALUE",
//     lastLaunch: { // LifeCycleLastLaunch
//       initiated: { // LifeCycleLastLaunchInitiated
//         apiCallDateTime: "STRING_VALUE",
//         jobID: "STRING_VALUE",
//         type: "STRING_VALUE",
//       },
//       status: "STRING_VALUE",
//     },
//   },
//   sourceProperties: { // SourceProperties
//     lastUpdatedDateTime: "STRING_VALUE",
//     recommendedInstanceType: "STRING_VALUE",
//     identificationHints: { // IdentificationHints
//       fqdn: "STRING_VALUE",
//       hostname: "STRING_VALUE",
//       vmWareUuid: "STRING_VALUE",
//       awsInstanceID: "STRING_VALUE",
//     },
//     networkInterfaces: [ // NetworkInterfaces
//       { // NetworkInterface
//         macAddress: "STRING_VALUE",
//         ips: [ // IPsList
//           "STRING_VALUE",
//         ],
//         isPrimary: true || false,
//       },
//     ],
//     disks: [ // Disks
//       { // Disk
//         deviceName: "STRING_VALUE",
//         bytes: Number("long"),
//       },
//     ],
//     cpus: [ // Cpus
//       { // CPU
//         cores: Number("long"),
//         modelName: "STRING_VALUE",
//       },
//     ],
//     ramBytes: Number("long"),
//     os: { // OS
//       fullString: "STRING_VALUE",
//     },
//     supportsNitroInstances: true || false,
//   },
//   stagingArea: { // StagingArea
//     status: "STRING_VALUE",
//     stagingAccountID: "STRING_VALUE",
//     stagingSourceServerArn: "STRING_VALUE",
//     errorMessage: "STRING_VALUE",
//   },
//   sourceCloudProperties: { // SourceCloudProperties
//     originAccountID: "STRING_VALUE",
//     originRegion: "STRING_VALUE",
//     originAvailabilityZone: "STRING_VALUE",
//     sourceOutpostArn: "STRING_VALUE",
//   },
//   replicationDirection: "STRING_VALUE",
//   reversedDirectionSourceServerArn: "STRING_VALUE",
//   sourceNetworkID: "STRING_VALUE",
//   agentVersion: "STRING_VALUE",
// };

RetryDataReplicationCommand Input

See RetryDataReplicationCommandInput for more details

Parameter
Type
Description
sourceServerID
Required
string | undefined

The ID of the Source Server whose data replication should be retried.

RetryDataReplicationCommand Output

See RetryDataReplicationCommandOutput for details

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.
agentVersion
string | undefined

The version of the DRS agent installed on the source server

arn
string | undefined

The ARN of the Source Server.

dataReplicationInfo
DataReplicationInfo | undefined

The Data Replication Info of the Source Server.

lastLaunchResult
LastLaunchResult | undefined

The status of the last recovery launch of this Source Server.

lifeCycle
LifeCycle | undefined

The lifecycle information of this Source Server.

recoveryInstanceId
string | undefined

The ID of the Recovery Instance associated with this Source Server.

replicationDirection
ReplicationDirection | undefined

Replication direction of the Source Server.

reversedDirectionSourceServerArn
string | undefined

For EC2-originated Source Servers which have been failed over and then failed back, this value will mean the ARN of the Source Server on the opposite replication direction.

sourceCloudProperties
SourceCloudProperties | undefined

Source cloud properties of the Source Server.

sourceNetworkID
string | undefined

ID of the Source Network which is protecting this Source Server's network.

sourceProperties
SourceProperties | undefined

The source properties of the Source Server.

sourceServerID
string | undefined

The ID of the Source Server.

stagingArea
StagingArea | undefined

The staging area of the source server.

tags
Record<string, string> | undefined

The tags associated with the Source Server.

Throws

Name
Fault
Details
InternalServerException
server

The request processing has failed because of an unknown error, exception or failure.

ResourceNotFoundException
client

The resource for this operation was not found.

ThrottlingException
client

The request was denied due to request throttling.

UninitializedAccountException
client

The account performing the request has not been initialized.

ValidationException
client

The input fails to satisfy the constraints specified by the AWS service.

DrsServiceException
Base exception class for all service exceptions from Drs service.