KeyVaultAccessControlClient.CreateRoleAssignmentAsync 方法

定義

命名空間:

Azure.Security.KeyVault.Administration

組件:

Azure.Security.KeyVault.Administration.dll

套件:

Azure.Security.KeyVault.Administration v4.4.0

來源:

KeyVaultAccessControlClient.cs

建立角色指派。

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Security.KeyVault.Administration.KeyVaultRoleAssignment>> CreateRoleAssignmentAsync (Azure.Security.KeyVault.Administration.KeyVaultRoleScope roleScope, string roleDefinitionId, string principalId, Guid? roleAssignmentName = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateRoleAssignmentAsync : Azure.Security.KeyVault.Administration.KeyVaultRoleScope * string * string * Nullable<Guid> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Security.KeyVault.Administration.KeyVaultRoleAssignment>>
override this.CreateRoleAssignmentAsync : Azure.Security.KeyVault.Administration.KeyVaultRoleScope * string * string * Nullable<Guid> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Security.KeyVault.Administration.KeyVaultRoleAssignment>>

Public Overridable Function CreateRoleAssignmentAsync (roleScope As KeyVaultRoleScope, roleDefinitionId As String, principalId As String, Optional roleAssignmentName As Nullable(Of Guid) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of KeyVaultRoleAssignment))

參數

roleScope

KeyVaultRoleScope

要建立的角色指派範圍。

roleDefinitionId

String

角色指派中使用的角色定義識別碼。

principalId

String

指派給角色的主體識別碼。 這會對應至 Active Directory 內的識別碼。 它可以指向使用者、服務主體或安全性群組。

roleAssignmentName

Nullable<Guid>

用來建立角色指派的選擇性名稱。 如果未指定，將會產生新的 Guid 。

cancellationToken

CancellationToken

控制 CancellationToken 要求存留期的 。

傳回

Task<Response<KeyVaultRoleAssignment>>

， Task<TResult> 包含非同步作業的結果。

例外狀況

RequestFailedException

伺服器傳回錯誤。 如需從伺服器傳回的詳細資料，請參閱 Message 。

ArgumentNullException

roleDefinitionId 或 principalId 為 null。

ArgumentException

roleDefinitionId 或 principalId 是空的。