Obtener una oferta
Para recuperar un recurso de oferta, realice una operación GET en el recurso Oferta .
Solicitud
| Método | URI de solicitud | Descripción |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/offers/{_rid-offer} |
Tenga en cuenta que {databaseaccount} es el nombre de la cuenta de Azure Cosmos DB que creó en la suscripción. El valor {_rid-offer} es el identificador de recurso generado por el sistema de la oferta. |
encabezados
Consulte Encabezados de solicitud REST comunes de Azure Cosmos DB para ver los encabezados que usan todas las solicitudes de Cosmos DB.
Al construir la firma hash para el token de clave maestra, ResourceType debe ser "offers". ResourceLink debe ser solo el _rid de la oferta que desea recuperar. El valor debe estar en minúsculas. Por ejemplo, al realizar una operación GET en https://querydemo.documents.azure.com/offers/uT2L, resourceLink en el token de clave maestra debe ser "ut2l".
Cuerpo
Ninguno.
Response
Devuelve el recurso de oferta solicitado.
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. |
| 404 No encontrado | La oferta ya no es un recurso, es decir, se eliminó el recurso de colección principal. |
Body
| Propiedad | Descripción |
|---|---|
| offerVersion | Este valor puede ser V1 para los niveles de rendimiento predefinidos y V2 para los niveles de rendimiento definidos por el usuario. |
| offerType | Este valor indica el nivel de rendimiento de la versión de la oferta V1, los valores permitidos para la oferta V1 son S1, S2 o S3. Esta propiedad se establece en No válido para la versión de la oferta V2. |
| content | Contiene información sobre la oferta. En el caso de las ofertas V2, contiene el rendimiento de la colección. |
| resource | Al crear una nueva colección, esta propiedad se establece en el auto link de la colección, por ejemplo, dbs/pLJdAA==/colls/pLJdAOlEdgA=/. |
| offerResourceId | Durante la creación de una colección, esta propiedad se asocia automáticamente al identificador de recurso, es decir, _rid de la colección. En el ejemplo anterior, el _rid de la colección es pLJdAOlEdgA=. |
| id | Es una propiedad generada por el sistema. El identificador del recurso de oferta se genera automáticamente cuando se crea. Tiene el mismo valor que el _rid de la oferta. |
| _Librar | Es una propiedad generada por el sistema. El identificador de recurso (_rid) es un identificador único que también es jerárquico por la pila de recursos en el modelo de recursos. Se usa internamente para la colocación y desplazamiento de la oferta. |
| _Ts | Es una propiedad generada por el sistema. Especifica la última marca de tiempo actualizada del recurso. El valor es una marca de tiempo. |
| _propio | Es una propiedad generada por el sistema. Es el URI direccionable único para el recurso. |
| _Etag | Se trata de una propiedad generada por el sistema que especifica la etiqueta electrónica de recursos necesaria para el control de simultaneidad optimista. |
{
"offerVersion": "V2",
"offerType": "Invalid",
"content": {
"offerThroughput": 4000
},
"resource": "dbs/rgkVAA==/colls/rgkVAMHcJww=/",
"offerResourceId": "rgkVAMHcJww=",
"id": "uT2L",
"_rid": "uT2L",
"_self": "offers/uT2L/",
"_etag": "\"0000a600-0000-0000-0000-56fac0570000\"",
"_ts": 1459273815
}
Ejemplo
GET https://querydemo.documents.azure.com/offers/uT2L HTTP/1.1
x-ms-date: Tue, 29 Mar 2016 17:50:18 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3dA9Y9JAZylsBHG%2bM1Rdb3PpzO3Fw7kMJbRUJ8Llh2kpo%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/uT2L
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
etag: "0000a600-0000-0000-0000-56fac0570000"
x-ms-schemaversion: 1.1
x-ms-request-charge: 2
x-ms-serviceversion: version=1.6.52.5
x-ms-activity-id: bfa5991d-46f5-4c40-b3f0-957fccd8df9e
x-ms-session-token: M:8110
x-ms-gatewayversion: version=1.6.52.5
x-ms-cosmos-min-throughput: 400
Date: Tue, 29 Mar 2016 17:50:18 GMT
{
"offerVersion": "V2",
"offerType": "Invalid",
"content": {
"offerThroughput": 4000
},
"resource": "dbs/rgkVAA==/colls/rgkVAMHcJww=/",
"offerResourceId": "rgkVAMHcJww=",
"id": "uT2L",
"_rid": "uT2L",
"_self": "offers/uT2L/",
"_etag": "\"0000a600-0000-0000-0000-56fac0570000\"",
"_ts": 1459273815
}
Comentarios
Para más información sobre el rendimiento aprovisionado máximo y mínimo que se puede establecer en un contenedor o una base de datos, consulte el artículo Aprovisionamiento del rendimiento en contenedores y bases de datos .
Realice GET en el recurso de oferta para recuperar el rendimiento mínimo que se podría establecer para un contenedor determinado o una base de datos. El encabezado x-ms-cosmos-min-throughput de respuesta denota el rendimiento mínimo determinado por el sistema.