ConfidentialLedgerClient.CreateOrUpdateUserAsync メソッド

定義

名前空間:

Azure.Security.ConfidentialLedger

アセンブリ:

Azure.Security.ConfidentialLedger.dll

パッケージ:

Azure.Security.ConfidentialLedger v1.2.0

[プロトコルメソッド]ユーザーを追加するか、ユーザーのフィールドを更新します。

• この プロトコル メソッド を使用すると、高度なシナリオで応答の要求と処理を明示的に作成できます。

public virtual System.Threading.Tasks.Task<Azure.Response> CreateOrUpdateUserAsync (string userId, Azure.Core.RequestContent content, Azure.RequestContext context = default);

abstract member CreateOrUpdateUserAsync : string * Azure.Core.RequestContent * Azure.RequestContext -> System.Threading.Tasks.Task<Azure.Response>
override this.CreateOrUpdateUserAsync : string * Azure.Core.RequestContent * Azure.RequestContext -> System.Threading.Tasks.Task<Azure.Response>

Public Overridable Function CreateOrUpdateUserAsync (userId As String, content As RequestContent, Optional context As RequestContext = Nothing) As Task(Of Response)

パラメーター

userId

String

ユーザー ID(AAD オブジェクト ID または証明書フィンガープリント)。

content

RequestContent

要求の本文として送信するコンテンツ。

context

RequestContext

要求コンテキスト。これは、クライアント パイプラインの既定の動作を呼び出しごとにオーバーライドできます。

戻り値

Task<Response>

サービスから返された応答。

例外

ArgumentNullException

userId または content が null です。

RequestFailedException

サービスから成功以外の状態コードが返されました。

例

このサンプルでは、必要なパラメーターを指定して CreateOrUpdateUserAsync を呼び出し、コンテンツを要求し、結果を解析する方法を示します。

var credential = new DefaultAzureCredential();
var endpoint = new Uri("<https://my-service.azure.com>");
var client = new ConfidentialLedgerClient(endpoint, credential);

var data = new {
    assignedRole = "Administrator",
};

Response response = await client.CreateOrUpdateUserAsync("<userId>", RequestContent.Create(data));

JsonElement result = JsonDocument.Parse(response.ContentStream).RootElement;
Console.WriteLine(result.GetProperty("assignedRole").ToString());
Console.WriteLine(result.GetProperty("userId").ToString());

注釈

JSON マージ パッチが既存のユーザーに適用される

要求と応答のペイロードの JSON スキーマを次に示します。

要求本文:

の LedgerUserスキーマ:

{
  assignedRole: "Administrator" | "Contributor" | "Reader", # Required. Represents an assignable role.
  userId: string, # Optional. Identifier for the user. This must either be an AAD object id or a certificate fingerprint.
}

応答本文:

の LedgerUserスキーマ:

{
  assignedRole: "Administrator" | "Contributor" | "Reader", # Required. Represents an assignable role.
  userId: string, # Optional. Identifier for the user. This must either be an AAD object id or a certificate fingerprint.
}