:doc:`ivsrealtime <../../ivs-realtime>` / Client / create_storage_configuration

****************************
create_storage_configuration
****************************



.. py:method:: ivsrealtime.Client.create_storage_configuration(**kwargs)

  

  Creates a new storage configuration, used to enable recording to Amazon S3. When a StorageConfiguration is created, IVS will modify the S3 bucketPolicy of the provided bucket. This will ensure that IVS has sufficient permissions to write content to the provided bucket.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/CreateStorageConfiguration>`_  


  **Request Syntax**
  ::

    response = client.create_storage_configuration(
        name='string',
        s3={
            'bucketName': 'string'
        },
        tags={
            'string': 'string'
        }
    )
    
  :type name: string
  :param name: 

    Storage configuration name. The value does not need to be unique.

    

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

    A complex type that contains a storage configuration for where recorded video will be stored.

    

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

      Location (S3 bucket name) where recorded videos will be stored. Note that the StorageConfiguration and S3 bucket must be in the same region as the Composition.

      

    
  
  :type tags: dict
  :param tags: 

    Tags attached to the resource. Array of maps, each of the form ``string:string (key:value)``. See `Best practices and strategies <https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html>`__ in *Tagging AWS Resources and Tag Editor* for details, including restrictions that apply to tags and "Tag naming limits and requirements"; Amazon IVS has no constraints on tags beyond what is documented there.

    

  
    - *(string) --* 

    
      - *(string) --* 

      


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

    
    ::

      {
          'storageConfiguration': {
              'arn': 'string',
              'name': 'string',
              's3': {
                  'bucketName': 'string'
              },
              'tags': {
                  'string': 'string'
              }
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **storageConfiguration** *(dict) --* 

        The StorageConfiguration that was created.

        
        

        - **arn** *(string) --* 

          ARN of the storage configuration.

          
        

        - **name** *(string) --* 

          Name of the storage configuration.

          
        

        - **s3** *(dict) --* 

          An S3 destination configuration where recorded videos will be stored.

          
          

          - **bucketName** *(string) --* 

            Location (S3 bucket name) where recorded videos will be stored. Note that the StorageConfiguration and S3 bucket must be in the same region as the Composition.

            
      
        

        - **tags** *(dict) --* 

          Tags attached to the resource. Array of maps, each of the form ``string:string (key:value)``. See `Best practices and strategies <https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html>`__ in *Tagging AWS Resources and Tag Editor* for details, including restrictions that apply to tags and "Tag naming limits and requirements"; Amazon IVS has no constraints on tags beyond what is documented there.

          
          

          - *(string) --* 
            

            - *(string) --* 
      
    
    
  
  **Exceptions**
  
  *   :py:class:`ivsrealtime.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`ivsrealtime.Client.exceptions.ValidationException`

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

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

  
  *   :py:class:`ivsrealtime.Client.exceptions.ServiceQuotaExceededException`

  
  *   :py:class:`ivsrealtime.Client.exceptions.ConflictException`

  
  *   :py:class:`ivsrealtime.Client.exceptions.PendingVerification`

  