Role Definitions - Delete

Usługa:

Key Vault

Wersja interfejsu API:

7.4

Usuwa definicję roli niestandardowej.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
roleDefinitionName	path	True	string	Nazwa (GUID) definicji roli do usunięcia.
scope	path	True	string	Zakres definicji roli do usunięcia. Zarządzany moduł HSM obsługuje tylko element "/".
vaultBaseUrl	path	True	string	Nazwa magazynu, na przykład https://myvault.vault.azure.net.
api-version	query	True	string	Wersja interfejsu API klienta.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	RoleDefinition	OK — zwraca informacje o definicji roli, która została usunięta.
Other Status Codes	KeyVaultError	Key Vault odpowiedzi na błąd opisujący, dlaczego operacja nie powiodła się.

Przykłady

DeleteRoleDefinition

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:

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

Definicje

Nazwa	Opis
DataAction	Obsługiwane uprawnienia dla akcji danych.
Error	Błąd serwera magazynu kluczy.
KeyVaultError	Wyjątek błędu magazynu kluczy.
Permission	Uprawnienia definicji roli.
RoleDefinition	Definicja roli.
RoleDefinitionType	Typ definicji roli.
RoleScope	Zakres roli.
RoleType	Typ roli.

DataAction

Obsługiwane uprawnienia dla akcji danych.

Nazwa	Typ	Opis
Microsoft.KeyVault/managedHsm/backup/start/action	string	Uruchom kopię zapasową modułu HSM.
Microsoft.KeyVault/managedHsm/backup/status/action	string	Odczytywanie stanu kopii zapasowej modułu HSM.
Microsoft.KeyVault/managedHsm/keys/backup/action	string	Tworzenie kopii zapasowych kluczy HSM.
Microsoft.KeyVault/managedHsm/keys/create	string	Utwórz klucz HSM.
Microsoft.KeyVault/managedHsm/keys/decrypt/action	string	Odszyfrowywanie przy użyciu klucza HSM.
Microsoft.KeyVault/managedHsm/keys/delete	string	Usuń klucz HSM.
Microsoft.KeyVault/managedHsm/keys/deletedKeys/delete	string	Przeczyść usunięty klucz HSM.
Microsoft.KeyVault/managedHsm/keys/deletedKeys/read/action	string	Odczyt usuniętego klucza modułu HSM.
Microsoft.KeyVault/managedHsm/keys/deletedKeys/recover/action	string	Odzyskaj usunięty klucz HSM.
Microsoft.KeyVault/managedHsm/keys/encrypt/action	string	Szyfrowanie przy użyciu klucza HSM.
Microsoft.KeyVault/managedHsm/keys/export/action	string	Wyeksportuj klucz HSM.
Microsoft.KeyVault/managedHsm/keys/import/action	string	Zaimportuj klucz HSM.
Microsoft.KeyVault/managedHsm/keys/read/action	string	Odczytywanie metadanych klucza modułu HSM.
Microsoft.KeyVault/managedHsm/keys/release/action	string	Zwolnij klucz HSM przy użyciu bezpiecznego wydania klucza.
Microsoft.KeyVault/managedHsm/keys/restore/action	string	Przywracanie kluczy HSM.
Microsoft.KeyVault/managedHsm/keys/sign/action	string	Podpisywanie przy użyciu klucza HSM.
Microsoft.KeyVault/managedHsm/keys/unwrap/action	string	Odpakuj przy użyciu klucza HSM.
Microsoft.KeyVault/managedHsm/keys/verify/action	string	Sprawdź przy użyciu klucza HSM.
Microsoft.KeyVault/managedHsm/keys/wrap/action	string	Zawijaj przy użyciu klucza HSM.
Microsoft.KeyVault/managedHsm/keys/write/action	string	Zaktualizuj klucz HSM.
Microsoft.KeyVault/managedHsm/restore/start/action	string	Uruchom przywracanie modułu HSM.
Microsoft.KeyVault/managedHsm/restore/status/action	string	Odczytywanie stanu przywracania modułu HSM.
Microsoft.KeyVault/managedHsm/rng/action	string	Generowanie liczb losowych.
Microsoft.KeyVault/managedHsm/roleAssignments/delete/action	string	Usuń przypisanie roli.
Microsoft.KeyVault/managedHsm/roleAssignments/read/action	string	Pobierz przypisanie roli.
Microsoft.KeyVault/managedHsm/roleAssignments/write/action	string	Tworzenie lub aktualizowanie przypisania roli.
Microsoft.KeyVault/managedHsm/roleDefinitions/delete/action	string	Usuń definicję roli.
Microsoft.KeyVault/managedHsm/roleDefinitions/read/action	string	Pobierz definicję roli.
Microsoft.KeyVault/managedHsm/roleDefinitions/write/action	string	Tworzenie lub aktualizowanie definicji roli.
Microsoft.KeyVault/managedHsm/securitydomain/download/action	string	Pobierz domenę zabezpieczeń modułu HSM.
Microsoft.KeyVault/managedHsm/securitydomain/download/read	string	Sprawdź stan pobierania domeny zabezpieczeń modułu HSM.
Microsoft.KeyVault/managedHsm/securitydomain/transferkey/read	string	Pobierz klucz transferu domeny zabezpieczeń modułu HSM.
Microsoft.KeyVault/managedHsm/securitydomain/upload/action	string	Przekaż domenę zabezpieczeń modułu HSM.
Microsoft.KeyVault/managedHsm/securitydomain/upload/read	string	Sprawdź stan pliku wymiany domeny zabezpieczeń modułu HSM.

Error

Błąd serwera magazynu kluczy.

Nazwa	Typ	Opis
code	string	Kod błędu.
innererror	Error	Błąd serwera magazynu kluczy.
message	string	Komunikat o błędzie.

KeyVaultError

Wyjątek błędu magazynu kluczy.

Nazwa	Typ	Opis
error	Error	Błąd serwera magazynu kluczy.

Permission

Uprawnienia definicji roli.

Nazwa	Typ	Opis
actions	string[]	Przyznane uprawnienia akcji.
dataActions	DataAction[]	Przyznane uprawnienia akcji danych.
notActions	string[]	Uprawnienia akcji, które są wykluczone, ale nie zostały odrzucone. Mogą one być przyznawane przez inne definicje ról przypisane do podmiotu zabezpieczeń.
notDataActions	DataAction[]	Uprawnienia akcji danych, które są wykluczone, ale nie zostały odrzucone. Mogą one być przyznawane przez inne definicje ról przypisane do podmiotu zabezpieczeń.

RoleDefinition

Definicja roli.

Nazwa	Typ	Opis
id	string	Identyfikator definicji roli.
name	string	Nazwa definicji roli.
properties.assignableScopes	RoleScope[]	Zakresy możliwe do przypisania definicji roli.
properties.description	string	Opis definicji roli.
properties.permissions	Permission[]	Uprawnienia definicji roli.
properties.roleName	string	Nazwa roli.
properties.type	RoleType	Typ roli.
type	RoleDefinitionType	Typ definicji roli.

RoleDefinitionType

Typ definicji roli.

Nazwa	Typ	Opis
Microsoft.Authorization/roleDefinitions	string

RoleScope

Zakres roli.

Nazwa	Typ	Opis
/	string	Zakres globalny
/keys	string	Zakres kluczy

RoleType

Typ roli.

Nazwa	Typ	Opis
AKVBuiltInRole	string	Wbudowana rola.
CustomRole	string	Rola niestandardowa.