取得供應項目
若要擷取供應專案資源，請在 供應 專案資源上執行 GET。
要求
| 方法 | 要求 URI | 描述 |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/offers/{_rid-offer} |
請注意，{databaseaccount} 是您在您訂用帳戶下建立的 Azure Cosmos DB 帳戶名稱。 {_rid-offer} 值是供應專案的系統產生的資源識別碼。 |
標題
如需所有 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 狀態碼 | Description |
|---|---|
| 200 確定 | 作業成功。 |
| 404 找不到 | 供應專案不再是資源，也就是已刪除父集合資源。 |
主體
| 屬性 | Description |
|---|---|
| offerVersion | 此值可以是預先定義的輸送量層級的 V1，而使用者定義輸送量層級則為 V2。 |
| offerType | 此值表示 V1 供應專案的效能等級，V1 供應專案的允許值為 S1、S2 或 S3。 此屬性設定為 [V2 供應專案版本無效]。 |
| content | 其中包含供應專案的相關資訊。 對於 V2 供應專案，它包含集合的輸送量。 |
| 資源 | 建立新的集合時，這個屬性會設定為集合的自我連結，例如 dbs/pLJdAA==/colls/pLJdAOlEdgA=/。 |
| offerResourceId | 在建立集合期間，此屬性會自動與資源識別碼相關聯，也就是 集合_rid 。 在上述範例中，集合 的_rid 是 pLJdAOlEdgA=。 |
| id | 它是系統產生的屬性。 供應 專案資源的 識別碼會在建立時自動產生。 其值與供應專案的 _rid 相同。 |
| _擺脫 | 它是系統產生的屬性。 資源識別碼 (_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 表示系統決定的最小輸送量。