Obtention d'une offre
Pour récupérer une ressource d’offre, effectuez une opération GET sur la ressource Offre .
Requête
| Méthode | URI de demande | Description |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/offers/{_rid-offer} |
Notez que {databaseaccount} est le nom du compte Azure Cosmos DB que vous avez créé sous votre abonnement. La valeur {_rid-offer} est l’ID de ressource généré par le système de l’offre. |
En-têtes
Consultez En-têtes de requête REST Azure Cosmos DB courants pour les en-têtes utilisés par toutes les requêtes Cosmos DB.
Lors de la construction de la signature hachée pour le jeton de clé master, le ResourceType doit être « offers ». ResourceLink ne doit être que le _rid de l’offre que vous souhaitez récupérer. La valeur doit être minuscule. Par exemple, lors de l’exécution d’un GET sur https://querydemo.documents.azure.com/offers/uT2L, le ResourceLink dans le jeton de clé master doit être « ut2l ».
Corps
Aucun.
response
Retourne la ressource d’offre demandée.
En-têtes
Consultez En-têtes de réponse REST Azure Cosmos DB courants pour les en-têtes retournés par toutes les réponses Cosmos DB.
Codes d’état
Le tableau suivant répertorie les codes d'état courants renvoyés par cette opération. Pour obtenir la liste complète des codes status, consultez Codes d’état HTTP.
| Code d'état HTTP | Description |
|---|---|
| 200 Ok | L'opération a réussi. |
| 404 Introuvable | L’offre n’est plus une ressource, c’est-à-dire que la ressource de collection parente a été supprimée. |
body
| Propriété | Description |
|---|---|
| offerVersion | Cette valeur peut être V1 pour les niveaux de débit prédéfinis et V2 pour les niveaux de débit définis par l’utilisateur. |
| offerType | Cette valeur indique le niveau de performances de la version de l’offre V1. Les valeurs autorisées pour l’offre V1 sont S1, S2 ou S3. Cette propriété est définie sur Non valide pour la version de l’offre V2. |
| content | Il contient des informations sur l’offre. Pour les offres V2, il contient le débit de la collection. |
| resource | Lors de la création d’une collection, cette propriété est définie sur l’auto-liaison de la collection, par exemple, dbs/pLJdAA==/colls/pLJdAOlEdgA=/. |
| offerResourceId | Lors de la création d’une collection, cette propriété est automatiquement associée à l’ID de ressource, c’est-à-dire _rid de la collection. Dans l’exemple ci-dessus, le _rid de la collection est pLJdAOlEdgA=. |
| id | Il s’agit d’une propriété générée par le système. L’ID de la ressource d’offre est généré automatiquement lors de sa création. Il a la même valeur que le _rid de l’offre. |
| _Débarrasser | Il s’agit d’une propriété générée par le système. L’ID de ressource (_rid) est un identificateur unique qui est également hiérarchique en fonction de la pile de ressources sur le modèle de ressource. Il est utilisé en interne pour le positionnement et la navigation dans l'offre. |
| _Ts | Il s’agit d’une propriété générée par le système. Elle spécifie l'horodateur de la dernière mise à jour de la ressource. La valeur est un horodateur. |
| _self | Il s’agit d’une propriété générée par le système. Il s'agit de l'URI adressable unique pour la ressource. |
| _Etag | Il s’agit d’une propriété générée par le système qui spécifie l’etag de ressources requis pour le contrôle d’accès concurrentiel optimiste. |
{
"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
}
Exemple
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
}
Notes
Pour en savoir plus sur le débit provisionné maximal et minimal qui peut être défini sur un conteneur ou une base de données, consultez l’article Provisionner le débit sur les conteneurs et les bases de données .
Exécutez GET sur la ressource de l’offre pour récupérer le débit minimal qui peut être défini pour un conteneur ou une base de données donné. L’en-tête x-ms-cosmos-min-throughput de réponse indique le débit minimal déterminé par le système.