Dapatkan Penawaran

  • Artikel

Untuk mengambil sumber daya penawaran, lakukan GET pada sumber daya Penawaran .

Minta

Metode Meminta URI Deskripsi
GET https://{databaseaccount}.documents.azure.com/offers/{_rid-offer} Perhatikan bahwa {databaseaccount} adalah nama akun Azure Cosmos DB yang Anda buat di bawah langganan Anda. Nilai {_rid-offer} adalah ID sumber daya yang dihasilkan sistem dari penawaran.

Header

Lihat Header permintaan Rest Azure Cosmos DB umum untuk header yang digunakan oleh semua permintaan Cosmos DB.

Saat membuat tanda tangan yang di-hash untuk token kunci master, ResourceType harus berupa "penawaran". ResourceLinkhanya boleh menjadi _rid dari penawaran yang ingin Anda ambil. Nilai harus huruf kecil. Misalnya, saat melakukan GET pada https://querydemo.documents.azure.com/offers/uT2L, ResourceLink dalam token kunci master harus "ut2l".

Isi

Tidak ada.

Respons

Mengembalikan sumber daya penawaran yang diminta.

Header

Lihat Header respons Rest Azure Cosmos DB umum untuk header yang dikembalikan oleh semua respons Cosmos DB.

Kode status

Tabel berikut mencantumkan kode status umum yang dikembalikan oleh operasi ini. Untuk daftar lengkap kode status, lihat Kode Status HTTP.

Kode status HTTP Deskripsi
200 Ok Operasi berhasil.
404 Tidak Ditemukan Penawaran ini bukan lagi sumber daya, yaitu sumber daya koleksi induk dihapus.

Isi

Properti Deskripsi
offerVersion Nilai ini dapat berupa V1 untuk tingkat throughput yang telah ditentukan sebelumnya dan V2 untuk tingkat throughput yang ditentukan pengguna.
offerType Nilai ini menunjukkan tingkat performa untuk versi penawaran V1, nilai yang diizinkan untuk penawaran V1 adalah S1, S2, atau S3. Properti ini diatur ke Tidak valid untuk versi penawaran V2.
konten Ini berisi informasi tentang penawaran. Untuk penawaran V2, ini berisi throughput koleksi.
resource Saat membuat koleksi baru, properti ini diatur ke tautan mandiri koleksi, misalnya, dbs/pLJdAA==/colls/pLJdAOlEdgA=/.
offerResourceId Selama pembuatan koleksi, properti ini secara otomatis dikaitkan dengan ID sumber daya, yaitu _rid koleksi. Dalam contoh di atas, _rid untuk koleksi adalah pLJdAOlEdgA=.
id Ini adalah properti yang dihasilkan sistem. ID untuk sumber daya penawaran dibuat secara otomatis saat dibuat. Ini memiliki nilai yang sama dengan _rid untuk penawaran.
_rid Ini adalah properti yang dihasilkan sistem. ID sumber daya (_rid) adalah pengidentifikasi unik yang juga hierarkis per tumpukan sumber daya pada model sumber daya. Ini digunakan secara internal untuk penempatan dan navigasi penawaran.
_Ts Ini adalah properti yang dihasilkan sistem. Ini menentukan tanda waktu terakhir yang diperbarui dari sumber daya. Nilainya adalah tanda waktu.
_self Ini adalah properti yang dihasilkan sistem. Ini adalah URI unik yang dapat diatasi untuk sumber daya.
_etag Ini adalah properti yang dihasilkan sistem yang menentukan etag sumber daya yang diperlukan untuk kontrol konkurensi optimis. 
{  
  "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  
}

Contoh

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  
}

Keterangan

Untuk mempelajari selengkapnya tentang throughput maksimum dan minimum yang disediakan yang dapat diatur pada kontainer atau database, lihat artikel Menyediakan throughput pada kontainer dan database .

Lakukan GET pada sumber daya penawaran untuk mengambil throughput minimum yang dapat diatur untuk kontainer atau database tertentu. Header x-ms-cosmos-min-throughput respons menunjukkan throughput minimum yang ditentukan sistem.

Lihat juga