通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

查询服务

  • 项目

可以通过在服务资源（即服务 URI 路径）上发出 POST 请求来对服务资源执行查询。 本部分将展示通过特定集合的自链接检索产品/服务的简单示例。

请求

方法 请求 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。

正文

属性 必选 说明
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 正常 操作成功。
400 错误的请求 JSON 正文无效。
401 未授权 未设置 Authorization 或 x-ms-date 标头。 将 Authorization 标头设置为无效的授权令牌时，也返回 401。

正文

属性 描述
_摆脱 它是系统生成的属性。 此操作 的_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}

另请参阅