Role Assignments - Create

Referenz

Dienst:: Key Vault

API-Version:: 7.4

Erstellt eine Rollenzuweisung.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
roleAssignmentName	path	True	string	Der Name der zu erstellenden Rollenzuweisung. Es kann sich um eine beliebige gültige GUID sein.
scope	path	True	string	Der Bereich der zu erstellenden Rollenzuweisung.
vaultBaseUrl	path	True	string	Der Tresorname, z. B https://myvault.vault.azure.net. .
api-version	query	True	string	Client-API-Version.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
properties	True	RoleAssignmentProperties	Rollenzuweisungseigenschaften.

Antworten

Name	Typ	Beschreibung
201 Created	RoleAssignment	Erstellt: Gibt Informationen zur Rollenzuweisung zurück.
Other Status Codes	KeyVaultError	Key Vault Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

PutRoleAssignments

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name	Beschreibung
Error	Der Schlüsseltresorserverfehler.
KeyVaultError	Die Schlüsseltresorfehler-Ausnahme.
RoleAssignment	Rollenzuweisungen
RoleAssignmentCreateParameters	Erstellungsparameter für Rollenzuweisungen.
RoleAssignmentProperties	Rollenzuweisungseigenschaften.
RoleAssignmentPropertiesWithScope	Rollenzuweisungseigenschaften mit Bereich.
RoleScope	Der Rollenbereich.

Error

Der Schlüsseltresorserverfehler.

Name	Typ	Beschreibung
code	string	Der Fehlercode.
innererror	Error	Der Schlüsseltresorserverfehler.
message	string	Die Fehlermeldung.

KeyVaultError

Die Schlüsseltresorfehler-Ausnahme.

Name	Typ	Beschreibung
error	Error	Der Schlüsseltresorserverfehler.

RoleAssignment

Rollenzuweisungen

Name	Typ	Beschreibung
id	string	Hierbei handelt es sich um die Rollenzuweisungs-ID.
name	string	Der Name der Rollenzuweisung.
properties	RoleAssignmentPropertiesWithScope	Rollenzuweisungseigenschaften.
type	string	Der Rollenzuweisungstyp.

RoleAssignmentCreateParameters

Erstellungsparameter für Rollenzuweisungen.

Name	Typ	Beschreibung
properties	RoleAssignmentProperties	Rollenzuweisungseigenschaften.

RoleAssignmentProperties

Rollenzuweisungseigenschaften.

Name	Typ	Beschreibung
principalId	string	Die der Rolle zugewiesene Prinzipal-ID. Dies wird der ID innerhalb von Active Directory zugeordnet. Sie kann auf einen Benutzer, einen Dienstprinzipal oder eine Sicherheitsgruppe verweisen.
roleDefinitionId	string	Die in der Rollenzuweisung verwendete Rollendefinitions-ID.

RoleAssignmentPropertiesWithScope

Rollenzuweisungseigenschaften mit Bereich.

Name	Typ	Beschreibung
principalId	string	Die Prinzipal-ID.
roleDefinitionId	string	Hierbei handelt es sich um die Rollendefinitions-ID.
scope	RoleScope	Der Rollenbereich.

RoleScope

Der Rollenbereich.

Name	Typ	Beschreibung
/	string	Globaler Bereich
/keys	string	Schlüsselbereich

Freigeben über