查詢供應項目
在供應項目資源 (也就是供應項目 URI 路徑) 上發出 POST，即可在供應項目資源上執行查詢。 本節將示範透過其自我連結擷取特定集合供應專案的簡單範例。
要求
| 方法 | 要求 URI | Description |
|---|---|---|
| POST | https://{databaseaccount}.documents.azure.com/offers |
請注意，{databaseaccount} 是您在訂用帳戶下建立的 Azure Cosmos DB 帳戶名稱。 |
標題
如需所有 Cosmos DB 要求所使用的標頭，請參閱常見的 Azure Cosmos DB REST 要求標頭 。
| 標頭 | 必要 | 描述 |
|---|---|---|
| Content-Type | 必要 | 必須設定為 application/query+json。 |
| x-ms-documentdb-isquery | 必要 | 必須設定為 True。 |
主體
| 屬性 | 必要 | Description |
|---|---|---|
| 查詢 | 必要 | 要執行 SQL 陳述式的此屬性值。 |
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}
回應
傳回符合查詢的物件資源陣列。
標題
如需所有 Cosmos DB 回應所傳回的標頭，請參閱 常見的 Azure Cosmos DB REST 回應標頭 。
| 標頭 | Description |
|---|---|
| x-ms-item-count | 這是從查詢傳回的專案數。 |
狀態碼
下表列出此作業所傳回的常見狀態碼。 如需狀態碼的完整清單，請參閱 HTTP 狀態碼。
| HTTP 狀態碼 | Description |
|---|---|
| 200 確定 | 作業成功。 |
| 400 不正確的要求 | JSON 內文無效。 |
| 401 未經授權 | 未設定 Authorization 或 x-ms-date 標頭。 當 Authorization 標頭設為無效的授權權杖時，也會傳回 401。 |
主體
| 屬性 | Description |
|---|---|
| _擺脫 | 它是系統產生的屬性。 此作業 _rid 值是空的。 |
| _計數 | 此屬性會顯示在作業中傳回的供應專案數目。 |
| 供應項目 | 它是陣列，其中包含在作業中傳回的供應專案。 請參閱 供應專案 以尋找供應專案資源的屬性。 |
{"_rid":"","Offers":[],"_count":0}
範例
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}