Compartir a través de

Role Assignments - Create

Servicio:
Key Vault
Versión de la API:
2025-07-01

Crea una asignación de roles.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
roleAssignmentName
 path True

string

Nombre de la asignación de roles que se va a crear. Puede ser cualquier GUID válido.
scope
 path True

string

El ámbito de la asignación de roles que se va a crear.
vaultBaseUrl
 path True

string (uri)

api-version
 query True

string

minLength: 1

Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
properties True

RoleAssignmentProperties

Propiedades de asignación de roles.

Respuestas

Nombre Tipo Description
201 Created

RoleAssignment

La solicitud se ha realizado correctamente y se ha creado un nuevo recurso como resultado.
Other Status Codes

KeyVaultError

Una respuesta de error inesperada.

Seguridad

OAuth2Auth

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
https://vault.azure.net/.default

Ejemplos

Create a role assignment

Solicitud de ejemplo

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

Respuesta de muestra

status code:
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"
}

Definiciones

Nombre Description
Error
KeyVaultError

Excepción de error de Key Vault.
RoleAssignment

Asignaciones de roles
RoleAssignmentCreateParameters

Parámetros de creación de asignación de roles.
RoleAssignmentProperties

Propiedades de asignación de roles.
RoleAssignmentPropertiesWithScope

Propiedades de asignación de roles con ámbito.
RoleScope

El ámbito de la función.

Error

Object
Nombre Tipo Description
code

string

Código de error.
innererror

Error

El error del servidor del almacén de claves.
message

string

El mensaje de error.

KeyVaultError

Object

Excepción de error de Key Vault.

Nombre Tipo Description
error

Error

El error del servidor del almacén de claves.

RoleAssignment

Object

Asignaciones de roles

Nombre Tipo Description
id

string

El identificador de asignación de roles.
name

string

El nombre de la asignación de roles.
properties

RoleAssignmentPropertiesWithScope

Propiedades de asignación de roles.
type

string

El tipo de asignación de roles.

RoleAssignmentCreateParameters

Object

Parámetros de creación de asignación de roles.

Nombre Tipo Description
properties

RoleAssignmentProperties

Propiedades de asignación de roles.

RoleAssignmentProperties

Object

Propiedades de asignación de roles.

Nombre Tipo Description
principalId

string

Identificador de entidad de seguridad asignado al rol. Esto se asigna al identificador dentro de Active Directory. Puede apuntar a un usuario, una entidad de servicio o un grupo de seguridad.
roleDefinitionId

string

Identificador de definición de roles usado en la asignación de roles.

RoleAssignmentPropertiesWithScope

Object

Propiedades de asignación de roles con ámbito.

Nombre Tipo Description
principalId

string

Identificador de entidad de seguridad.
roleDefinitionId

string

Identificador de definición de rol.
scope

RoleScope

El ámbito de la función.

RoleScope

Enumeración

El ámbito de la función.

Valor Description
/

Alcance global
/keys

Ámbito de claves