CreateExtendedSourceServerCommand

Suggest an Edit

Create an extended source server in the target Account based on the source server in staging account.

Example Syntax

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

import { DrsClient, CreateExtendedSourceServerCommand } from "@aws-sdk/client-drs"; // ES Modules import
// const { DrsClient, CreateExtendedSourceServerCommand } = require("@aws-sdk/client-drs"); // CommonJS import
const client = new DrsClient(config);
const input = { // CreateExtendedSourceServerRequest
  sourceServerArn: "STRING_VALUE", // required
  tags: { // TagsMap
    "<keys>": "STRING_VALUE",
  },
};
const command = new CreateExtendedSourceServerCommand(input);
const response = await client.send(command);
// { // CreateExtendedSourceServerResponse
//   sourceServer: { // 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",
//   },
// };

CreateExtendedSourceServerCommand Input

See CreateExtendedSourceServerCommandInput for more details

Parameter
Type
Description
sourceServerArn
Required
string | undefined

This defines the ARN of the source server in staging Account based on which you want to create an extended source server.

tags
Record<string, string> | undefined

A list of tags associated with the extended source server.

CreateExtendedSourceServerCommand Output

See CreateExtendedSourceServerCommandOutput for details

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.
sourceServer
SourceServer | undefined

Created extended source server.

Throws

Name
Fault
Details
AccessDeniedException
client

You do not have sufficient access to perform this action.

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.

ServiceQuotaExceededException
client

The request could not be completed because its exceeded the service quota.

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.