Role Assignments - Create

Riferimento

Servizio:: Key Vault

Versione API:: 7.4

Crea un'assegnazione di ruolo.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
roleAssignmentName	path	True	string	Nome dell'assegnazione di ruolo da creare. Può essere qualsiasi GUID valido.
scope	path	True	string	Ambito dell'assegnazione di ruolo da creare.
vaultBaseUrl	path	True	string	Nome dell'insieme di credenziali, ad esempio https://myvault.vault.azure.net.
api-version	query	True	string	Versione API client.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
properties	True	RoleAssignmentProperties	Proprietà dell'assegnazione di ruolo.

Risposte

Nome	Tipo	Descrizione
201 Created	RoleAssignment	Creato: restituisce informazioni sull'assegnazione di ruolo.
Other Status Codes	KeyVaultError	Key Vault risposta di errore che descrive perché l'operazione non è riuscita.

Esempio

PutRoleAssignments

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
}

Definizioni

Nome	Descrizione
Error	Errore del server dell'insieme di credenziali delle chiavi.
KeyVaultError	Eccezione di errore dell'insieme di credenziali delle chiavi.
RoleAssignment	Assegnazioni di ruoli
RoleAssignmentCreateParameters	L'assegnazione di ruolo crea parametri.
RoleAssignmentProperties	Proprietà dell'assegnazione di ruolo.
RoleAssignmentPropertiesWithScope	Proprietà dell'assegnazione di ruoli con ambito.
RoleScope	Ambito del ruolo.

Error

Errore del server dell'insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
code	string	Codice di errore.
innererror	Error	Errore del server dell'insieme di credenziali delle chiavi.
message	string	Messaggio di errore.

KeyVaultError

Eccezione di errore dell'insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
error	Error	Errore del server dell'insieme di credenziali delle chiavi.

RoleAssignment

Assegnazioni di ruoli

Nome	Tipo	Descrizione
id	string	ID assegnazione di ruolo.
name	string	Nome dell'assegnazione di ruolo.
properties	RoleAssignmentPropertiesWithScope	Proprietà dell'assegnazione di ruolo.
type	string	Tipo di assegnazione di ruolo.

RoleAssignmentCreateParameters

L'assegnazione di ruolo crea parametri.

Nome	Tipo	Descrizione
properties	RoleAssignmentProperties	Proprietà dell'assegnazione di ruolo.

RoleAssignmentProperties

Proprietà dell'assegnazione di ruolo.

Nome	Tipo	Descrizione
principalId	string	ID principale assegnato al ruolo. Viene eseguito il mapping all'ID all'interno di Active Directory. Può puntare a un utente, a un'entità servizio o a un gruppo di sicurezza.
roleDefinitionId	string	ID definizione del ruolo usato nell'assegnazione di ruolo.

RoleAssignmentPropertiesWithScope

Proprietà dell'assegnazione di ruoli con ambito.

Nome	Tipo	Descrizione
principalId	string	ID principale.
roleDefinitionId	string	ID definizione del ruolo.
scope	RoleScope	Ambito del ruolo.

RoleScope

Ambito del ruolo.

Nome	Tipo	Descrizione
/	string	Ambito globale
/keys	string	Ambito chiavi

Condividi tramite