Role Definitions - Create Or Update

サービス:

Key Vault

API バージョン:

7.4

カスタム ロール定義を作成または更新します。

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

URI パラメーター

名前	/	必須	型	説明
roleDefinitionName	path	True	string	作成または更新するロール定義の名前。 任意の有効な GUID を指定できます。
scope	path	True	string	作成または更新するロール定義のスコープ。 Managed HSM では、'/' のみがサポートされます。
vaultBaseUrl	path	True	string	コンテナー名 (https://myvault.vault.azure.netなど)。
api-version	query	True	string	クライアント API のバージョン。

要求本文

名前	必須	型	説明
properties	True	RoleDefinitionProperties	ロール定義プロパティ。

応答

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

例

PutRoleDefinition

要求のサンプル

HTTP

PUT https://myvault.vault.azure.net//keys/providers/Microsoft.Authorization/roleDefinitions/00000000-0000-0000-0000-000000000000?api-version=7.4

{
  "properties": {
    "roleName": "My custom role",
    "type": "CustomRole",
    "description": "Role description",
    "permissions": [
      {
        "dataActions": [
          "Microsoft.KeyVault/managedHsm/keys/sign/action"
        ]
      }
    ]
  }
}

応答のサンプル

状態コード:

201

{
  "properties": {
    "roleName": "My custom role",
    "type": "CustomRole",
    "description": "Role description",
    "assignableScopes": [
      "/"
    ],
    "permissions": [
      {
        "dataActions": [
          "Microsoft.KeyVault/managedHsm/keys/sign/action"
        ]
      }
    ]
  },
  "id": "Microsoft.KeyVault/providers/Microsoft.Authorization/roleDefinitions/00000000-0000-0000-0000-000000000000",
  "type": "Microsoft.Authorization/roleDefinitions",
  "name": "00000000-0000-0000-0000-000000000000"
}

定義

名前	説明
DataAction	データ アクションでサポートされているアクセス許可。
Error	キー コンテナー サーバー エラー。
KeyVaultError	キー コンテナーのエラー例外。
Permission	ロール定義のアクセス許可。
RoleDefinition	ロールの定義。
RoleDefinitionCreateParameters	ロール定義によってパラメーターが作成されます。
RoleDefinitionProperties	ロール定義プロパティ。
RoleDefinitionType	ロール定義の種類。
RoleScope	ロール スコープ。
RoleType	ロールの種類。

DataAction

列挙

データ アクションでサポートされているアクセス許可。

値	説明
Microsoft.KeyVault/managedHsm/backup/start/action	HSM バックアップを開始します。
Microsoft.KeyVault/managedHsm/backup/status/action	HSM バックアップの状態を読み取ります。
Microsoft.KeyVault/managedHsm/keys/backup/action	HSM キーをバックアップします。
Microsoft.KeyVault/managedHsm/keys/create	HSM キーを作成します。
Microsoft.KeyVault/managedHsm/keys/decrypt/action	HSM キーを使用して暗号化を解除します。
Microsoft.KeyVault/managedHsm/keys/delete	HSM キーを削除します。
Microsoft.KeyVault/managedHsm/keys/deletedKeys/delete	削除された HSM キーを消去します。
Microsoft.KeyVault/managedHsm/keys/deletedKeys/read/action	削除された HSM キーを読み取ります。
Microsoft.KeyVault/managedHsm/keys/deletedKeys/recover/action	削除された HSM キーを復旧します。
Microsoft.KeyVault/managedHsm/keys/encrypt/action	HSM キーを使用して暗号化します。
Microsoft.KeyVault/managedHsm/keys/export/action	HSM キーをエクスポートします。
Microsoft.KeyVault/managedHsm/keys/import/action	HSM キーをインポートします。
Microsoft.KeyVault/managedHsm/keys/read/action	HSM キーメタデータを読み取ります。
Microsoft.KeyVault/managedHsm/keys/release/action	Secure Key Release を使用して HSM キーを解放します。
Microsoft.KeyVault/managedHsm/keys/restore/action	HSM キーを復元します。
Microsoft.KeyVault/managedHsm/keys/sign/action	HSM キーを使用して署名します。
Microsoft.KeyVault/managedHsm/keys/unwrap/action	HSM キーを使用してラップを解除します。
Microsoft.KeyVault/managedHsm/keys/verify/action	HSM キーを使用して確認します。
Microsoft.KeyVault/managedHsm/keys/wrap/action	HSM キーを使用してラップします。
Microsoft.KeyVault/managedHsm/keys/write/action	HSM キーを更新します。
Microsoft.KeyVault/managedHsm/restore/start/action	HSM の復元を開始します。
Microsoft.KeyVault/managedHsm/restore/status/action	HSM の復元状態を読み取る。
Microsoft.KeyVault/managedHsm/rng/action	乱数を生成します。
Microsoft.KeyVault/managedHsm/roleAssignments/delete/action	ロールの割り当てを削除します。
Microsoft.KeyVault/managedHsm/roleAssignments/read/action	ロールの割り当てを取得します。
Microsoft.KeyVault/managedHsm/roleAssignments/write/action	ロールの割り当てを作成または更新します。
Microsoft.KeyVault/managedHsm/roleDefinitions/delete/action	ロール定義を削除します。
Microsoft.KeyVault/managedHsm/roleDefinitions/read/action	ロール定義を取得します。
Microsoft.KeyVault/managedHsm/roleDefinitions/write/action	ロール定義を作成または更新します。
Microsoft.KeyVault/managedHsm/securitydomain/download/action	HSM セキュリティ ドメインをダウンロードします。
Microsoft.KeyVault/managedHsm/securitydomain/download/read	HSM セキュリティ ドメインのダウンロードの状態を確認します。
Microsoft.KeyVault/managedHsm/securitydomain/transferkey/read	HSM セキュリティ ドメイン転送キーをダウンロードします。
Microsoft.KeyVault/managedHsm/securitydomain/upload/action	HSM セキュリティ ドメインをアップロードします。
Microsoft.KeyVault/managedHsm/securitydomain/upload/read	HSM セキュリティ ドメイン交換ファイルの状態を確認します。

Error

Object

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

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

KeyVaultError

Object

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

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

Permission

Object

ロール定義のアクセス許可。

名前	型	説明
actions	string[]	付与されるアクションのアクセス許可。
dataActions	DataAction[]	付与されるデータ アクションのアクセス許可。
notActions	string[]	除外されているが拒否されないアクションのアクセス許可。 プリンシパルに割り当てられている他のロール定義によって付与される場合があります。
notDataActions	DataAction[]	除外されているが拒否されないデータ アクションのアクセス許可。 プリンシパルに割り当てられている他のロール定義によって付与される場合があります。

RoleDefinition

Object

ロールの定義。

名前	型	説明
id	string	ロール定義 ID。
name	string	ロール定義名。
properties.assignableScopes	RoleScope[]	ロール定義の割り当て可能なスコープ。
properties.description	string	ロール定義の説明。
properties.permissions	Permission[]	ロール定義のアクセス許可。
properties.roleName	string	ロール名。
properties.type	RoleType	ロールの種類。
type	RoleDefinitionType	ロール定義の種類。

RoleDefinitionCreateParameters

Object

ロール定義によってパラメーターが作成されます。

名前	型	説明
properties	RoleDefinitionProperties	ロール定義プロパティ。

RoleDefinitionProperties

Object

ロール定義プロパティ。

名前	型	説明
assignableScopes	RoleScope[]	ロール定義の割り当て可能なスコープ。
description	string	ロール定義の説明。
permissions	Permission[]	ロール定義のアクセス許可。
roleName	string	ロール名。
type	RoleType	ロールの種類。

RoleDefinitionType

列挙

ロール定義の種類。

値	説明
Microsoft.Authorization/roleDefinitions

RoleScope

列挙

ロール スコープ。

値	説明
/	グローバル スコープ
/keys	キースコープ

RoleType

列挙

ロールの種類。

値	説明
AKVBuiltInRole	組み込みロール。
CustomRole	カスタム ロール。