:doc:`Bedrock <../../bedrock>` / Client / create_model_copy_job

*********************
create_model_copy_job
*********************



.. py:method:: Bedrock.Client.create_model_copy_job(**kwargs)

  

  Copies a model to another region so that it can be used there. For more information, see `Copy models to be used in other regions <https://docs.aws.amazon.com/bedrock/latest/userguide/copy-model.html>`__ in the `Amazon Bedrock User Guide <https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html>`__.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/CreateModelCopyJob>`_  


  **Request Syntax**
  ::

    response = client.create_model_copy_job(
        sourceModelArn='string',
        targetModelName='string',
        modelKmsKeyId='string',
        targetModelTags=[
            {
                'key': 'string',
                'value': 'string'
            },
        ],
        clientRequestToken='string'
    )
    
  :type sourceModelArn: string
  :param sourceModelArn: **[REQUIRED]** 

    The Amazon Resource Name (ARN) of the model to be copied.

    

  
  :type targetModelName: string
  :param targetModelName: **[REQUIRED]** 

    A name for the copied model.

    

  
  :type modelKmsKeyId: string
  :param modelKmsKeyId: 

    The ARN of the KMS key that you use to encrypt the model copy.

    

  
  :type targetModelTags: list
  :param targetModelTags: 

    Tags to associate with the target model. For more information, see `Tag resources <https://docs.aws.amazon.com/bedrock/latest/userguide/tagging.html>`__ in the `Amazon Bedrock User Guide <https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html>`__.

    

  
    - *(dict) --* 

      Definition of the key/value pair for a tag.

      

    
      - **key** *(string) --* **[REQUIRED]** 

        Key for the tag.

        

      
      - **value** *(string) --* **[REQUIRED]** 

        Value for the tag.

        

      
    

  :type clientRequestToken: string
  :param clientRequestToken: 

    A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error. For more information, see `Ensuring idempotency <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html>`__.

    This field is autopopulated if not provided.

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'jobArn': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **jobArn** *(string) --* 

        The Amazon Resource Name (ARN) of the model copy job.

        
  
  **Exceptions**
  
  *   :py:class:`Bedrock.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`Bedrock.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`Bedrock.Client.exceptions.InternalServerException`

  
  *   :py:class:`Bedrock.Client.exceptions.TooManyTagsException`

  