Query's uitvoeren op aanbiedingen
U kunt query's uitvoeren op aanbiedingenresources door een POST uit te geven op de aanbiedingsresource, d.w.w.v. het URI-pad voor aanbiedingen. In deze sectie ziet u een eenvoudig voorbeeld van het ophalen van de aanbiedingen voor een bepaalde verzameling via de zelfkoppeling.
Aanvraag
| Methode | Aanvraag-URI | Beschrijving |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/offers |
Houd er rekening mee dat {databaseaccount} de naam is van het Azure Cosmos DB-account dat u hebt gemaakt onder uw abonnement. |
Kopteksten
Zie Algemene Azure Cosmos DB REST-aanvraagheaders voor headers die worden gebruikt door alle Cosmos DB-aanvragen.
| Header | Vereist | Beschrijving |
|---|---|---|
| Content-Type | Vereist | Moet worden ingesteld op application/query+json. |
| x-ms-documentdb-isquery | Vereist | Moet worden ingesteld op Waar. |
Hoofdtekst
| Eigenschap | Vereist | Beschrijving |
|---|---|---|
| Query | Vereist | De waarde van deze eigenschap van de SQL-instructie die moet worden uitgevoerd. |
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}
Antwoord
Retourneert een matrix met objectresources die overeenkomen met de query.
Kopteksten
Zie Algemene Azure Cosmos DB REST-antwoordheaders voor headers die worden geretourneerd door alle Cosmos DB-antwoorden.
| Header | Beschrijving |
|---|---|
| x-ms-item-count | Het is het aantal items dat door de query wordt geretourneerd. |
Statuscodes
De volgende tabel bevat algemene statuscodes die door deze bewerking worden geretourneerd. Zie HTTP-statuscodes voor een volledige lijst met statuscodes.
| HTTP-statuscode | Beschrijving |
|---|---|
| 200 Ok | De bewerking is geslaagd. |
| 400 Ongeldige aanvraag | De JSON-hoofdtekst is ongeldig. |
| 401 Onbevoegd | De header Autorisatie of x-ms-date is niet ingesteld. 401 wordt ook geretourneerd wanneer de autorisatieheader is ingesteld op een ongeldig autorisatietoken. |
Hoofdtekst
| Eigenschap | Beschrijving |
|---|---|
| _Ontdoen | Het is een door het systeem gegenereerde eigenschap. De waarde _rid is leeg voor deze bewerking. |
| _Tellen | Deze eigenschap geeft het aantal aanbiedingen weer dat wordt geretourneerd als onderdeel van de bewerking. |
| Aanbiedingen | Het is de matrix die de aanbiedingen bevat die als onderdeel van de bewerking worden geretourneerd. Zie Aanbiedingen om de eigenschappen van de aanbiedingsresource te vinden. |
{"_rid":"","Offers":[],"_count":0}
Voorbeeld
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}