UpdateReplicationJob - AWS Server Migration Service


Updates the specified settings for the specified replication job.

Request Syntax

{ "description": "string", "encrypted": boolean, "frequency": number, "kmsKeyId": "string", "licenseType": "string", "nextReplicationRunStartTime": number, "numberOfRecentAmisToKeep": number, "replicationJobId": "string", "roleName": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.


The description of the replication job.

Type: String

Required: No


When true, the replication job produces encrypted AMIs. For more information, KmsKeyId.

Type: Boolean

Required: No


The time between consecutive replication runs, in hours.

Type: Integer

Required: No


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 enabled but a KMS key ID is not specified, the customer's default KMS key for Amazon EBS is used.

Type: String

Required: No


The license type to be used for the AMI created by a successful replication run.

Type: String

Valid Values: AWS | BYOL

Required: No


The start time of the next replication run.

Type: Timestamp

Required: No


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.

Type: Integer

Required: No


The ID of the replication job.

Type: String

Required: Yes


The name of the IAM role to be used by AWS SMS.

Type: String

Required: No

Response Elements

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.


For information about the errors that are common to all actions, see Common Errors.


An internal error occurred.

HTTP Status Code: 500


A specified parameter is not valid.

HTTP Status Code: 400


A required parameter is missing.

HTTP Status Code: 400


This operation is not allowed.

HTTP Status Code: 400


The specified replication job does not exist.

HTTP Status Code: 400


The specified server cannot be replicated.

HTTP Status Code: 400


The service is temporarily unavailable.

HTTP Status Code: 500


You lack permissions needed to perform this operation. Check your IAM policies, and ensure that you are using the correct access keys.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: