Role Assignments - Create

Service:

Key Vault

API Version:

7.4

ロールの割り当てを作成します。

PUT {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleAssignments/{roleAssignmentName}?api-version=7.4

URI パラメーター

名前	/	必須	型	説明
roleAssignmentName	path	True	string	作成するロールの割り当ての名前。 任意の有効な GUID を指定できます。
scope	path	True	string	作成するロールの割り当てのスコープ。
vaultBaseUrl	path	True	string	コンテナー名 (例: https://myvault.vault.azure.net)。
api-version	query	True	string	クライアント API バージョン。

要求本文

名前	必須	型	説明
properties	True	RoleAssignmentProperties	ロールの割り当てプロパティ。

応答

名前	型	説明
201 Created	RoleAssignment	Created - ロールの割り当てに関する情報を返します。
Other Status Codes	KeyVaultError	操作が失敗した理由を説明するエラー応答をKey Vaultします。

例

PutRoleAssignments

Sample Request

HTTP

PUT https://myvault.vault.azure.net//keys/providers/Microsoft.Authorization/roleAssignments/roleAssignmentName?api-version=7.4

{
  "properties": {
    "roleDefinitionId": "/keys/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
    "principalId": "principalId"
  }
}

Sample Response

Status code:

201

{
  "properties": {
    "roleDefinitionId": "/keys/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
    "principalId": "principalId",
    "scope": "/keys"
  },
  "id": "/keys/providers/Microsoft.Authorization/roleAssignments/roleAssignmentId",
  "type": "Microsoft.Authorization/roleAssignments",
  "name": "roleAssignmentId"
}

定義

名前	説明
Error	キー コンテナー サーバーエラー。
KeyVaultError	キー コンテナーエラー例外。
RoleAssignment	ロールの割り当て
RoleAssignmentCreateParameters	ロールの割り当てによってパラメーターが作成されます。
RoleAssignmentProperties	ロールの割り当てプロパティ。
RoleAssignmentPropertiesWithScope	スコープを持つロールの割り当てプロパティ。
RoleScope	ロール スコープ。

Error

キー コンテナー サーバーエラー。

名前	型	説明
code	string	エラー コード。
innererror	Error	キー コンテナー サーバーエラー。
message	string	エラー メッセージ。

KeyVaultError

キー コンテナーエラー例外。

名前	型	説明
error	Error	キー コンテナー サーバーエラー。

RoleAssignment

ロールの割り当て

名前	型	説明
id	string	ロールの割り当て ID
name	string	ロールの割り当て名。
properties	RoleAssignmentPropertiesWithScope	ロールの割り当てプロパティ。
type	string	ロールの割り当ての種類。

RoleAssignmentCreateParameters

ロールの割り当てによってパラメーターが作成されます。

名前	型	説明
properties	RoleAssignmentProperties	ロールの割り当てプロパティ。

RoleAssignmentProperties

ロールの割り当てプロパティ。

名前	型	説明
principalId	string	ロールに割り当てられたプリンシパル ID。 これは Active Directory 内の ID にマップされます。 ユーザー、サービス プリンシパル、またはセキュリティ グループを指すことができます。
roleDefinitionId	string	ロールの割り当てで使用されるロール定義 ID。

RoleAssignmentPropertiesWithScope

スコープを持つロールの割り当てプロパティ。

名前	型	説明
principalId	string	プリンシパル ID。
roleDefinitionId	string	ロール定義 ID
scope	RoleScope	ロール スコープ。

RoleScope

ロール スコープ。

名前	型	説明
/	string	グローバル スコープ
/keys	string	キー スコープ