[ aws . drs ]

create-extended-source-server

Description

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

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Synopsis

  create-extended-source-server
--source-server-arn <value>
[--tags <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]

Options

--source-server-arn (string)

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

--tags (map)

A list of tags associated with the extended source server.

key -> (string)

value -> (string)

Shorthand Syntax:

KeyName1=string,KeyName2=string

JSON Syntax:

{"string": "string"
  ...}

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See ‘aws help’ for descriptions of global parameters.

Output

sourceServer -> (structure)

Created extended source server.

arn -> (string)

The ARN of the Source Server.

dataReplicationInfo -> (structure)

The Data Replication Info of the Source Server.

dataReplicationError -> (structure)

Error in data replication.

error -> (string)

Error in data replication.

rawError -> (string)

Error in data replication.

dataReplicationInitiation -> (structure)

Information about whether the data replication has been initiated.

nextAttemptDateTime -> (string)

The date and time of the next attempt to initiate data replication.

startDateTime -> (string)

The date and time of the current attempt to initiate data replication.

steps -> (list)

The steps of the current attempt to initiate data replication.

(structure)

Data replication initiation step.

name -> (string)

The name of the step.

status -> (string)

The status of the step.

dataReplicationState -> (string)

The state of the data replication.

etaDateTime -> (string)

An estimate of when the data replication will be completed.

lagDuration -> (string)

Data replication lag duration.

replicatedDisks -> (list)

The disks that should be replicated.

(structure)

A disk that should be replicated.

backloggedStorageBytes -> (long)

The size of the replication backlog in bytes.

deviceName -> (string)

The name of the device.

replicatedStorageBytes -> (long)

The amount of data replicated so far in bytes.

rescannedStorageBytes -> (long)

The amount of data to be rescanned in bytes.

totalStorageBytes -> (long)

The total amount of data to be replicated in bytes.

lastLaunchResult -> (string)

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

lifeCycle -> (structure)

The lifecycle information of this Source Server.

addedToServiceDateTime -> (string)

The date and time of when the Source Server was added to the service.

elapsedReplicationDuration -> (string)

The amount of time that the Source Server has been replicating for.

firstByteDateTime -> (string)

The date and time of the first byte that was replicated from the Source Server.

lastLaunch -> (structure)

An object containing information regarding the last launch of the Source Server.

initiated -> (structure)

An object containing information regarding the initiation of the last launch of a Source Server.

apiCallDateTime -> (string)

The date and time the last Source Server launch was initiated.

jobID -> (string)

The ID of the Job that was used to last launch the Source Server.

type -> (string)

The Job type that was used to last launch the Source Server.

lastSeenByServiceDateTime -> (string)

The date and time this Source Server was last seen by the service.

recoveryInstanceId -> (string)

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

sourceProperties -> (structure)

The source properties of the Source Server.

cpus -> (list)

An array of CPUs.

(structure)

Information about a server’s CPU.

cores -> (long)

The number of CPU cores.

modelName -> (string)

The model name of the CPU.

disks -> (list)

An array of disks.

(structure)

An object representing a data storage device on a server.

bytes -> (long)

The amount of storage on the disk in bytes.

deviceName -> (string)

The disk or device name.

identificationHints -> (structure)

Hints used to uniquely identify a machine.

awsInstanceID -> (string)

AWS Instance ID identification hint.

fqdn -> (string)

Fully Qualified Domain Name identification hint.

hostname -> (string)

Hostname identification hint.

vmWareUuid -> (string)

vCenter VM path identification hint.

lastUpdatedDateTime -> (string)

The date and time the Source Properties were last updated on.

networkInterfaces -> (list)

An array of network interfaces.

(structure)

Network interface.

ips -> (list)

Network interface IPs.

(string)

isPrimary -> (boolean)

Whether this is the primary network interface.

macAddress -> (string)

The MAC address of the network interface.

os -> (structure)

Operating system.

fullString -> (string)

The long name of the Operating System.

ramBytes -> (long)

The amount of RAM in bytes.

recommendedInstanceType -> (string)

The recommended EC2 instance type that will be used when recovering the Source Server.

sourceServerID -> (string)

The ID of the Source Server.

stagingArea -> (structure)

The staging area of the source server.

errorMessage -> (string)

Shows an error message that occurred when DRS tried to access the staging source server. In this case StagingArea$status will have value EXTENSION_ERROR

stagingAccountID -> (string)

Account ID of the account to which source server belongs. If this source server is extended - shows Account ID of staging source server.

stagingSourceServerArn -> (string)

Arn of the staging source server if this source server is extended

status -> (string)

Status of Source server extension. Possible values: (a) NOT_EXTENDED - This is a source server that is replicating in the current account. (b) EXTENDED - Source server is extended from a staging source server. In this case, the value of stagingSourceServerArn is pointing to the Arn of the source server in the staging account. (c) EXTENSION_ERROR - Some issue occurred when accessing staging source server. In this case, errorMessage field will contain an error message that explains what happened.

tags -> (map)

The tags associated with the Source Server.

key -> (string)

value -> (string)