:doc:`SageMaker <../../sagemaker>` / Client / update_image_version

********************
update_image_version
********************



.. py:method:: SageMaker.Client.update_image_version(**kwargs)

  

  Updates the properties of a SageMaker AI image version.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/UpdateImageVersion>`_  


  **Request Syntax**
  ::

    response = client.update_image_version(
        ImageName='string',
        Alias='string',
        Version=123,
        AliasesToAdd=[
            'string',
        ],
        AliasesToDelete=[
            'string',
        ],
        VendorGuidance='NOT_PROVIDED'|'STABLE'|'TO_BE_ARCHIVED'|'ARCHIVED',
        JobType='TRAINING'|'INFERENCE'|'NOTEBOOK_KERNEL',
        MLFramework='string',
        ProgrammingLang='string',
        Processor='CPU'|'GPU',
        Horovod=True|False,
        ReleaseNotes='string'
    )
    
  :type ImageName: string
  :param ImageName: **[REQUIRED]** 

    The name of the image.

    

  
  :type Alias: string
  :param Alias: 

    The alias of the image version.

    

  
  :type Version: integer
  :param Version: 

    The version of the image.

    

  
  :type AliasesToAdd: list
  :param AliasesToAdd: 

    A list of aliases to add.

    

  
    - *(string) --* 

    

  :type AliasesToDelete: list
  :param AliasesToDelete: 

    A list of aliases to delete.

    

  
    - *(string) --* 

    

  :type VendorGuidance: string
  :param VendorGuidance: 

    The availability of the image version specified by the maintainer.

     

    
    * ``NOT_PROVIDED``: The maintainers did not provide a status for image version stability.
     
    * ``STABLE``: The image version is stable.
     
    * ``TO_BE_ARCHIVED``: The image version is set to be archived. Custom image versions that are set to be archived are automatically archived after three months.
     
    * ``ARCHIVED``: The image version is archived. Archived image versions are not searchable and are no longer actively supported.
    

    

  
  :type JobType: string
  :param JobType: 

    Indicates SageMaker AI job type compatibility.

     

    
    * ``TRAINING``: The image version is compatible with SageMaker AI training jobs.
     
    * ``INFERENCE``: The image version is compatible with SageMaker AI inference jobs.
     
    * ``NOTEBOOK_KERNEL``: The image version is compatible with SageMaker AI notebook kernels.
    

    

  
  :type MLFramework: string
  :param MLFramework: 

    The machine learning framework vended in the image version.

    

  
  :type ProgrammingLang: string
  :param ProgrammingLang: 

    The supported programming language and its version.

    

  
  :type Processor: string
  :param Processor: 

    Indicates CPU or GPU compatibility.

     

    
    * ``CPU``: The image version is compatible with CPU.
     
    * ``GPU``: The image version is compatible with GPU.
    

    

  
  :type Horovod: boolean
  :param Horovod: 

    Indicates Horovod compatibility.

    

  
  :type ReleaseNotes: string
  :param ReleaseNotes: 

    The maintainer description of the image version.

    

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

    
    ::

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

    

    - *(dict) --* 
      

      - **ImageVersionArn** *(string) --* 

        The ARN of the image version.

        
  
  **Exceptions**
  
  *   :py:class:`SageMaker.Client.exceptions.ResourceNotFound`

  
  *   :py:class:`SageMaker.Client.exceptions.ResourceInUse`

  