你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
DocumentClient.ReadOfferAsync(String) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
Offer以异步操作的形式从 Azure Cosmos DB 服务读取 。
public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Offer>> ReadOfferAsync (string offerLink);abstract member ReadOfferAsync : string -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Offer>>
override this.ReadOfferAsync : string -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Offer>>Public Function ReadOfferAsync (offerLink As String) As Task(Of ResourceResponse(Of Offer))参数
- offerLink
- String
要读取的产品/服务的链接。
返回
一个 System.Threading.TasksResourceResponse<TResource> ，它包含包装 Offer 包含读取资源记录的 。
实现
例外
如果未 offerLink 设置 。
此异常可以封装许多不同类型的错误。 若要确定特定错误，请始终查看 StatusCode 属性。 创建文档时可能会获取的一些常见代码包括：
| StatusCode | 异常原因 |
|---|---|
| 404 | NotFound - 这意味着你尝试读取的资源不存在。 |
| 429 | TooManyRequests - 这意味着已超出每秒请求单位数。 请参阅 DocumentClientException.RetryAfter 值，了解在重试此操作之前应等待多长时间。 |
示例
//Reads an Offer resource from a Database
// - offer_id is the ID of the offer to be read
var offerLink = "/offers/offer_id";
Offer offer = await client.ReadOfferAsync(offerLink);
注解
读取资源是从数据库获取资源的最有效方法。 如果知道资源的 ID，请执行读取而不是按 ID 进行查询。
对于产品/服务，ID 始终在创建链接资源时由系统在内部生成。 id 和 _rid 对于产品/服务始终相同。
https://docs.microsoft.com/en-us/azure/cosmos-db/how-to-provision-container-throughput若要详细了解 Cosmos 容器 (或数据库的最低吞吐量) 若要检索集合/数据库的最低吞吐量，请使用以下示例
// Find the offer for the collection by SelfLink
Offer offer = client.CreateOfferQuery(
string.Format("SELECT * FROM offers o WHERE o.resource = '{0}'", collectionSelfLink)).AsEnumerable().FirstOrDefault();
ResourceResponse<Offer> response = await client.ReadOfferAsync(offer.SelfLink);
string minimumRUsForCollection = response.ResponseHeaders["x-ms-cosmos-min-throughput"];
