Penawaran Kueri

  • Artikel

Anda dapat melakukan kueri pada sumber daya penawaran dengan mengeluarkan POST pada sumber daya penawaran, yaitu jalur URI penawaran. Bagian ini akan menunjukkan contoh sederhana untuk mengambil penawaran untuk koleksi tertentu dengan tautan mandirinya.

Minta

Metode Meminta URI Deskripsi
POSTING https://{databaseaccount}.documents.azure.com/offers Perhatikan bahwa {databaseaccount} adalah nama akun Azure Cosmos DB yang Anda buat di bawah langganan Anda.

Header

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

Header Diperlukan Deskripsi
Content-Type Diperlukan Harus diatur ke application/query+json.
x-ms-documentdb-isquery Diperlukan Harus diatur ke True.

Isi

Properti Diperlukan Deskripsi
query Diperlukan Nilai properti ini pernyataan SQL yang akan dijalankan. 
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}

Respons

Mengembalikan array sumber daya objek yang cocok dengan kueri.

Header

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

Header Deskripsi
x-ms-item-count Ini adalah jumlah item yang dikembalikan dari kueri.

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.
400 Permintaan Buruk Isi JSON tidak valid.
401 Tidak Sah Header Otorisasi atau x-ms-date tidak diatur. 401 juga dikembalikan ketika header Otorisasi diatur ke token otorisasi yang tidak valid.

Isi

Properti Deskripsi
_rid Ini adalah properti yang dihasilkan sistem. Nilai _rid kosong untuk operasi ini.
_Menghitung Properti ini menunjukkan jumlah penawaran yang dikembalikan sebagai bagian dari operasi.
Penawaran Ini adalah array yang berisi penawaran yang dikembalikan sebagai bagian dari operasi.
Lihat Penawaran untuk menemukan properti sumber daya penawaran.		 
{"_rid":"","Offers":[],"_count":0}

Contoh

POST https://querydemo.documents.azure.com/offers HTTP/1.1  
x-ms-continuation:   
x-ms-documentdb-isquery: True  
x-ms-documentdb-query-enablecrosspartition: False  
x-ms-date: Tue, 29 Mar 2016 18:07:41 GMT  
authorization: type%3dmaster%26ver%3d1.0%26sig%3d0si%2fhno2pKTQhgvdkojNqlQlYdoguwQEBt79XvpobMc%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  
Content-Type: application/query+json  
Host: querydemo.documents.azure.com  
Content-Length: 94  
Expect: 100-continue  
  
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}
  

HTTP/1.1 200 Ok  
Cache-Control: no-store, no-cache  
Pragma: no-cache  
Transfer-Encoding: chunked  
Content-Type: application/json  
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  
x-ms-item-count: 0  
x-ms-schemaversion: 1.1  
x-ms-request-charge: 3.94  
x-ms-serviceversion: version=1.6.52.5  
x-ms-activity-id: b151cbe4-aae0-4949-959f-189b9884478d  
x-ms-session-token: M:8166  
x-ms-gatewayversion: version=1.6.52.5  
Date: Tue, 29 Mar 2016 18:07:41 GMT  
  
{"_rid":"","Offers":[],"_count":0}

Lihat juga