Získání nabídky
Pokud chcete načíst prostředek nabídky, proveďte u prostředku Nabídky operaci GET.
Žádost
| Metoda | Identifikátor URI žádosti | Popis |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/offers/{_rid-offer} |
Všimněte si, že {databaseaccount} je název účtu služby Azure Cosmos DB, který jste vytvořili v rámci předplatného. Hodnota {_rid-offer} je ID prostředku generovaného systémem nabídky. |
Hlavičky
Viz Běžné hlavičky požadavků REST služby Azure Cosmos DB pro hlavičky, které používají všechny požadavky služby Cosmos DB.
Při vytváření podpisu s hodnotou hash pro token hlavního klíče by typ ResourceType měl být "offers".
Odkaz na prostředek by měl být pouze _rid nabídky, kterou chcete načíst. Hodnota musí být malá písmena. Například při provádění příkazu GET na https://querydemo.documents.azure.com/offers/uT2Lby měl být odkaz na prostředek v tokenu hlavního klíče "ut2l".
Text
Žádné
Odpověď
Vrátí požadovaný prostředek nabídky.
Hlavičky
Viz Běžné hlavičky odpovědi REST služby Azure Cosmos DB pro hlavičky, které jsou vráceny všemi odpověďmi služby Cosmos DB.
Stavové kódy
Následující tabulka uvádí běžné stavové kódy vrácené touto operací. Úplný seznam stavových kódů najdete v tématu Stavové kódy HTTP.
| Stavový kód HTTP | Popis |
|---|---|
| 200 Ok | Operace byla úspěšná. |
| 404 Nenalezeno | Nabídka už není prostředkem, to znamená, že nadřazený prostředek kolekce byl odstraněn. |
Text
| Vlastnost | Popis |
|---|---|
| nabídkaVersion | Tato hodnota může být V1 pro předdefinované úrovně propustnosti a V2 pro úrovně propustnosti definované uživatelem. |
| offerType | Tato hodnota označuje úroveň výkonu pro verzi nabídky V1, povolené hodnoty pro nabídku V1 jsou S1, S2 nebo S3. Tato vlastnost je pro verzi nabídky V2 nastavená na Hodnotu Neplatná. |
| Obsah | Obsahuje informace o nabídce. U nabídek V2 obsahuje propustnost kolekce. |
| Zdrojů | Při vytváření nové kolekce se tato vlastnost nastaví na vlastní propojení kolekce, například dbs/pLJdAA==/colls/pLJdAOlEdgA=/. |
| offerResourceId | Během vytváření kolekce se tato vlastnost automaticky přidružuje k ID prostředku, tj. _rid kolekce. Ve výše uvedeném příkladu je _rid pro kolekci pLJdAOlEdgA=. |
| id | Jedná se o systémově vygenerovanou vlastnost. ID prostředku nabídky se automaticky vygeneruje při jeho vytvoření. Má stejnou hodnotu jako _rid nabídky. |
| _Zbavit | Jedná se o systémově vygenerovanou vlastnost. ID prostředku (_rid) je jedinečný identifikátor, který je také hierarchický podle zásobníku prostředků v modelu prostředků. Používá se interně k umístění a navigaci v nabídce. |
| _Ts | Jedná se o systémově vygenerovanou vlastnost. Určuje časové razítko poslední aktualizace prostředku. Hodnota je časové razítko. |
| _Vlastní | Jedná se o systémově vygenerovanou vlastnost. Jedná se o jedinečný adresovatelný identifikátor URI prostředku. |
| _Etag | Jedná se o systémově vygenerovanou vlastnost, která určuje etag prostředku vyžadovanou pro řízení optimistické souběžnosti. |
{
"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
}
Příklad
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
}
Poznámky
Další informace o maximální a minimální zřízené propustnosti, kterou je možné nastavit pro kontejner nebo databázi, najdete v článku Zřízení propustnosti pro kontejnery a databáze .
Provedením příkazu GET pro prostředek nabídky načtěte minimální propustnost, kterou je možné nastavit pro daný kontejner nebo databázi. Hlavička x-ms-cosmos-min-throughput odpovědi označuje minimální propustnost určenou systémem.