Role Definitions - Delete

服務:

Key Vault

API 版本:

7.4

刪除自定義角色定義。

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

URI 參數

名稱	位於	必要	類型	Description
roleDefinitionName	path	True	string	要刪除的角色定義名稱 （GUID）。
scope	path	True	string	要刪除的角色定義範圍。 受控 HSM 僅支援 『/』。
vaultBaseUrl	path	True	string	儲存庫名稱，例如 https://myvault.vault.azure.net。
api-version	query	True	string	用戶端 API 版本。

回應

名稱	類型	Description
200 OK	RoleDefinition	確定 - 傳回已刪除之角色定義的相關信息。
Other Status Codes	KeyVaultError	Key Vault 錯誤回應，描述作業失敗的原因。

範例

DeleteRoleDefinition

範例要求

HTTP

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

範例回覆

狀態碼:

200

{
  "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"
}

定義

名稱	Description
DataAction	數據動作的支持許可權。
Error	金鑰儲存庫伺服器錯誤。
KeyVaultError	金鑰保存庫錯誤例外狀況。
Permission	角色定義許可權。
RoleDefinition	角色定義。
RoleDefinitionType	角色定義類型。
RoleScope	角色範圍。
RoleType	角色類型。

DataAction

列舉型別

數據動作的支持許可權。

值	Description
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	使用安全金鑰版本釋放 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

金鑰儲存庫伺服器錯誤。

名稱	類型	Description
code	string	錯誤碼。
innererror	Error	金鑰儲存庫伺服器錯誤。
message	string	錯誤訊息。

KeyVaultError

Object

金鑰保存庫錯誤例外狀況。

名稱	類型	Description
error	Error	金鑰儲存庫伺服器錯誤。

Permission

Object

角色定義許可權。

名稱	類型	Description
actions	string[]	授與的動作許可權。
dataActions	DataAction[]	授與的數據動作許可權。
notActions	string[]	已排除但未拒絕的動作許可權。 指派給主體的其他角色定義可能會授與它們。
notDataActions	DataAction[]	排除但未拒絕的數據動作許可權。 指派給主體的其他角色定義可能會授與它們。

RoleDefinition

Object

角色定義。

名稱	類型	Description
id	string	角色定義標識碼。
name	string	角色定義名稱。
properties.assignableScopes	RoleScope[]	角色定義可指派的範圍。
properties.description	string	角色定義描述。
properties.permissions	Permission[]	角色定義許可權。
properties.roleName	string	角色名稱。
properties.type	RoleType	角色類型。
type	RoleDefinitionType	角色定義類型。

RoleDefinitionType

列舉型別

角色定義類型。

值	Description
Microsoft.Authorization/roleDefinitions

RoleScope

列舉型別

角色範圍。

值	Description
/	全域範圍
/keys	索引鍵範圍

RoleType

列舉型別

角色類型。

值	Description
AKVBuiltInRole	內建角色。
CustomRole	自訂角色。