Sign In to the Console
AWS Server Migration Service
API Reference (API Version 2016-10-24)

AWS Documentation » AWS SMS » API Reference » Actions » UpdateReplicationJob
The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

UpdateReplicationJob

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.

description

The description of the replication job.

Type: String

Required: No

encrypted

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

Type: Boolean

Required: No

frequency

The time between consecutive replication runs, in hours.

Type: Integer

Required: No

kmsKeyId

KMS key ID 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.

Type: String

Required: No

licenseType

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

Type: String

Valid Values: AWS | BYOL

Required: No

nextReplicationRunStartTime

The start time of the next replication run.

Type: Timestamp

Required: No

numberOfRecentAmisToKeep

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

replicationJobId

The identifier of the replication job.

Type: String

Required: Yes

roleName

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.

Errors

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

InternalError

An internal error occurred.

HTTP Status Code: 500

InvalidParameterException

A specified parameter is not valid.

HTTP Status Code: 400

MissingRequiredParameterException

A required parameter is missing.

HTTP Status Code: 400

OperationNotPermittedException

This operation is not allowed.

HTTP Status Code: 400

ReplicationJobNotFoundException

The specified replication job does not exist.

HTTP Status Code: 400

ServerCannotBeReplicatedException

The specified server cannot be replicated.

HTTP Status Code: 400

TemporarilyUnavailableException

The service is temporarily unavailable.

HTTP Status Code: 500

UnauthorizedOperationException

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: