Abfragen von Angeboten
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}