Role Assignments - Create

Usługa:

Key Vault

Wersja interfejsu API:

7.4

Tworzy przypisanie roli.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
roleAssignmentName	path	True	string	Nazwa przypisania roli do utworzenia. Może to być dowolny prawidłowy identyfikator GUID.
scope	path	True	string	Zakres przypisania roli do utworzenia.
vaultBaseUrl	path	True	string	Nazwa magazynu, na przykład https://myvault.vault.azure.net.
api-version	query	True	string	Wersja interfejsu API klienta.

Treść żądania

Nazwa	Wymagane	Typ	Opis
properties	True	RoleAssignmentProperties	Właściwości przypisania roli.

Odpowiedzi

Nazwa	Typ	Opis
201 Created	RoleAssignment	Created — zwraca informacje o przypisaniu roli.
Other Status Codes	KeyVaultError	Key Vault odpowiedzi na błąd opisujący, dlaczego operacja nie powiodła się.

Przykłady

PutRoleAssignments

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Definicje

Nazwa	Opis
Error	Błąd serwera magazynu kluczy.
KeyVaultError	Wyjątek błędu magazynu kluczy.
RoleAssignment	Przypisania ról
RoleAssignmentCreateParameters	Tworzenie parametrów przypisania roli.
RoleAssignmentProperties	Właściwości przypisania roli.
RoleAssignmentPropertiesWithScope	Właściwości przypisania roli z zakresem.
RoleScope	Zakres roli.

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.

RoleAssignment

Przypisania ról

Nazwa	Typ	Opis
id	string	Identyfikator przypisania roli.
name	string	Nazwa przypisania roli.
properties	RoleAssignmentPropertiesWithScope	Właściwości przypisania roli.
type	string	Typ przypisania roli.

RoleAssignmentCreateParameters

Tworzenie parametrów przypisania roli.

Nazwa	Typ	Opis
properties	RoleAssignmentProperties	Właściwości przypisania roli.

RoleAssignmentProperties

Właściwości przypisania roli.

Nazwa	Typ	Opis
principalId	string	Identyfikator podmiotu zabezpieczeń przypisany do roli. To mapuje identyfikator w usłudze Active Directory. Może wskazywać użytkownika, jednostkę usługi lub grupę zabezpieczeń.
roleDefinitionId	string	Identyfikator definicji roli używany w przypisaniu roli.

RoleAssignmentPropertiesWithScope

Właściwości przypisania roli z zakresem.

Nazwa	Typ	Opis
principalId	string	Identyfikator podmiotu zabezpieczeń.
roleDefinitionId	string	Identyfikator definicji roli.
scope	RoleScope	Zakres roli.

RoleScope

Zakres roli.

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