Teklifleri Sorgulama

  • Makale

Teklifler kaynağında (teklifler URI yolu gibi) bir POST göndererek teklif kaynakları üzerinde sorgular gerçekleştirebilirsiniz. Bu bölümde, belirli bir koleksiyona yönelik teklifleri kendi kendine bağlantısıyla almanın basit bir örneği gösterilir.

İstek

Yöntem İstek URI'si Description
POST https://{databaseaccount}.documents.azure.com/offers {databaseaccount}, aboneliğiniz altında oluşturduğunuz Azure Cosmos DB hesabının adıdır.

Üst Bilgiler

Tüm Cosmos DB istekleri tarafından kullanılan üst bilgiler için bkz. Yaygın Azure Cosmos DB REST isteği üst bilgileri.

Üst bilgi Gerekli Açıklama
İçerik Türü Gerekli application/query+json olarak ayarlanmalıdır.
x-ms-documentdb-isquery Gerekli True olarak ayarlanmalıdır.

Gövde

Özellik Gerekli Açıklama
Sorgu Gerekli Bu özelliğin değeri yürütülecek SQL deyimidir. 
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}

Yanıt

Sorguyla eşleşen bir nesne kaynakları dizisi döndürür.

Üst Bilgiler

Tüm Cosmos DB yanıtları tarafından döndürülen üst bilgiler için bkz. Genel Azure Cosmos DB REST yanıt üst bilgileri.

Üst bilgi Description
x-ms-item-count Sorgudan döndürülen öğe sayısıdır.

Durum kodları

Aşağıdaki tabloda bu işlem tarafından döndürülen genel durum kodları listelenmektedir. Durum kodlarının tam listesi için bkz. HTTP Durum Kodları.

HTTP durum kodu Açıklama
200 Tamam İşlem başarılı oldu.
400 Hatalı İstek JSON gövdesi geçersiz.
401 Yetkisiz Yetkilendirme veya x-ms-date üst bilgisi ayarlanmadı. Yetkilendirme üst bilgisi geçersiz yetkilendirme belirtecine ayarlandığında da 401 döndürülür.

Gövde

Özellik Açıklama
_Kurtulmak Sistem tarafından oluşturulan bir özelliktir. bu işlem için _rid değeri boş.
_Sayısı Bu özellik, işlemin bir parçası olarak döndürülen tekliflerin sayısını gösterir.
Teklifler İşlemin bir parçası olarak döndürülen teklifleri içeren dizidir.
Teklif kaynağının özelliklerini bulmak için bkz. Teklifler .		 
{"_rid":"","Offers":[],"_count":0}

Örnek

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}

Ayrıca Bkz.