Copy a model to a region - Amazon Bedrock

Copy a model to a region

After you fulfill the prerequisites, you can copy a model. You can copy a model that you own into a different region, or a model that has been shared with you into a region so that you can use it. Select the tab corresponding to your method of choice and follow the steps.

Console

  1. Sign in to the AWS Management Console using an IAM role with Amazon Bedrock permissions, and open the Amazon Bedrock console at https://console.aws.amazon.com/bedrock/.

  2. From the left navigation pane, choose Custom models under Foundation models.

  3. Depending on your use case, do one of the following:

    • To copy a model that you own into a different region, select the button next to the model that you want to share in the Models section. Then, choose the three dots ( ) and select Copy.

    • To copy a model that was shared with you into a region, select the button next to the model that you want to share in the Models shared with you section. Then, choose Copy.

  4. In the Copy details section, do the following:

    1. In the Model name field, give the model copy a name.

    2. Select a region from the dropdown menu in the Destination region field.

    3. (Optional) To add tags, expand the Tags section. For more information, see Tag resources.

  5. In the Copy job name section, give the job a Name.

  6. (Optional) To encrypt the model copy, select an AWS KMS key that you have access to. For more information, see Permissions and key policies for custom and copied models.

  7. Choose Copy model.

  8. The model copy job appears in the Jobs tab. When the job is complete, the model's status becomes Complete and it appears in the Models section in the Models tab in the region that you copied the model to.

API

To copy a model to another region, send a CreateModelCopyJob request (see link for request and response formats and field details) with an Amazon Bedrock control plane endpoint in the region in which you want to use the model.

The following fields are required:

Field Brief description
sourceModelArn The Amazon Resource Name (ARN) of the model to copy.
targetModelName A name for the model copy.

The following fields are optional:

Field Use-case
clientToken To ensure the API request completes only once. For more information, see Ensuring idempotency.
modelKmsKeyId To provide a KMS key to encrypt the model copy. For more information, see Permissions and key policies for custom and copied models
targetModelTags To provide tags for the model copy. For more information, see Tag resources.

The response includes a jobArn field, which is the ARN of the model copy job.