Abfragen von Angeboten

  • Artikel

Sie können Abfragen für Angebotsressourcen durchführen, indem Sie eine POST-Anforderung an die Angebotsressource senden, d. h. an den URI-Pfad des Angebots. In diesem Abschnitt wird ein einfaches Beispiel für das Abrufen der Angebote für eine bestimmte Sammlung durch die Selbstverknüpfung gezeigt.

Anforderung

Methode Anforderungs-URI BESCHREIBUNG
POST https://{databaseaccount}.documents.azure.com/offers Beachten Sie, dass {databaseaccount} der Name des Azure Cosmos DB-Kontos ist, das Sie unter Ihrem Abonnement erstellt haben.

Header

Informationen zu Headern, die von allen Cosmos DB-Anforderungen verwendet werden, finden Sie unter Allgemeine Azure Cosmos DB-REST-Anforderungsheader .

Header Erforderlich BESCHREIBUNG
Content-Type Erforderlich Muss auf application/query+json festgelegt werden.
x-ms-documentdb-isquery Erforderlich Muss auf True festgelegt werden.

Body

Eigenschaft Erforderlich BESCHREIBUNG
Frage Erforderlich Der Wert dieser Eigenschaft ist die auszuführende SQL-Anweisung. 
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}

Antwort

Gibt ein Array von Objektressourcen zurück, die der Abfrage entsprechen.

Header

Informationen zu Headern, die von allen Cosmos DB-Antworten zurückgegeben werden, finden Sie unter Allgemeine Azure Cosmos DB-REST-Antwortheader .

Header BESCHREIBUNG
x-ms-item-count Dies ist die Anzahl der elemente, die von der Abfrage zurückgegeben werden.

Statuscodes

In der folgenden Tabelle sind die allgemeinen Statuscodes aufgeführt, die von diesem Vorgang zurückgegeben werden. Eine vollständige Liste der status Codes finden Sie unter HTTP-Statuscodes.

HTTP-Statuscode BESCHREIBUNG
200 Ok Der Vorgang wurde durchgeführt.
400 – Ungültige Anforderung Der JSON-Text ist ungültig.
401 – Nicht autorisiert Der Authorization- oder x-ms-date-Header ist nicht festgelegt. "401 Unauthorized" wird auch zurückgegeben, wenn der Authorization-Header auf ein ungültiges Autorisierungstoken festgelegt ist.

Body

Eigenschaft BESCHREIBUNG
_los Es handelt sich um eine vom System generierte Eigenschaft. Der _rid Wert ist für diesen Vorgang leer.
_Count Diese Eigenschaft zeigt die Anzahl der Angebote an, die im Rahmen des Vorgangs zurückgegeben werden.
Angebote Dies ist das Array mit den Angeboten, die im Rahmen des Vorgangs zurückgegeben werden.
Unter Angebote finden Sie die Eigenschaften der Angebotsressource.		 
{"_rid":"","Offers":[],"_count":0}

Beispiel

POST https://querydemo.documents.azure.com/offers HTTP/1.1  
x-ms-continuation:   
x-ms-documentdb-isquery: True  
x-ms-documentdb-query-enablecrosspartition: False  
x-ms-date: Tue, 29 Mar 2016 18:07:41 GMT  
authorization: type%3dmaster%26ver%3d1.0%26sig%3d0si%2fhno2pKTQhgvdkojNqlQlYdoguwQEBt79XvpobMc%3d  
Cache-Control: no-cache  
User-Agent: Microsoft.Azure.Documents.Client/1.6.0.0 samples-net/3  
x-ms-version: 2015-12-16  
Accept: application/json  
Content-Type: application/query+json  
Host: querydemo.documents.azure.com  
Content-Length: 94  
Expect: 100-continue  
  
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}
  

HTTP/1.1 200 Ok  
Cache-Control: no-store, no-cache  
Pragma: no-cache  
Transfer-Encoding: chunked  
Content-Type: application/json  
Server: Microsoft-HTTPAPI/2.0  
Strict-Transport-Security: max-age=31536000  
x-ms-last-state-change-utc: Fri, 25 Mar 2016 21:27:20.035 GMT  
x-ms-item-count: 0  
x-ms-schemaversion: 1.1  
x-ms-request-charge: 3.94  
x-ms-serviceversion: version=1.6.52.5  
x-ms-activity-id: b151cbe4-aae0-4949-959f-189b9884478d  
x-ms-session-token: M:8166  
x-ms-gatewayversion: version=1.6.52.5  
Date: Tue, 29 Mar 2016 18:07:41 GMT  
  
{"_rid":"","Offers":[],"_count":0}

Weitere Informationen