SimpleDB / Client / get_attributes

get_attributes#

SimpleDB.Client.get_attributes(**kwargs)#

Returns all of the attributes associated with the specified item. Optionally, the attributes returned can be limited to one or more attributes by specifying an attribute name parameter.

If the item does not exist on the replica that was accessed for this operation, an empty set is returned. The system does not return an error as it cannot guarantee the item does not exist on other replicas.

See also: AWS API Documentation

Request Syntax

response = client.get_attributes(
    DomainName='string',
    ItemName='string',
    AttributeNames=[
        'string',
    ],
    ConsistentRead=True|False
)
Parameters:

  • DomainName (string) – [REQUIRED] The name of the domain in which to perform the operation.

  • ItemName (string) – [REQUIRED] The name of the item.

  • AttributeNames (list) –

    The names of the attributes.

    • (string) –

  • ConsistentRead (boolean) – Determines whether or not strong consistency should be enforced when data is read from SimpleDB. If true, any data previously written to SimpleDB will be returned. Otherwise, results will be consistent eventually, and the client may not see data that was written immediately before your read.

Return type:

dict

Returns:

Response Syntax

{
    'Attributes': [
        {
            'Name': 'string',
            'AlternateNameEncoding': 'string',
            'Value': 'string',
            'AlternateValueEncoding': 'string'
        },
    ]
}

Response Structure

  • (dict) –

    • Attributes (list) – The list of attributes returned by the operation.

      • (dict) –

        • Name (string) – The name of the attribute.

        • AlternateNameEncoding (string) –

        • Value (string) – The value of the attribute.

        • AlternateValueEncoding (string) –

Exceptions

  • SimpleDB.Client.exceptions.InvalidParameterValue

  • SimpleDB.Client.exceptions.MissingParameter

  • SimpleDB.Client.exceptions.NoSuchDomain