オファーに対するクエリの実行

  • [アーティクル]

オファー リソースでクエリを実行するには、オファー リソース、つまりオファー URI パスで POST を発行します。 このセクションでは、セルフリンクによって特定のコレクションのオファーを取得する簡単な例を示します。

Request

Method 要求 URI 説明
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 に設定する必要があります。

Body

プロパティ 必須 説明
query 必須 実行する SQL ステートメントのこのプロパティの値。 
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}

[応答]

クエリに一致するオブジェクト リソースの配列を返します。

ヘッダー

すべての Cosmos DB 応答によって返されるヘッダーについては、「 共通の Azure Cosmos DB REST 応答ヘッダー 」を参照してください。

ヘッダー 説明
x-ms-item-count クエリから返される項目の数です。

状態コード

次の表に、この操作で返される一般的なステータス コードを示します。 状態コードの完全な一覧については、「 HTTP 状態コード」を参照してください。

HTTP 状態コード 説明
200 Ok 操作に成功しました。
400 Bad Request JSON の本文が無効です。
401 権限がありません Authorization または x-ms-date ヘッダーが設定されていません。 401 は、Authorization ヘッダーが無効な認証トークンに設定されている場合にも返されます。

Body

プロパティ 説明
_解消 これは、システムによって生成されるプロパティです。 この操作の_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}

参照