IDocumentClient.UpsertUserAsync メソッド

定義

名前空間:

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

オーバーロード

UpsertUserAsync(String, User, RequestOptions)	Azure Cosmos DB サービス内のユーザー オブジェクトに対するアクセス許可を、非同期操作としてアップサートします。
UpsertUserAsync(Uri, User, RequestOptions)	ユーザーを Azure Cosmos DB サービスの非同期操作としてアップサートします。

UpsertUserAsync(String, User, RequestOptions)

Azure Cosmos DB サービス内のユーザー オブジェクトに対するアクセス許可を、非同期操作としてアップサートします。

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>> UpsertUserAsync (string databaseLink, Microsoft.Azure.Documents.User user, Microsoft.Azure.Documents.Client.RequestOptions options = default);

abstract member UpsertUserAsync : string * Microsoft.Azure.Documents.User * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>>

Public Function UpsertUserAsync (databaseLink As String, user As User, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of User))

パラメーター

databaseLink

String

ユーザーをアップサートするデータベースのリンク。 例: dbs/db_rid/

user

User

Userアップサートするオブジェクト。

options

RequestOptions

(省略可能)要求の要求オプション。

戻り値

Task<ResourceResponse<User>>

アップサートされた User オブジェクトを含む非同期操作のサービス応答を表すタスク オブジェクト。

例外

ArgumentNullException

または user がdatabaseLink設定されていない場合。

AggregateException

非同期処理中に発生したエラーの統合を表します。 InnerExceptions 内を見て、実際の例外を見つけます

DocumentClientException

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

StatusCode	例外の理由
400	BadRequest - これは、指定された要求に問題が発生したことを意味します。
403	禁止 - このデータベースのユーザー オブジェクトのクォータに達しました。 このクォータを増やすには、サポートにお問い合わせください。
409	競合 - 指定した ID と一致する ID が既に存在する を意味 User します。

例

//Upsert a new user called joeBloggs in the specified database
User user = await client.UpsertUserAsync(databaseLink, new User { Id = "joeBloggs" });

こちらもご覧ください

• ResourceResponse<TResource>
• Task
• User
• RequestOptions

UpsertUserAsync(Uri, User, RequestOptions)

ユーザーを Azure Cosmos DB サービスの非同期操作としてアップサートします。

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>> UpsertUserAsync (Uri databaseUri, Microsoft.Azure.Documents.User user, Microsoft.Azure.Documents.Client.RequestOptions options = default);

abstract member UpsertUserAsync : Uri * Microsoft.Azure.Documents.User * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>>

Public Function UpsertUserAsync (databaseUri As Uri, user As User, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of User))

パラメーター

databaseUri

Uri

ユーザーをアップサートするデータベースの URI。

user

User

User オブジェクト。

options

RequestOptions

(省略可能) RequestOptions 要求の 。

戻り値

Task<ResourceResponse<User>>

非同期操作のサービス応答を表すタスク オブジェクト。