Udostępnij przez

Role Assignments - Create

Usługa:
Key Vault
Wersja interfejsu API:
2025-07-01

Tworzy przypisanie roli.

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

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 (uri)

api-version
 query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa Wymagane Typ Opis
properties True

RoleAssignmentProperties

Właściwości przypisania roli.

Odpowiedzi

Nazwa Typ Opis
201 Created

RoleAssignment

Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.
Other Status Codes

KeyVaultError

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

OAuth2Auth

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
https://vault.azure.net/.default

Przykłady

Create a role assignment

Przykładowe żądanie

PUT https://myvault.vault.azure.net//keys/providers/Microsoft.Authorization/roleAssignments/roleAssignmentName?api-version=2025-07-01

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

Wyjątek błędu magazynu kluczy.
RoleAssignment

Przypisania ról
RoleAssignmentCreateParameters

Przypisanie roli tworzy parametry.
RoleAssignmentProperties

Właściwości przypisania roli.
RoleAssignmentPropertiesWithScope

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

Zakres roli.

Error

Objekt
Nazwa Typ Opis
code

string

Kod błędu.
innererror

Error

Błąd serwera magazynu kluczy.
message

string

Komunikat o błędzie.

KeyVaultError

Objekt

Wyjątek błędu magazynu kluczy.

Nazwa Typ Opis
error

Error

Błąd serwera magazynu kluczy.

RoleAssignment

Objekt

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

Objekt

Przypisanie roli tworzy parametry.

Nazwa Typ Opis
properties

RoleAssignmentProperties

Właściwości przypisania roli.

RoleAssignmentProperties

Objekt

Właściwości przypisania roli.

Nazwa Typ Opis
principalId

string

Identyfikator podmiotu zabezpieczeń przypisany do roli. Spowoduje to mapowania na identyfikator wewnątrz usługi Active Directory. Może wskazywać użytkownika, jednostkę usługi lub grupę zabezpieczeń.
roleDefinitionId

string

Identyfikator definicji roli używany w przypisaniu roli.

RoleAssignmentPropertiesWithScope

Objekt

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

Wyliczanie

Zakres roli.

Wartość Opis
/

Globalny zasięg
/keys

Zakres kluczy