:doc:`Snapshot <index>` / Action / describe_attribute

******************
describe_attribute
******************



.. py:method:: EC2.Snapshot.describe_attribute(**kwargs)

  

  Describes the specified attribute of the specified snapshot. You can specify only one attribute at a time.

   

  For more information about EBS snapshots, see `Amazon EBS snapshots <https://docs.aws.amazon.com/ebs/latest/userguide/ebs-snapshots.html>`__ in the *Amazon EBS User Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeSnapshotAttribute>`_  


  **Request Syntax**
  ::

    response = snapshot.describe_attribute(
        Attribute='productCodes'|'createVolumePermission',
        DryRun=True|False
    )
    
  :type Attribute: string
  :param Attribute: **[REQUIRED]** 

    The snapshot attribute you would like to view.

    

  
  :type DryRun: boolean
  :param DryRun: 

    Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is ``DryRunOperation``. Otherwise, it is ``UnauthorizedOperation``.

    

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

    
    ::

      {
          'ProductCodes': [
              {
                  'ProductCodeId': 'string',
                  'ProductCodeType': 'devpay'|'marketplace'
              },
          ],
          'SnapshotId': 'string',
          'CreateVolumePermissions': [
              {
                  'UserId': 'string',
                  'Group': 'all'
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **ProductCodes** *(list) --* 

        The product codes.

        
        

        - *(dict) --* 

          Describes a product code.

          
          

          - **ProductCodeId** *(string) --* 

            The product code.

            
          

          - **ProductCodeType** *(string) --* 

            The type of product code.

            
      
    
      

      - **SnapshotId** *(string) --* 

        The ID of the EBS snapshot.

        
      

      - **CreateVolumePermissions** *(list) --* 

        The users and groups that have the permissions for creating volumes from the snapshot.

        
        

        - *(dict) --* 

          Describes the user or group to be added or removed from the list of create volume permissions for a volume.

          
          

          - **UserId** *(string) --* 

            The ID of the Amazon Web Services account to be added or removed.

            
          

          - **Group** *(string) --* 

            The group to be added or removed. The possible value is ``all``.

            
      
    
  