Role Definitions - Delete

Služba:

Key Vault

Verze rozhraní API:

7.4

Odstraní definici vlastní role.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
roleDefinitionName	path	True	string	Název (GUID) definice role, která se má odstranit.
scope	path	True	string	Rozsah definice role, která se má odstranit. Managed HSM podporuje pouze /.
vaultBaseUrl	path	True	string	Název trezoru, například https://myvault.vault.azure.net.
api-version	query	True	string	Verze rozhraní API klienta.

Odpovědi

Name	Typ	Description
200 OK	RoleDefinition	OK – Vrátí informace o odstraněné definici role.
Other Status Codes	KeyVaultError	Odpověď na chybu služby Key Vault popisující, proč operace selhala.

Příklady

DeleteRoleDefinition

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:

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

Definice

Name	Description
DataAction	Podporovaná oprávnění pro akce dat
Error	Chyba serveru trezoru klíčů.
KeyVaultError	Výjimka chyby trezoru klíčů.
Permission	Oprávnění k definici role
RoleDefinition	Definice role
RoleDefinitionType	Typ definice role.
RoleScope	Obor role.
RoleType	Typ role.

DataAction

Výčet

Podporovaná oprávnění pro akce dat

Hodnota	Description
Microsoft.KeyVault/managedHsm/backup/start/action	Spusťte zálohu HSM.
Microsoft.KeyVault/managedHsm/backup/status/action	Přečtěte si stav zálohování HSM.
Microsoft.KeyVault/managedHsm/keys/backup/action	Zálohování klíčů HSM
Microsoft.KeyVault/managedHsm/keys/create	Vytvořte klíč HSM.
Microsoft.KeyVault/managedHsm/keys/decrypt/action	Dešifrování pomocí klíče HSM
Microsoft.KeyVault/managedHsm/keys/delete	Odstraňte klíč HSM.
Microsoft.KeyVault/managedHsm/keys/deletedKeys/delete	Vyprázdnění odstraněného klíče HSM
Microsoft.KeyVault/managedHsm/keys/deletedKeys/read/action	Čtení odstraněného klíče HSM
Microsoft.KeyVault/managedHsm/keys/deletedKeys/recover/action	Obnovení odstraněného klíče HSM
Microsoft.KeyVault/managedHsm/keys/encrypt/action	Šifrování pomocí klíče HSM
Microsoft.KeyVault/managedHsm/keys/export/action	Export klíče HSM
Microsoft.KeyVault/managedHsm/keys/import/action	Importujte klíč HSM.
Microsoft.KeyVault/managedHsm/keys/read/action	Čtení metadat klíčů HSM
Microsoft.KeyVault/managedHsm/keys/release/action	Uvolněte klíč HSM pomocí funkce Secure Key Release.
Microsoft.KeyVault/managedHsm/keys/restore/action	Obnovte klíče HSM.
Microsoft.KeyVault/managedHsm/keys/sign/action	Podepište se pomocí klíče HSM.
Microsoft.KeyVault/managedHsm/keys/unwrap/action	Rozbalte ho pomocí klíče HSM.
Microsoft.KeyVault/managedHsm/keys/verify/action	Ověřte použití klíče HSM.
Microsoft.KeyVault/managedHsm/keys/wrap/action	Zabalení pomocí klíče HSM
Microsoft.KeyVault/managedHsm/keys/write/action	Aktualizujte klíč HSM.
Microsoft.KeyVault/managedHsm/restore/start/action	Spusťte obnovení HSM.
Microsoft.KeyVault/managedHsm/restore/status/action	Přečtěte si stav obnovení HSM.
Microsoft.KeyVault/managedHsm/rng/action	Vygenerujte náhodná čísla.
Microsoft.KeyVault/managedHsm/roleAssignments/delete/action	Odstraňte přiřazení role.
Microsoft.KeyVault/managedHsm/roleAssignments/read/action	Získání přiřazení role
Microsoft.KeyVault/managedHsm/roleAssignments/write/action	Vytvoření nebo aktualizace přiřazení role
Microsoft.KeyVault/managedHsm/roleDefinitions/delete/action	Odstraňte definici role.
Microsoft.KeyVault/managedHsm/roleDefinitions/read/action	Získejte definici role.
Microsoft.KeyVault/managedHsm/roleDefinitions/write/action	Vytvoření nebo aktualizace definice role
Microsoft.KeyVault/managedHsm/securitydomain/download/action	Stáhněte si doménu zabezpečení HSM.
Microsoft.KeyVault/managedHsm/securitydomain/download/read	Zkontrolujte stav stahování domény zabezpečení HSM.
Microsoft.KeyVault/managedHsm/securitydomain/transferkey/read	Stáhněte si klíč pro přenos domény zabezpečení HSM.
Microsoft.KeyVault/managedHsm/securitydomain/upload/action	Nahrajte doménu zabezpečení HSM.
Microsoft.KeyVault/managedHsm/securitydomain/upload/read	Zkontrolujte stav souboru exchange domény zabezpečení HSM.

Error

Objekt

Chyba serveru trezoru klíčů.

Name	Typ	Description
code	string	Kód chyby.
innererror	Error	Chyba serveru trezoru klíčů.
message	string	Chybová zpráva.

KeyVaultError

Objekt

Výjimka chyby trezoru klíčů.

Name	Typ	Description
error	Error	Chyba serveru trezoru klíčů.

Permission

Objekt

Oprávnění k definici role

Name	Typ	Description
actions	string[]	Oprávnění akce, která jsou udělena.
dataActions	DataAction[]	Oprávnění k akci dat, která jsou udělena.
notActions	string[]	Oprávnění akce, která jsou vyloučena, ale nejsou odepřena. Mohou být uděleny jinými definicemi rolí přiřazenými k objektu zabezpečení.
notDataActions	DataAction[]	Oprávnění akce dat, která jsou vyloučena, ale nejsou odepřena. Mohou být uděleny jinými definicemi rolí přiřazenými k objektu zabezpečení.

RoleDefinition

Objekt

Definice role

Name	Typ	Description
id	string	ID definice role.
name	string	Název definice role.
properties.assignableScopes	RoleScope[]	Přiřaditelné obory definice role.
properties.description	string	Popis definice role.
properties.permissions	Permission[]	Oprávnění k definici role
properties.roleName	string	Název role.
properties.type	RoleType	Typ role.
type	RoleDefinitionType	Typ definice role.

RoleDefinitionType

Výčet

Typ definice role.

Hodnota	Description
Microsoft.Authorization/roleDefinitions

RoleScope

Výčet

Obor role.

Hodnota	Description
/	Globální obor
/keys	Rozsah klíčů

RoleType

Výčet

Typ role.

Hodnota	Description
AKVBuiltInRole	Předdefinované role
CustomRole	Vlastní role.