Ofertas de Consulta
Pode efetuar consultas em recursos de ofertas ao emitir um POST no recurso de ofertas, ou seja, o caminho do URI de ofertas. Esta secção mostrará um exemplo simples de obtenção das ofertas para uma coleção específica através da respetiva ligação automática.
Pedir
| Método | URI do pedido | Description |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/offers |
Tenha em atenção que {databaseaccount} é o nome da conta do Azure Cosmos DB que criou na sua subscrição. |
Cabeçalhos
Veja Common Azure Cosmos DB REST request headers for headers that are used by all Cosmos DB requests (Cabeçalhos de pedido REST do Azure Cosmos DB comuns para cabeçalhos que são utilizados por todos os pedidos do Cosmos DB).
| Cabeçalho | Necessário | Descrição |
|---|---|---|
| Tipo de Conteúdo | Necessário | Tem de ser definido como application/query+json. |
| x-ms-documentdb-isquery | Necessário | Tem de estar definido como Verdadeiro. |
Corpo
| Propriedade | Necessário | Descrição |
|---|---|---|
| consulta | Necessário | O valor desta propriedade a instrução SQL a ser executada. |
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}
Resposta
Devolve uma matriz de recursos de objeto que correspondem à consulta.
Cabeçalhos
Veja Common Azure Cosmos DB REST response headers for headers that are returned by all Cosmos DB responses (Cabeçalhos de resposta REST do Azure Cosmos DB comuns para cabeçalhos devolvidos por todas as respostas do Cosmos DB).
| Cabeçalho | Description |
|---|---|
| x-ms-item-count | É o número de itens devolvidos da consulta. |
Códigos de estado
A tabela seguinte lista os códigos de estado comuns devolvidos por esta operação. Para obter uma lista completa dos códigos de estado, veja Códigos de Estado HTTP.
| Código de estado de HTTP | Descrição |
|---|---|
| 200 Ok | A operação foi efetuada com êxito. |
| 400 Pedido Incorreto | O corpo JSON é inválido. |
| 401 Não Autorizado | O cabeçalho Autorização ou x-ms-date não está definido. O erro 401 também é devolvido quando o cabeçalho Autorização está definido como um token de autorização inválido. |
Corpo
| Propriedade | Descrição |
|---|---|
| _rid | É uma propriedade gerada pelo sistema. O valor _rid está vazio para esta operação. |
| _count | Esta propriedade mostra o número de ofertas devolvidas como parte da operação. |
| Ofertas | É a matriz que contém as ofertas devolvidas como parte da operação. Veja Ofertas para encontrar 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}