

# Copy a customized or shared model to use in a Region
<a name="copy-model"></a>

By default, models are only available in the Region and account in which they were created. Amazon Bedrock provides you the ability to copy some types of models to other Regions. You can copy the following the types of models to other Regions:
+ [Custom models](custom-models.md)
+ [Shared models](share-model.md)

You can copy models to be used in supported Regions. If a model was shared with you from another account, you must first copy it to a Region to be able to use it. To learn about sharing models to and receiving models from other accounts, see [Share a model for another account to use](share-model.md).

**Topics**
+ [Supported Regions and models for model copy](copy-model-support.md)
+ [Fulfill prerequisites to copy models](copy-model-prereq.md)
+ [Copy a model to a Region](copy-model-copy.md)
+ [View information about model copy jobs](copy-model-job-view.md)

# Supported Regions and models for model copy
<a name="copy-model-support"></a>

The following list provides links to general information about Regional and model support in Amazon Bedrock:
+ For a list of Region codes and endpoints supported in Amazon Bedrock, see [Amazon Bedrock endpoints and quotas](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bedrock_region).
+ For a list of Amazon Bedrock model IDs to use when calling Amazon Bedrock API operations, see [Supported foundation models in Amazon Bedrock](models-supported.md).

The following table shows the models whose customized version you can copy and the Regions to which you can copy them:


| Provider | Model | Model ID | Single-region model support | 
| --- | --- | --- | --- | 
| Amazon | Nova Canvas | amazon.nova-canvas-v1:0 |  ap-northeast-2 eu-west-1 us-east-1  | 
| Amazon | Nova Lite | amazon.nova-lite-v1:0 |  ap-northeast-1 ap-northeast-2 ap-south-1 ap-southeast-1 ap-southeast-2 eu-central-1 eu-north-1 eu-south-1 eu-south-2 eu-west-1 eu-west-3 us-east-1 us-east-2 us-gov-west-1 us-west-2  | 
| Amazon | Nova Micro | amazon.nova-micro-v1:0 |  ap-northeast-1 ap-northeast-2 ap-south-1 ap-southeast-1 ap-southeast-2 eu-central-1 eu-north-1 eu-south-1 eu-south-2 eu-west-1 eu-west-3 us-east-1 us-east-2 us-gov-west-1 us-west-2  | 
| Amazon | Nova Pro | amazon.nova-pro-v1:0 |  ap-northeast-1 ap-northeast-2 ap-south-1 ap-southeast-1 ap-southeast-2 eu-central-1 eu-north-1 eu-south-1 eu-south-2 eu-west-1 eu-west-3 us-east-1 us-east-2 us-gov-west-1 us-west-2  | 
| Amazon | Titan Multimodal Embeddings G1 | amazon.titan-embed-image-v1 |  ap-south-1 ap-southeast-2 ca-central-1 eu-west-1 eu-west-2 eu-west-3 sa-east-1 us-east-1 us-west-2  | 
| Anthropic | Claude 3 Haiku | anthropic.claude-3-haiku-20240307-v1:0 |  ap-south-1 ap-southeast-2 eu-west-1 eu-west-2 us-east-1 us-west-2  | 
| Meta | Llama 3.1 405B Instruct | meta.llama3-1-405b-instruct-v1:0 |  us-east-1 us-east-2 us-west-2  | 
| Meta | Llama 3.1 70B Instruct | meta.llama3-1-70b-instruct-v1:0 |  us-east-1 us-east-2 us-west-2  | 
| Meta | Llama 3.1 8B Instruct | meta.llama3-1-8b-instruct-v1:0 |  us-east-1 us-east-2 us-west-2  | 
| Meta | Llama 3.2 11B Instruct | meta.llama3-2-11b-instruct-v1:0 |  us-east-1 us-east-2 us-west-2  | 
| Meta | Llama 3.2 1B Instruct | meta.llama3-2-1b-instruct-v1:0 |  eu-central-1 eu-west-1 eu-west-3 us-east-1 us-east-2 us-west-2  | 
| Meta | Llama 3.2 3B Instruct | meta.llama3-2-3b-instruct-v1:0 |  us-east-1 us-east-2 us-west-2  | 
| Meta | Llama 3.2 90B Instruct | meta.llama3-2-90b-instruct-v1:0 |  us-east-1 us-east-2 us-west-2  | 

# Fulfill prerequisites to copy models
<a name="copy-model-prereq"></a>

To allow a role to copy a model, you might have to set up permissions, depending on the role's permissions and the model's configuration. Review the permissions in the following list and the circumstances in which you must configure them:

