Consulta de ofertas
Puede realizar consultas sobre recursos de ofertas si emite una operación POST en el recurso de ofertas, es decir, la ruta de acceso de URI de las ofertas. En esta sección se mostrará un ejemplo sencillo de recuperación de las ofertas de una colección determinada por su auto-vínculo.
Solicitud
| Método | URI de solicitud | Descripción |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/offers |
Tenga en cuenta que {databaseaccount} es el nombre de la cuenta de Azure Cosmos DB que creó en la suscripción. |
encabezados
Consulte Encabezados de solicitud REST comunes de Azure Cosmos DB para ver los encabezados que usan todas las solicitudes de Cosmos DB.
| Encabezado | Obligatorio | Descripción |
|---|---|---|
| Content-Type | Obligatorio | Debe establecerse en application/query+json. |
| x-ms-documentdb-isquery | Obligatorio | Debe establecerse en True. |
Body
| Propiedad | Obligatorio | Descripción |
|---|---|---|
| consulta | Obligatorio | El valor de esta propiedad para que se ejecute la instrucción SQL. |
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}
Response
Devuelve una matriz de recursos de objeto que coinciden con la consulta.
encabezados
Consulte Encabezados de respuesta REST comunes de Azure Cosmos DB para ver los encabezados devueltos por todas las respuestas de Cosmos DB.
| Encabezado | Descripción |
|---|---|
| x-ms-item-count | Es el número de elementos devueltos por la consulta. |
Códigos de estado
La tabla siguiente muestra los códigos de estado comunes que devuelve esta operación. Para obtener una lista completa de los códigos de estado, consulte Códigos de estado HTTP.
| Código de estado HTTP | Descripción |
|---|---|
| 200 Ok | La operación se realizó correctamente. |
| 400 - Solicitud incorrecta | El cuerpo JSON no es válido. |
| 401 No autorizado | El encabezado Authorization o x-ms-date no está configurado. También se devuelve 401 cuando el encabezado Authorization está definido en un token de autorización no válido. |
Body
| Propiedad | Descripción |
|---|---|
| _Librar | Es una propiedad generada por el sistema. El valor _rid está vacío para esta operación. |
| _Contar | Esta propiedad muestra el número de ofertas devueltas como parte de la operación. |
| Ofertas | Es la matriz que contiene las ofertas devueltas como parte de la operación. Consulte Ofertas para buscar las propiedades del recurso de oferta. |
{"_rid":"","Offers":[],"_count":0}
Ejemplo
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}