Frågeerbjudanden

  • Artikel

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}

Se även