你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
获取服务
若要检索产品/服务资源，请对 套餐 资源执行 GET。
请求
| 方法 | 请求 URI | 说明 |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/offers/{_rid-offer} |
请注意，{databaseaccount} 是在订阅下创建的 Azure Cosmos DB 帐户的名称。 {_rid-offer} 值是产品/服务系统生成的资源 ID。 |
标头
有关所有 Cosmos DB 请求 使用的标头，请参阅常见的 Azure Cosmos DB REST 请求标头。
构造主密钥令牌的哈希签名时，ResourceType 应为“offers”。 ResourceLink 应仅为要检索的产品/服务_rid。 该值必须为小写。 例如，在 上 https://querydemo.documents.azure.com/offers/uT2L执行 GET 时，主密钥令牌中的 ResourceLink 应为“ut2l”。
正文
无。
响应
返回请求的套餐资源。
标头
有关所有 Cosmos DB 响应 返回的标头，请参阅常见的 Azure Cosmos DB REST 响应标头。
状态代码
下表列出了此操作返回的常见状态代码。 有关状态代码的完整列表，请参阅 HTTP 状态代码。
| HTTP 状态代码 | 说明 |
|---|---|
| 200 正常 | 操作成功。 |
| 404 未找到 | 产品/服务不再是资源，即父集合资源已删除。 |
正文
| 属性 | 描述 |
|---|---|
| offerVersion | 对于预定义的吞吐量级别，此值可以是 V1，对于用户定义的吞吐量级别，此值可以是 V2。 |
| offerType | 此值指示 V1 产品/服务版本的性能级别，V1 产品/服务允许的值为 S1、S2 或 S3。 对于 V2 产品/服务版本，此属性设置为“无效”。 |
| content | 它包含有关产品/服务的信息。 对于 V2 产品/服务，它包含集合的吞吐量。 |
| resource | 创建新集合时，此属性设置为集合的自链接，例如 dbs/pLJdAA==/colls/pLJdAOlEdgA=/。 |
| offerResourceId | 在创建集合期间，此属性会自动关联到资源 ID，即 集合_rid 。 在上面的示例中，集合 的_rid 为 pLJdAOlEdgA=。 |
| id | 它是系统生成的属性。 产品/服务资源的 ID 在创建时自动生成。 其值与产品 /服务的_rid 相同。 |
| _摆脱 | 它是系统生成的属性。 资源 ID (_rid) 是一个唯一标识符，也是根据资源模型上的资源堆栈分层的。 它可供内部用于放置和导航服务。 |
| _ts | 它是系统生成的属性。 它指定资源的上次更新时间戳。 高值是一个时间戳。 |
| _自我 | 它是系统生成的属性。 它是资源的唯一可寻址 URI。 |
| _Etag | 它是一个系统生成的属性，用于指定乐观并发控制所需的资源 etag。 |
{
"offerVersion": "V2",
"offerType": "Invalid",
"content": {
"offerThroughput": 4000
},
"resource": "dbs/rgkVAA==/colls/rgkVAMHcJww=/",
"offerResourceId": "rgkVAMHcJww=",
"id": "uT2L",
"_rid": "uT2L",
"_self": "offers/uT2L/",
"_etag": "\"0000a600-0000-0000-0000-56fac0570000\"",
"_ts": 1459273815
}
示例
GET https://querydemo.documents.azure.com/offers/uT2L HTTP/1.1
x-ms-date: Tue, 29 Mar 2016 17:50:18 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3dA9Y9JAZylsBHG%2bM1Rdb3PpzO3Fw7kMJbRUJ8Llh2kpo%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
Host: querydemo.documents.azure.com
HTTP/1.1 200 Ok
Cache-Control: no-store, no-cache
Pragma: no-cache
Transfer-Encoding: chunked
Content-Type: application/json
Content-Location: https://querydemo.documents.azure.com/offers/uT2L
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
etag: "0000a600-0000-0000-0000-56fac0570000"
x-ms-schemaversion: 1.1
x-ms-request-charge: 2
x-ms-serviceversion: version=1.6.52.5
x-ms-activity-id: bfa5991d-46f5-4c40-b3f0-957fccd8df9e
x-ms-session-token: M:8110
x-ms-gatewayversion: version=1.6.52.5
x-ms-cosmos-min-throughput: 400
Date: Tue, 29 Mar 2016 17:50:18 GMT
{
"offerVersion": "V2",
"offerType": "Invalid",
"content": {
"offerThroughput": 4000
},
"resource": "dbs/rgkVAA==/colls/rgkVAMHcJww=/",
"offerResourceId": "rgkVAMHcJww=",
"id": "uT2L",
"_rid": "uT2L",
"_self": "offers/uT2L/",
"_etag": "\"0000a600-0000-0000-0000-56fac0570000\"",
"_ts": 1459273815
}
注解
若要详细了解可在容器或数据库上设置的最大和最小预配吞吐量，请参阅 在容器和数据库上预配吞吐量 一文。
对产品/服务资源执行 GET 以检索可以为给定容器或数据库设置的最小吞吐量。 响应标头 x-ms-cosmos-min-throughput 表示系统确定的最小吞吐量。