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
-
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
-
- 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 ID 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: