GetAttributes
Description
Returns all of the attributes associated with the item. Optionally, the attributes returned can be limited to one or more specified attribute name parameters.
Amazon SimpleDB keeps multiple copies of each domain. When data is written or updated, all copies of the data
are updated. However, it takes time for the update to propagate to all storage locations. The data will
eventually be consistent, but an immediate read might not show the change. If eventually consistent reads are not
acceptable for your application, use ConsistentRead
. Although this operation might take
longer than a standard read, it always returns the last updated value.
Note
If the item does not exist on the replica that was accessed for this operation, an empty set is returned.
If you specify GetAttributes
without any attribute names, all the
attributes for the item are returned.
Request Parameters
Name | Description | Required |
---|---|---|
ItemName
|
The name of the item. | Yes |
AttributeName
|
The name of the attribute. | No |
DomainName
|
The name of the domain in which to perform the operation. Type: String |
Yes |
ConsistentRead
|
When set to Type: Boolean Default: |
No |
Response Elements
Name | Description |
---|---|
<Attribute><Name>...
</Name><Value>...
</Value></Attribute>
|
The name of the attribute and value. |
Special Errors
Error | Description |
---|---|
InvalidParameterValue
|
Value (" + value + ") for parameter Name is invalid. Value exceeds maximum length of 1024. |
InvalidParameterValue
|
Value (" + value + ") for parameter Item is invalid. Value exceeds max length of 1024. |
InvalidParameterValue
|
Value (" + value + ") for parameter ConsistentRead is invalid. The ConsistentRead
flag should be either true or false . |
MissingParameter
|
The request must contain the parameter
DomainName . |
MissingParameter
|
The request must contain the parameter
ItemName . |
NoSuchDomain
|
The specified domain does not exist. |
Examples
Sample Request
https://sdb.amazonaws.com/ ?Action=GetAttributes &AWSAccessKeyId=[valid access key id] &DomainName=MyDomain &ItemName=Item123 &ConsistentRead=true &SignatureVersion=2 &SignatureMethod=HmacSHA256 &Timestamp=2010-01-25T15%3A03%3A07-07%3A00 &Version=2009-04-15 &Signature=[valid signature]
Sample Response
<GetAttributesResponse> <GetAttributesResult> <Attribute><Name>Color</Name><Value>Blue</Value></Attribute> <Attribute><Name>Size</Name><Value>Med</Value></Attribute> <Attribute><Name>Price</Name><Value>14</Value></Attribute> </GetAttributesResult> <ResponseMetadata> <RequestId>b1e8f1f7-42e9-494c-ad09-2674e557526d</RequestId> <BoxUsage>0.0000219907</BoxUsage> </ResponseMetadata> </GetAttributesResponse>
Sample Request
https://sdb.amazonaws.com/ ?Action=GetAttributes &AWSAccessKeyId=[valid access key id] &DomainName=MyDomain &ItemName=Item123 &AttributeName.0=Color &AttributeName.1=Size &SignatureVersion=2 &SignatureMethod=HmacSHA256 &Timestamp=2010-01-25T15%3A03%3A07-07%3A00 &Version=2009-04-15 &Signature=[valid signature]
Sample Response
<GetAttributesResponse> <GetAttributesResult> <Attribute><Name>Color</Name><Value>Blue</Value></Attribute> <Attribute><Name>Size</Name><Value>Med</Value></Attribute> </GetAttributesResult> <ResponseMetadata> <RequestId>b1e8f1f7-42e9-494c-ad09-2674e557526d</RequestId> <BoxUsage>0.0000219907</BoxUsage> </ResponseMetadata> </GetAttributesResponse>