Hämta ett erbjudande

  • Artikel

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.

Se även