---
title: "POST /#X-Amz-Target=AWSServerMigrationService_V2016_10_24.CreateReplicationJob"
method: POST
path: "/#X-Amz-Target=AWSServerMigrationService_V2016_10_24.CreateReplicationJob"
---

# POST /#X-Amz-Target=AWSServerMigrationService_V2016_10_24.CreateReplicationJob

`POST /#X-Amz-Target=AWSServerMigrationService_V2016_10_24.CreateReplicationJob`

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).

## Headers

- `X-Amz-Target` 'AWSServerMigrationService_V2016_10_24.CreateReplicationJob', required

## Request body

- CreateReplicationJobRequest
  - `serverId` string, required — The ID of the server.
  - `seedReplicationTime` string, date-time, 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` 'AWS' | 'BYOL' — 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 — <p>The ID of the KMS key for replication jobs that produce encrypted AMIs. This value can be any of the following:</p> <ul> <li> <p>KMS key ID</p> </li> <li> <p>KMS key alias</p> </li> <li> <p>ARN referring to the KMS key ID</p> </li> <li> <p>ARN referring to the KMS key alias</p> </li> </ul> <p> If encrypted is <i>true</i> but a KMS key ID is not specified, the customer's default KMS key for Amazon EBS is used. </p>

## Response `200`

Success

- CreateReplicationJobResponse
  - `replicationJobId` string — The unique identifier of the replication job.

## Other responses

- `480` — InvalidParameterException
- `481` — MissingRequiredParameterException
- `482` — UnauthorizedOperationException
- `483` — OperationNotPermittedException
- `484` — ServerCannotBeReplicatedException
- `485` — ReplicationJobAlreadyExistsException
- `486` — NoConnectorsAvailableException
- `487` — InternalError
- `488` — TemporarilyUnavailableException

---

[API](https://skmtc.net/aws/apis/sms.md) · [All operations](https://skmtc.net/aws/apis/sms/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/sms/versions/b93b64b4502e/schema)