4.2.2 Retrieve a Single Entity by Using the AtomPub Format

  • Article

The following example illustrates the exchange of messages that is required for a client to retrieve a Customer entity with an EntityKey value equal to "ALFKI" by using the AtomPub format.

Request:

 GET /service.svc/Customers('ALFKI') HTTP/1.1
 Host: host
 Accept: application/atom+xml
 DataServiceVersion: 1.0
 MaxDataServiceVersion: 3.0

Response:

 HTTP/1.1 200 OK
 Date: Fri, 12 Dec 2008 17:17:11 GMT
 Content-Type: application/atom+xml;type=entry
 Content-Length: nnn
 ETag: W/"X'000000000000FA01'"
 DataServiceVersion: 3.0
  
 <?xml version="1.0" encoding="utf-8"?>
 <entry xml:base="http://host/service.svc/"
        xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices"
        xmlns:gml=http://schemas.opengis.net/gml/3.1.1/profiles/gmlsfProfile/1.0.0/gmlsf.xsd
        xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata"
        xmlns="http://www.w3.org/2005/Atom" m:etag="W/"X'000000000000FA01'"">
   <category term="SampleModel.Customer"
             scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme"/>
   <id>http://host/service.svc/Customers('ALFKI')</id>
   <title type="text" />
   <updated>2008-03-30T21:32:23Z</updated>
   <author>
     <name />
   </author>
   <link rel="edit" title="Customer" href="Customers('ALFKI')/SampleModel.Customer " />
   <link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Orders"
         type="application/atom+xml;type=feed"
         title="Orders"
         href="Customers('ALFKI')/SampleModel.Customer/Orders" />
   <link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/relatedlinks/Orders"
         type="application/ xml "
         title="Orders"
         href="Customers('ALFKI')/SampleModel.Customer/$links/Orders" />
   <content type="application/xml">
    <m:properties>
     <d:CustomerID>ALFKI</d:CustomerID>
     <d:CompanyName>Alfreds Futterkiste</d:CompanyName>
     <d:Address>
       <d:Street>57 Contoso St</d:Street>
       <d:City>Seattle</d:City>
       <d:Location m:type="Edm.GeographyPoint"><gml:Point srsName="4326">-127.345345 48.23423</gml:Point></d:Location>
     </d:Address>
     <d:Version>AAAAAAAA+gE=</d:Version>
    </m:properties>
   </content>
 </entry>