Hämta ett erbjudande
Om du vill hämta en erbjudanderesurs utför du en GET på erbjudanderesursen .
Förfrågan
| Metod | URI för förfrågan | Beskrivning |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/offers/{_rid-offer} |
Observera att {databaseaccount} är namnet på det Azure Cosmos DB-konto som du skapade under din prenumeration. Värdet {_rid-offer} är det systemgenererade resurs-ID:t för erbjudandet. |
Sidhuvuden
Se Vanliga REST-begärandehuvuden för Azure Cosmos DB för rubriker som används av alla Cosmos DB-begäranden.
När du skapar den hashade signaturen för huvudnyckeltoken ska ResourceType vara "offers".
ResourceLink ska bara vara den _rid för det erbjudande som du vill hämta. Värdet måste vara gemener. När du till exempel utför en GET på https://querydemo.documents.azure.com/offers/uT2Lska ResourceLink i huvudnyckeltoken vara "ut2l".
Brödtext
Inga.
Svarsåtgärder
Returnerar den begärda erbjudanderesursen.
Sidhuvuden
Se Vanliga AZURE Cosmos DB REST-svarshuvuden för rubriker som returneras av alla Cosmos DB-svar.
Statuskoder
I följande tabell visas vanliga statuskoder som returneras av den här åtgärden. En fullständig lista över statuskoder finns i HTTP-statuskoder.
| HTTP-statuskod | Beskrivning |
|---|---|
| 200 Ok | Åtgärden lyckades. |
| 404 – Hittades inte | Erbjudandet är inte längre en resurs, dvs. den överordnade samlingsresursen har tagits bort. |
Brödtext
| Egenskap | Beskrivning |
|---|---|
| offerVersion | Det här värdet kan vara V1 för fördefinierade dataflödesnivåer och V2 för användardefinierade dataflödesnivåer. |
| offerType | Det här värdet anger prestandanivån för V1-erbjudandeversionen, tillåtna värden för V1-erbjudandet är S1, S2 eller S3. Den här egenskapen är inställd på Ogiltig för V2-erbjudandeversion. |
| Innehåll | Den innehåller information om erbjudandet. För V2-erbjudanden innehåller den dataflödet för samlingen. |
| Resurs | När du skapar en ny samling anges den här egenskapen till självlänken för samlingen, till exempel dbs/pLJdAA==/colls/pLJdAOlEdgA=/. |
| offerResourceId | När en samling skapas associeras den här egenskapen automatiskt med resurs-ID: t, det vill _rid av samlingen. I exemplet ovan är _rid för samlingen pLJdAOlEdgA=. |
| id | Det är en systemgenererad egenskap. ID:t för erbjudanderesursen genereras automatiskt när den skapas. Det har samma värde som _rid för erbjudandet. |
| _Bli | Det är en systemgenererad egenskap. Resurs-ID :t (_rid) är en unik identifierare som också är hierarkisk per resursstacken i resursmodellen. Det används internt för placering och navigering av erbjudandet. |
| _Ts | Det är en systemgenererad egenskap. Den anger resursens senast uppdaterade tidsstämpel. Värdet är en tidsstämpel. |
| _Själv | Det är en systemgenererad egenskap. Det är den unika adresserbara URI:n för resursen. |
| _Etag | Det är en systemgenererad egenskap som anger resursetaggen som krävs för optimistisk samtidighetskontroll. |
{
"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
}
Exempel
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
}
Kommentarer
Mer information om det maximala och lägsta etablerade dataflödet som kan anges för en container eller en databas finns i artikeln Etablera dataflöde för containrar och databaser .
Utför GET på erbjudanderesursen för att hämta det minsta dataflöde som kan anges för en viss container eller databas. Svarshuvudet x-ms-cosmos-min-throughput anger det systembestämmade minsta dataflödet.