Frågeerbjudanden
Du kan köra frågor på erbjudanderesurser genom att utfärda ett POST på erbjudanderesursen, dvs. URI-sökvägen för erbjudanden. Det här avsnittet visar ett enkelt exempel på hur du hämtar erbjudanden för en viss samling via självlänken.
Förfrågan
| Metod | URI för förfrågan | Description |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/offers |
Observera att {databaseaccount} är namnet på det Azure Cosmos DB-konto som du skapade under din prenumeration. |
Sidhuvuden
Se Vanliga REST-begärandehuvuden för Azure Cosmos DB för rubriker som används av alla Cosmos DB-begäranden.
| Huvud | Krävs | Beskrivning |
|---|---|---|
| Innehållstyp | Obligatorisk | Måste anges till application/query+json. |
| x-ms-documentdb-isquery | Obligatorisk | Måste anges till Sant. |
Brödtext
| Egenskap | Krävs | Beskrivning |
|---|---|---|
| Fråga | Obligatorisk | Värdet för den här egenskapen den SQL-instruktion som ska köras. |
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}
Svarsåtgärder
Returnerar en matris med objektresurser som matchar frågan.
Sidhuvuden
Se Vanliga AZURE Cosmos DB REST-svarshuvuden för rubriker som returneras av alla Cosmos DB-svar.
| Huvud | Description |
|---|---|
| x-ms-item-count | Det är antalet objekt som returneras från frågan. |
Statuskoder
I följande tabell visas vanliga statuskoder som returneras av den här åtgärden. En fullständig lista över statuskoder finns i HTTP-statuskoder.
| HTTP-statuskod | Beskrivning |
|---|---|
| 200 Ok | Åtgärden lyckades. |
| 400 Felaktig begäran | JSON-brödtexten är ogiltig. |
| 401 – Ej behörig | Rubriken auktorisering eller x-ms-date har inte angetts. 401 returneras också när auktoriseringshuvudet är inställt på en ogiltig auktoriseringstoken. |
Brödtext
| Egenskap | Beskrivning |
|---|---|
| _Bli | Det är en systemgenererad egenskap. Värdet _rid är tomt för den här åtgärden. |
| _Räkna | Den här egenskapen visar antalet erbjudanden som returneras som en del av åtgärden. |
| Erbjudanden | Det är matrisen som innehåller de erbjudanden som returneras som en del av åtgärden. Se Erbjudanden för att hitta egenskaperna för erbjudanderesursen. |
{"_rid":"","Offers":[],"_count":0}
Exempel
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}