Wykonywanie zapytań dotyczących ofert
Zapytania dotyczące ofert można wykonywać, wystawiając wpis POST w zasobie ofert, tj. ścieżkę identyfikatora URI ofert. W tej sekcji przedstawiono prosty przykład pobierania ofert dla określonej kolekcji za pomocą linku samodzielnego.
Żądanie
| Metoda | Identyfikator URI żądania | Opis |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/offers |
Pamiętaj, że {databaseaccount} jest nazwą konta usługi Azure Cosmos DB utworzonego w ramach subskrypcji. |
Nagłówki
Zobacz Typowe nagłówki żądań REST usługi Azure Cosmos DB dla nagłówków , które są używane przez wszystkie żądania usługi Cosmos DB.
| Nagłówek | Wymagane | Opis |
|---|---|---|
| Typ zawartości | Wymagane | Musi być ustawiona wartość application/query+json. |
| x-ms-documentdb-isquery | Wymagane | Musi być ustawiona wartość True. |
Treść
| Właściwość | Wymagane | Opis |
|---|---|---|
| Kwerendy | Wymagane | Wartość tej właściwości, która ma zostać wykonana w instrukcji SQL. |
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}
Reakcja
Zwraca tablicę zasobów obiektów pasujących do zapytania.
Nagłówki
Zobacz Typowe nagłówki odpowiedzi REST usługi Azure Cosmos DB dla nagłówków zwracanych przez wszystkie odpowiedzi usługi Cosmos DB.
| Nagłówek | Opis |
|---|---|
| x-ms-item-count | Jest to liczba elementów zwróconych z zapytania. |
Kody stanu
W poniższej tabeli wymieniono typowe kody stanu zwracane przez tę operację. Aby uzyskać pełną listę kodów stanu, zobacz Kody stanu HTTP.
| Kod stanu HTTP | Opis |
|---|---|
| 200 OK | Operacja zakończyła się pomyślnie. |
| 400 Nieprawidłowe żądanie | Treść JSON jest nieprawidłowa. |
| 401 Brak autoryzacji | Nagłówek Authorization lub x-ms-date nie jest ustawiony. Błąd 401 jest również zwracany, gdy nagłówek autoryzacji jest ustawiony na nieprawidłowy token autoryzacji. |
Treść
| Właściwość | Opis |
|---|---|
| _Rid | Jest to właściwość wygenerowana przez system. Wartość _rid jest pusta dla tej operacji. |
| _Liczba | Ta właściwość pokazuje liczbę ofert zwróconych w ramach operacji. |
| Oferty | Jest to tablica zawierająca oferty zwrócone w ramach operacji. Zobacz Oferty , aby znaleźć właściwości zasobu oferty. |
{"_rid":"","Offers":[],"_count":0}
Przykład
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}