Ottenere un'offerta
Per recuperare una risorsa offerta, eseguire un GET nella risorsa Offerta .
Richiesta
| Metodo | URI richiesta | Descrizione |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/offers/{_rid-offer} |
Si noti che {databaseaccount} è il nome dell'account Azure Cosmos DB creato nella sottoscrizione. Il valore {_rid-offer} è l'ID risorsa generato dal sistema dell'offerta. |
Intestazioni
Vedere Intestazioni di richiesta REST di Azure Cosmos DB comuni per le intestazioni usate da tutte le richieste di Cosmos DB.
Quando si costruisce la firma hash per il token della chiave master, ResourceType deve essere "offerte".
ResourceLink deve essere solo il _rid dell'offerta da recuperare. Il valore deve essere minuscolo. Ad esempio, quando si esegue un get su https://querydemo.documents.azure.com/offers/uT2L, ResourceLink nel token della chiave master deve essere "ut2l".
Corpo
Nessuno.
Risposta
Restituisce la risorsa offerta richiesta.
Intestazioni
Vedere Intestazioni di risposta REST di Azure Cosmos DB comuni per le intestazioni restituite da tutte le risposte di Cosmos DB.
Codici di stato
La seguente tabella elenca i codici di stato comuni restituiti da questa operazione. Per un elenco completo dei codici di stato, vedere Codici di stato HTTP.
| Codice di stato HTTP | Descrizione |
|---|---|
| 200 Ok | L'operazione è stata completata. |
| 404 - Non trovato | L'offerta non è più una risorsa, ovvero la risorsa della raccolta padre è stata eliminata. |
Corpo
| Proprietà | Descrizione |
|---|---|
| offerVersion | Questo valore può essere V1 per i livelli di velocità effettiva predefiniti e V2 per i livelli di velocità effettiva definiti dall'utente. |
| offerType | Questo valore indica il livello di prestazioni per la versione dell'offerta V1, i valori consentiti per l'offerta V1 sono S1, S2 o S3. Questa proprietà è impostata su Invalid per la versione dell'offerta V2. |
| content | Contiene informazioni sull'offerta. Per le offerte V2, contiene la velocità effettiva della raccolta. |
| resource | Quando si crea una nuova raccolta, questa proprietà viene impostata sul collegamento automatico dell'insieme, ad esempio dbs/pLJdAA==/colls/pLJdAOlEdgA=/. |
| offerResourceId | Durante la creazione di una raccolta, questa proprietà viene associata automaticamente all'ID risorsa, ovvero _rid della raccolta. Nell'esempio precedente il _rid per la raccolta è pLJdAOlEdgA=. |
| id | È una proprietà generata dal sistema. L'ID per la risorsa offerta viene generato automaticamente quando viene creato. Ha lo stesso valore della _rid per l'offerta. |
| _rid | È una proprietà generata dal sistema. L'ID risorsa (_rid) è un identificatore univoco che è anche gerarchico per ogni stack di risorse nel modello di risorsa. Viene usato internamente per il posizionamento e l'esplorazione dell'offerta. |
| _Ts | È una proprietà generata dal sistema. Indica il timestamp dell'ultimo aggiornamento della risorsa. Il valore è un timestamp. |
| _stesso | È una proprietà generata dal sistema. URI indirizzabile univoco per la risorsa. |
| _Etag | Si tratta di una proprietà generata dal sistema che specifica l'etag della risorsa necessaria per il controllo di concorrenza ottimistica. |
{
"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
}
Esempio
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
}
Commenti
Per altre informazioni sulla velocità effettiva massima e minima di provisioning che può essere impostata su un contenitore o su un database, vedere l'articolo Effettuare il provisioning della velocità effettiva nei contenitori e nei database .
Eseguire GET nella risorsa offerta per recuperare la velocità effettiva minima che potrebbe essere impostata per un determinato contenitore o un database. L'intestazione x-ms-cosmos-min-throughput di risposta indica la velocità effettiva minima determinata dal sistema.