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.

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.

	Note
	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.X The name of the attribute. No

Name	Description	Required?
`ItemName`	The name of the item.	Yes
`AttributeName.X`	The name of the attribute.	No
`DomainName`	The name of the domain in which to perform the operation. Type: String	Yes

DomainName

The name of the domain in which to perform the operation.

Type: String

Yes

Response Elements

Name	Description
`Attribute.X.Name`	The name of the attribute.
`Attribute.X.Value`	The value of the attribute.

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.
`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
&SignatureVersion=1
&Timestamp=2007-06-25T15%3A03%3A07-07%3A00
&Version=2007-11-07
&Signature=IJQwarD3Zt0fCj8WLaNmgTU7jGw%3D

Sample Response

<GetAttributesResponse xmlns="http://sdb.amazonaws.com/doc/2007-11-07">
  <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=1
&Timestamp=2007-06-25T15%3A03%3A07-07%3A00
&Version=2007-11-07
&Signature=IJQwarD3Zt0fCj8WLaNmgTU7jGw%3D

Sample Response

<GetAttributesResponse xmlns="http://sdb.amazonaws.com/doc/2007-11-07">
  <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>