create_replication_job

create_replication_job(**kwargs)

Creates a replication job. The replication job schedules periodic replication runs to replicate your server to Amazon Web Services. Each replication run creates an Amazon Machine Image (AMI).

See also: AWS API Documentation

Request Syntax

response = client.create_replication_job(
    serverId='string',
    seedReplicationTime=datetime(2015, 1, 1),
    frequency=123,
    runOnce=True|False,
    licenseType='AWS'|'BYOL',
    roleName='string',
    description='string',
    numberOfRecentAmisToKeep=123,
    encrypted=True|False,
    kmsKeyId='string'
)
Parameters
  • serverId (string) --

    [REQUIRED]

    The ID of the server.

  • seedReplicationTime (datetime) --

    [REQUIRED]

    The seed replication time.

  • frequency (integer) -- The time between consecutive replication runs, in hours.
  • runOnce (boolean) -- Indicates whether to run the replication job one time.
  • licenseType (string) -- The license type to be used for the AMI created by a successful replication run.
  • roleName (string) -- The name of the IAM role to be used by the Server Migration Service.
  • description (string) -- The description of the replication job.
  • numberOfRecentAmisToKeep (integer) -- The maximum number of SMS-created AMIs to retain. The oldest is deleted after the maximum number is reached and a new AMI is created.
  • encrypted (boolean) -- Indicates whether the replication job produces encrypted AMIs.
  • kmsKeyId (string) --

    The ID of the KMS key for replication jobs that produce encrypted AMIs. This value can be any of the following:

    • KMS key ID
    • KMS key alias
    • ARN referring to the KMS key ID
    • ARN referring to the KMS key alias

    If encrypted is true but a KMS key ID is not specified, the customer's default KMS key for Amazon EBS is used.

Return type

dict

Returns

Response Syntax

{
    'replicationJobId': 'string'
}

Response Structure

  • (dict) --

    • replicationJobId (string) --

      The unique identifier of the replication job.

Exceptions

  • SMS.Client.exceptions.InvalidParameterException
  • SMS.Client.exceptions.MissingRequiredParameterException
  • SMS.Client.exceptions.UnauthorizedOperationException
  • SMS.Client.exceptions.OperationNotPermittedException
  • SMS.Client.exceptions.ServerCannotBeReplicatedException
  • SMS.Client.exceptions.ReplicationJobAlreadyExistsException
  • SMS.Client.exceptions.NoConnectorsAvailableException
  • SMS.Client.exceptions.InternalError
  • SMS.Client.exceptions.TemporarilyUnavailableException