1. If your role doesn't have the [AmazonBedrockFullAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonBedrockFullAccess) policy attached, attach the following identity-based policy to the role to allow the minimal permissions to copy models and to track copy jobs.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Sid": "CopyModels",
               "Effect": "Allow",
               "Action": [
                   "bedrock:CreateModelCopyJob",
                   "bedrock:GetModelCopyJob",
                   "bedrock:ListModelCopyJobs"
               ],
               "Resource": [
                   "arn:aws:bedrock:us-east-1::foundation-model/model-id"
               ],
               "Condition": {
                   "StringEquals": {
                       "aws:RequestedRegion": [
                           "us-east-1"
                       ]
                   }
               }
           }
       ]
   }
   ```

------

   Add ARNs of models to the `Resource` list. You can restrict the Regions that the model is copied to by adding Regions to the list in the [`aws:RequestedRegion` condition key.](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-requestedregion)

1. (Optional) If the model to be copied is encrypted with a KMS key, attach a [key policy to the KMS key that encrypted the model](encryption-custom-job.md#encryption-key-policy-decrypt) to allow a role to decrypt it. Specify the account that the model will be shared with in the `Principal` field.

1. (Optional) If you plan to encrypt the model copy with a KMS key, attach a [key policy to the KMS key that will be used to encrypt the model](encryption-custom-job.md#encryption-key-policy-encrypt) to allow a role to encrypt the model with the key. Specify the role in the `Principal` field.

# Copy a model to a Region
<a name="copy-model-copy"></a>

After you [fulfill the prerequisites](copy-model-prereq.md), 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. Choose the tab for your preferred method, and then follow the steps:

------
#### [ Console ]

1. Sign in to the AWS Management Console with an IAM identity that has permissions to use the Amazon Bedrock console. Then, open the Amazon Bedrock console at [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).

1. From the left navigation pane, choose **Custom models** under **Tune**.

1. 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 (![\[Vertical ellipsis icon representing a menu or more options.\]](http://docs.aws.amazon.com/bedrock/latest/userguide/images/icons/vertical-ellipsis.png)) 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**.

1. In the **Copy details** section, do the following:

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

   1. Select a Region from the dropdown menu in the **Destination Region** field.

   1. (Optional) To add tags, expand the **Tags** section. For more information, see [Tagging Amazon Bedrock resources](tagging.md).

1. In the **Copy job name** section, give the job a **Name**.

1. (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](encryption-custom-job.md#encryption-cm-statements).

1. Choose **Copy model**.

1. 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](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_CreateModelCopyJob.html) request with an [Amazon Bedrock control plane endpoint](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp) 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](https://docs.aws.amazon.com/ec2/latest/devguide/ec2-api-idempotency.html). | 
| modelKmsKeyId | To provide a KMS key to encrypt the model copy. For more information, see [Permissions and key policies for custom and copied models](encryption-custom-job.md#encryption-cm-statements) | 
| targetModelTags | To provide tags for the model copy. For more information, see [Tagging Amazon Bedrock resources](tagging.md). | 

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

------

# View information about model copy jobs
<a name="copy-model-job-view"></a>

To learn how to view information about model copy jobs that you've submitted, choose the tab for your preferred method, and then follow the steps:

------
#### [ Console ]

1. Sign in to the AWS Management Console with an IAM identity that has permissions to use the Amazon Bedrock console. Then, open the Amazon Bedrock console at [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).

1. From the left navigation pane, choose **Custom models** under **Tune**.

1. Select the **Jobs** tab.

1. If a model is still being copied, the **Status** is **Copying**. If it's finished and ready for use, the **Status** is **Completed**.

1. When the job is complete, the model appears in the **Models** section in the **Models** tab in the Region that you copied the model to.

------
#### [ API ]

To get information about a model copy job, send a [GetModelCopyJob](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GetModelCopyJob.html) request with an [Amazon Bedrock control plane endpoint](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp). Include the `jobArn` in the request.

To list the model copy jobs that you've submitted, send a [ListModelCopyJobs](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_ListModelCopyJobs.html) request with an [Amazon Bedrock control plane endpoint](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp). You can use the headers in the request to specify filters for which jobs to return.

The response returns a list, each of which contains information about a model copy job that you've submitted.

When the job is complete, you should be able to see the copied model by sending a [ListCustomModels](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_ListCustomModels.html) request with an [Amazon Bedrock control plane endpoint](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp), specifying the Region that you copied the model to.

------