Consultando ofertas
Você pode executar consultas em recursos de ofertas emitindo um POST no recurso de oferta, ou seja, o caminho do URI de ofertas. Esta seção mostrará um exemplo simples de recuperação das ofertas de uma coleção específica por seu auto-link.
Solicitação
| Método | URI da solicitação | Descrição |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/offers |
Observe que {databaseaccount} é o nome da conta do Azure Cosmos DB que você criou em sua assinatura. |
Cabeçalhos
Confira Cabeçalhos comuns de solicitação REST do Azure Cosmos DB para cabeçalhos usados por todas as solicitações do Cosmos DB.
| parâmetro | Obrigatório | Descrição |
|---|---|---|
| Content-Type | Obrigatório | Deve ser definido como application/query+json. |
| x-ms-documentdb-isquery | Obrigatório | Deve ser definido como True. |
Corpo
| Propriedade | Obrigatório | Descrição |
|---|---|---|
| consulta | Obrigatório | O valor dessa propriedade da instrução SQL a ser executada. |
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}
Resposta
Retorna uma matriz de recursos de objeto que correspondem à consulta.
Cabeçalhos
Consulte Cabeçalhos comuns de resposta REST do Azure Cosmos DB para obter cabeçalhos retornados por todas as respostas do Cosmos DB.
| parâmetro | Descrição |
|---|---|
| x-ms-item-count | É o número de itens retornados da consulta. |
Códigos de status
A tabela a seguir lista os códigos de status comuns retornados por esta operação. Para obter uma lista completa de códigos de status, consulte Códigos de status HTTP.
| Código de status HTTP | Descrição |
|---|---|
| 200 Ok | A operação foi bem-sucedida. |
| 400 Solicitação Inválida | O corpo JSON é inválido. |
| 401 Não Autorizado | O cabeçalho de Autorização ou x-ms-date não está definido. 401 também é retornado quando o cabeçalho de Autorização for definido como um token de autorização inválido. |
Corpo
| Propriedade | Descrição |
|---|---|
| _Livrar | É uma propriedade gerada pelo sistema. O valor _rid está vazio para essa operação. |
| _Contar | Essa propriedade mostra o número de ofertas retornadas como parte da operação. |
| Ofertas | É a matriz que contém as ofertas retornadas como parte da operação. Consulte Ofertas para localizar as propriedades do recurso de oferta. |
{"_rid":"","Offers":[],"_count":0}
Exemplo
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}