Lista de ofertas
Para enumerar las ofertas en la cuenta de base de datos, realice una operación GET en el recurso de ofertas, es decir, la ruta de acceso del URI de ofertas.
Solicitud
Método | URI de solicitud | Descripción |
---|---|---|
GET | 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 los encabezados que usan todas las solicitudes de Cosmos DB.
Al construir la firma con hash para el token de clave maestra, ResourceType debe ser "ofertas". ResourceLink debe estar en blanco.
Cuerpo
Ninguno.
Response
encabezados
Consulte Encabezados de respuesta REST comunes de Azure Cosmos DB para ver los encabezados devueltos por todas las respuestas de Cosmos DB.
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. |
401 No autorizado | El encabezado Authorization o x-ms-date no está configurado. 401 también se devuelve cuando el encabezado Authorization está configurado como un token de autorización no válido. |
Body
Propiedad | Descripción |
---|---|
_Librar | Es una propiedad generada por el sistema. El valor de _rid está vacío para esta operación. |
_Contar | Esta propiedad muestra el número de ofertas que se devuelven como parte de la operación de lista. |
offers | Esta matriz contiene las ofertas devueltas como parte de la operación de lista. Consulte Ofertas para buscar las propiedades del recurso de oferta. |
{
"_rid": "",
"Offers": [
{
"offerVersion": "V2",
"offerType": "Invalid",
"content": {
"offerThroughput": 400
},
"resource": "dbs/PaYSAA==/colls/PaYSAPH7qAo=/",
"offerResourceId": "PaYSAPH7qAo=",
"id": "QH8O",
"_rid": "QH8O",
"_self": "offers/QH8O/",
"_etag": "\"00001400-0000-0000-0000-56f9897f0000\"",
"_ts": 1459194239
},
{
"offerType": "S3",
"resource": "dbs/hPJRAA==/colls/hPJRAJQcIQg=/",
"offerResourceId": "hPJRAJQcIQg=",
"id": "Z2sl",
"_rid": "Z2sl",
"_self": "offers/Z2sl/",
"_etag": "\"00000200-0000-0000-0000-56b281730000\"",
"_ts": 1454539123
}
],
"_count": 2
}
Ejemplo
GET https://querydemo.documents.azure.com/offers HTTP/1.1
x-ms-date: Tue, 29 Mar 2016 17:50:18 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3d13hxyOkKYq9ahWqSret83vS72Z0v3%2fo2HKodfDQQpoQ%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
Host: querydemo.documents.azure.com
HTTP/1.1 200 Ok
Cache-Control: no-store, no-cache
Pragma: no-cache
Transfer-Encoding: chunked
Content-Type: application/json
Content-Location: https://querydemo.documents.azure.com/offers
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: 2
x-ms-schemaversion: 1.1
x-ms-request-charge: 11.04
x-ms-serviceversion: version=1.6.52.5
x-ms-activity-id: ed5cb8aa-0324-4ad8-9bdb-da513c76d9eb
x-ms-session-token: M:8110
x-ms-gatewayversion: version=1.6.52.5
Date: Tue, 29 Mar 2016 17:50:18 GMT
{
"_rid": "",
"Offers": [
{
"offerVersion": "V2",
"offerType": "Invalid",
"content": {
"offerThroughput": 400
},
"resource": "dbs/PaYSAA==/colls/PaYSAPH7qAo=/",
"offerResourceId": "PaYSAPH7qAo=",
"id": "QH8O",
"_rid": "QH8O",
"_self": "offers/QH8O/",
"_etag": "\"00001400-0000-0000-0000-56f9897f0000\"",
"_ts": 1459194239
},
{
"offerType": "S3",
"resource": "dbs/hPJRAA==/colls/hPJRAJQcIQg=/",
"offerResourceId": "hPJRAJQcIQg=",
"id": "Z2sl",
"_rid": "Z2sl",
"_self": "offers/Z2sl/",
"_etag": "\"00000200-0000-0000-0000-56b281730000\"",
"_ts": 1454539123
}
],
"_count": 2
}