通过

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

DocumentClient.ReadOfferAsync(String) 方法

  • 参考

定义

命名空间:
Microsoft.Azure.Documents.Client
程序集:
Microsoft.Azure.DocumentDB.Core.dll, Microsoft.Azure.Documents.Client.dll
包:
Microsoft.Azure.DocumentDB v2.18.0, Microsoft.Azure.DocumentDB.Core v2.18.0

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

要读取的产品/服务的链接。

返回

Task<ResourceResponse<Offer>>

一个 System.Threading.TasksResourceResponse<TResource> ，它包含包装 Offer 包含读取资源记录的 。

实现

ReadOfferAsync(String)

例外

ArgumentNullException

如果未 offerLink 设置 。

DocumentClientException

此异常可以封装许多不同类型的错误。 若要确定特定错误，请始终查看 StatusCode 属性。 创建文档时可能会获取的一些常见代码包括：

StatusCode异常原因
404NotFound - 这意味着你尝试读取的资源不存在。
429TooManyRequests - 这意味着已超出每秒请求单位数。 请参阅 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"];

适用于

另请参阅