:doc:`DataSync <../../datasync>` / Client / update_location_s3

******************
update_location_s3
******************



.. py:method:: DataSync.Client.update_location_s3(**kwargs)

  

  Modifies the following configuration parameters of the Amazon S3 transfer location that you're using with DataSync.

   

  .. warning::

     

    Before you begin, make sure that you read the following topics:

     

    
    * `Storage class considerations with Amazon S3 locations <https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes>`__
     
    * `Evaluating S3 request costs when using DataSync <https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests>`__
    

    

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationS3>`_  


  **Request Syntax**
  ::

    response = client.update_location_s3(
        LocationArn='string',
        Subdirectory='string',
        S3StorageClass='STANDARD'|'STANDARD_IA'|'ONEZONE_IA'|'INTELLIGENT_TIERING'|'GLACIER'|'DEEP_ARCHIVE'|'OUTPOSTS'|'GLACIER_INSTANT_RETRIEVAL',
        S3Config={
            'BucketAccessRoleArn': 'string'
        }
    )
    
  :type LocationArn: string
  :param LocationArn: **[REQUIRED]** 

    Specifies the Amazon Resource Name (ARN) of the Amazon S3 transfer location that you're updating.

    

  
  :type Subdirectory: string
  :param Subdirectory: 

    Specifies a prefix in the S3 bucket that DataSync reads from or writes to (depending on whether the bucket is a source or destination location).

     

    .. note::

      

      DataSync can't transfer objects with a prefix that begins with a slash ( ``/``) or includes ``//``, ``/./``, or ``/../`` patterns. For example:

       

      
      * ``/photos``
       
      * ``photos//2006/January``
       
      * ``photos/./2006/February``
       
      * ``photos/../2006/March``
      

      

    

  
  :type S3StorageClass: string
  :param S3StorageClass: 

    Specifies the storage class that you want your objects to use when Amazon S3 is a transfer destination.

     

    For buckets in Amazon Web Services Regions, the storage class defaults to ``STANDARD``. For buckets on Outposts, the storage class defaults to ``OUTPOSTS``.

     

    For more information, see `Storage class considerations with Amazon S3 transfers <https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes>`__.

    

  
  :type S3Config: dict
  :param S3Config: 

    Specifies the Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role that DataSync uses to access your S3 bucket.

     

    For more information, see `Providing DataSync access to S3 buckets <https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access>`__.

    

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

      Specifies the ARN of the IAM role that DataSync uses to access your S3 bucket.

      

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`DataSync.Client.exceptions.InvalidRequestException`

  
  *   :py:class:`DataSync.Client.exceptions.InternalException`

  