Dotazování nabídek
Dotazy na prostředky nabídek můžete provádět tak, že u prostředku nabídek vydáte POST, tj. cestu k identifikátoru URI nabídek. Tato část ukazuje jednoduchý příklad načtení nabídek pro konkrétní kolekci pomocí jejího vlastního odkazu.
Žádost
| Metoda | Identifikátor URI žádosti | Description |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/offers |
Všimněte si, že {databaseaccount} je název účtu služby Azure Cosmos DB, který jste vytvořili v rámci předplatného. |
Hlavičky
Viz Běžné hlavičky požadavků REST služby Azure Cosmos DB pro hlavičky, které používají všechny požadavky služby Cosmos DB.
| Hlavička | Povinné | Popis |
|---|---|---|
| Typ obsahu | Vyžadováno | Musí být nastavená na application/query+json. |
| x-ms-documentdb-isquery | Vyžadováno | Musí být nastavena na Hodnotu True. |
Text
| Vlastnost | Povinné | Popis |
|---|---|---|
| Dotazu | Vyžadováno | Hodnota této vlastnosti příkaz SQL, který se má spustit. |
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}
Odpověď
Vrátí pole prostředků objektu, které odpovídají dotazu.
Hlavičky
Viz Běžné hlavičky odpovědi REST služby Azure Cosmos DB pro hlavičky, které jsou vráceny všemi odpověďmi služby Cosmos DB.
| Hlavička | Description |
|---|---|
| x-ms-item-count | Jedná se o počet položek vrácených dotazem. |
Stavové kódy
Následující tabulka uvádí běžné stavové kódy vrácené touto operací. Úplný seznam stavových kódů najdete v tématu Stavové kódy HTTP.
| Stavový kód HTTP | Popis |
|---|---|
| 200 Ok | Operace byla úspěšná. |
| 400 – Chybný požadavek | Text JSON je neplatný. |
| 401 – Neautorizováno | Hlavička Authorization nebo x-ms-date není nastavená. 401 se také vrátí, pokud je hlavička Autorizace nastavena na neplatný autorizační token. |
Text
| Vlastnost | Popis |
|---|---|
| _Zbavit | Jedná se o systém vygenerovanou vlastnost. Hodnota _rid je pro tuto operaci prázdná. |
| _Počet | Tato vlastnost zobrazuje počet nabídek vrácených v rámci operace. |
| Nabídky | Jedná se o pole obsahující nabídky vrácené v rámci operace. Vlastnosti prostředku nabídky najdete v tématu Nabídky . |
{"_rid":"","Offers":[],"_count":0}
Příklad
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}