ConfidentialLedgerClient.CreateOrUpdateUser メソッド

定義

名前空間:

Azure.Security.ConfidentialLedger

アセンブリ:

Azure.Security.ConfidentialLedger.dll

パッケージ:

Azure.Security.ConfidentialLedger v1.2.0

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

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

public virtual Azure.Response CreateOrUpdateUser (string userId, Azure.Core.RequestContent content, Azure.RequestContext context = default);

abstract member CreateOrUpdateUser : string * Azure.Core.RequestContent * Azure.RequestContext -> Azure.Response
override this.CreateOrUpdateUser : string * Azure.Core.RequestContent * Azure.RequestContext -> Azure.Response

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

パラメーター

userId

String

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

content

RequestContent

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

context

RequestContext

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

戻り値

Response

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

例外

ArgumentNullException

userId または content が null です。

RequestFailedException

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

例

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

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 = client.CreateOrUpdateUser("<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.
}