Udostępnij za pośrednictwem

Pobieranie oferty

  • Artykuł

Aby pobrać zasób oferty, wykonaj get na zasobie oferty .

Żądanie

Metoda Identyfikator URI żądania Opis
GET https://{databaseaccount}.documents.azure.com/offers/{_rid-offer} Pamiętaj, że {databaseaccount} jest nazwą konta usługi Azure Cosmos DB utworzonego w ramach subskrypcji. Wartość {_rid-offer} jest identyfikatorem zasobu generowanego przez system oferty.

Nagłówki

Zobacz Typowe nagłówki żądań REST usługi Azure Cosmos DB dla nagłówków , które są używane przez wszystkie żądania usługi Cosmos DB.

Podczas konstruowania sygnatury skrótu tokenu klucza głównego typ zasobu powinien mieć wartość "oferty". Element ResourceLink powinien być tylko _rid oferty, którą chcesz pobrać. Wartość musi być mała. Na przykład podczas wykonywania polecenia GET w elemecie https://querydemo.documents.azure.com/offers/uT2LResourceLink w tokenie klucza głównego powinien być "ut2l".

Treść

Brak.

Reakcja

Zwraca żądany zasób oferty.

Nagłówki

Zobacz Typowe nagłówki odpowiedzi REST usługi Azure Cosmos DB dla nagłówków zwracanych przez wszystkie odpowiedzi usługi Cosmos DB.

Kody stanu

Poniższa tabela zawiera listę typowych kodów stanu zwracanych przez tę operację. Aby uzyskać pełną listę kodów stanu, zobacz Kody stanu HTTP.

Kod stanu HTTP Opis
200 OK Operacja zakończyła się pomyślnie.
404 — Nie znaleziono Oferta nie jest już zasobem, czyli zasobem kolekcji nadrzędnej została usunięta.

Treść

Właściwość Opis
offerVersion Ta wartość może być w wersji 1 dla wstępnie zdefiniowanych poziomów przepływności i wersji 2 dla poziomów przepływności zdefiniowanych przez użytkownika.
offerType Ta wartość wskazuje poziom wydajności dla wersji 1 oferty, dozwolone wartości oferty V1 to S1, S2 lub S3. Ta właściwość jest ustawiona na nieprawidłową dla wersji oferty w wersji 2.
Zawartości Zawiera on informacje o ofercie. W przypadku ofert w wersji 2 zawiera przepływność kolekcji.
Zasobów Podczas tworzenia nowej kolekcji ta właściwość jest ustawiana na link własny kolekcji, na przykład dbs/pLJdAA==/colls/pLJdAOlEdgA=/.
offerResourceId Podczas tworzenia kolekcji ta właściwość jest automatycznie skojarzona z identyfikatorem zasobu, czyli _rid kolekcji. W powyższym przykładzie _rid kolekcji to pLJdAOlEdgA=.
id Jest to właściwość wygenerowana przez system. Identyfikator zasobu oferty jest generowany automatycznie podczas jego tworzenia. Ma taką samą wartość jak _rid dla oferty.
_Rid Jest to właściwość wygenerowana przez system. Identyfikator zasobu (_rid) to unikatowy identyfikator, który jest również hierarchiczny dla stosu zasobów w modelu zasobów. Jest on używany wewnętrznie do umieszczania i nawigacji oferty.
_Ts Jest to właściwość wygenerowana przez system. Określa ostatni zaktualizowany znacznik czasu zasobu. Wartość jest znacznikiem czasu.
_Własny Jest to właściwość wygenerowana przez system. Jest to unikatowy adresowy identyfikator URI zasobu.
_Etag Jest to właściwość wygenerowana przez system, która określa tag zasobu wymagany do optymistycznej kontroli współbieżności. 
{  
  "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  
}

Przykład

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  
}

Uwagi

Aby dowiedzieć się więcej na temat maksymalnej i minimalnej aprowizowanej przepływności, którą można ustawić w kontenerze lub bazie danych, zobacz artykuł Aprowizowanie przepływności kontenerów i baz danych .

Wykonaj polecenie GET w zasobie oferty, aby pobrać minimalną przepływność, którą można ustawić dla danego kontenera lub bazy danych. Nagłówek x-ms-cosmos-min-throughput odpowiedzi określa minimalną przepływność w systemie.

Zobacz też