:doc:`KinesisVideo <../../kinesisvideo>` / Client / update_stream_storage_configuration

***********************************
update_stream_storage_configuration
***********************************



.. py:method:: KinesisVideo.Client.update_stream_storage_configuration(**kwargs)

  

  Updates the storage configuration for an existing Kinesis video stream.

   

  This operation allows you to modify the storage tier settings for a stream, enabling you to optimize storage costs and performance based on your access patterns.

   

  ``UpdateStreamStorageConfiguration`` is an asynchronous operation.

   

  You must have permissions for the ``KinesisVideo:UpdateStreamStorageConfiguration`` action.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/kinesisvideo-2017-09-30/UpdateStreamStorageConfiguration>`_  


  **Request Syntax**
  ::

    response = client.update_stream_storage_configuration(
        StreamName='string',
        StreamARN='string',
        CurrentVersion='string',
        StreamStorageConfiguration={
            'DefaultStorageTier': 'HOT'|'WARM'
        }
    )
    
  :type StreamName: string
  :param StreamName: 

    The name of the stream for which you want to update the storage configuration.

    

  
  :type StreamARN: string
  :param StreamARN: 

    The Amazon Resource Name (ARN) of the stream for which you want to update the storage configuration.

    

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

    The version of the stream whose storage configuration you want to change. To get the version, call either the ``DescribeStream`` or the ``ListStreams`` API.

    

  
  :type StreamStorageConfiguration: dict
  :param StreamStorageConfiguration: **[REQUIRED]** 

    The new storage configuration for the stream. This includes the default storage tier that determines how stream data is stored and accessed.

     

    Different storage tiers offer varying levels of performance and cost optimization to match your specific use case requirements.

    

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

      The default storage tier for the stream data. This setting determines the storage class used for stream data, affecting both performance characteristics and storage costs.

       

      Available storage tiers:

       

      
      * ``HOT`` - Optimized for frequent access with the lowest latency and highest performance. Ideal for real-time applications and frequently accessed data.
       
      * ``WARM`` - Balanced performance and cost for moderately accessed data. Suitable for data that is accessed regularly but not continuously.
      

      

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`KinesisVideo.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`KinesisVideo.Client.exceptions.ClientLimitExceededException`

  
  *   :py:class:`KinesisVideo.Client.exceptions.InvalidArgumentException`

  
  *   :py:class:`KinesisVideo.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`KinesisVideo.Client.exceptions.ResourceInUseException`

  
  *   :py:class:`KinesisVideo.Client.exceptions.VersionMismatchException`

  