次の方法で共有

IDocumentClient.ReplaceOfferAsync(Offer) メソッド

  • リファレンス

定義

名前空間:
Microsoft.Azure.Documents
アセンブリ:
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>> ReplaceOfferAsync (Microsoft.Azure.Documents.Offer offer);
abstract member ReplaceOfferAsync : Microsoft.Azure.Documents.Offer -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Offer>>
Public Function ReplaceOfferAsync (offer As Offer) As Task(Of ResourceResponse(Of Offer))

パラメーター

offer
Offer

既存のリソースを に置き換えるために更新 Offer された 。

戻り値

Task<ResourceResponse<Offer>>

System.Threading.Tasks更新されたリソース レコードをResourceResponse<TResource>含む をOfferラップする を含む 。

例外

ArgumentNullException

が設定されていない場合 offer 。

DocumentClientException

この例外は、さまざまな種類のエラーをカプセル化できます。 特定のエラーを特定するには、常に StatusCode プロパティを参照してください。 ドキュメントの作成時に取得できる一般的なコードは次のとおりです。

StatusCode例外の理由
404NotFound - 削除しようとしたリソースが存在しなかったことを意味します。
429TooManyRequests - オファーのスケール ダウン操作が 4 時間のアイドル タイムアウト期間内に試行されると、置換オファーが調整されます。 DocumentClientException.RetryAfter の値を調べ、この操作を再試行する前に待機する必要がある時間を確認します。

例

//Fetch the resource to be updated
Offer offer = client.CreateOfferQuery()
                         .Where(r => r.ResourceLink == "collection selfLink")
                         .AsEnumerable()
                         .SingleOrDefault();

//Create a new offer with the changed throughput
OfferV2 newOffer = new OfferV2(offer, 5000);

//Now persist these changes to the database by replacing the original resource
Offer updated = await client.ReplaceOfferAsync(newOffer);

適用対象

こちらもご覧ください