Role Assignments - Create

Servicio:

Key Vault

Versión de la API:

7.4

Crea una asignación de roles.

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

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	Ámbito de la asignación de roles que se va a crear.
vaultBaseUrl	path	True	string	El nombre del almacén, por ejemplo https://myvault.vault.azure.net, .
api-version	query	True	string	Versión de API del cliente.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
properties	True	RoleAssignmentProperties	Propiedades de asignación de roles.

Respuestas

Nombre	Tipo	Description
201 Created	RoleAssignment	Creado: devuelve información sobre la asignación de roles.
Other Status Codes	KeyVaultError	Key Vault respuesta de error que describe por qué se produjo un error en la operación.

Ejemplos

PutRoleAssignments

Solicitud de ejemplo

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

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	Error del servidor del almacén de claves.
KeyVaultError	Excepción de error del almacén de claves.
RoleAssignment	Asignaciones de roles
RoleAssignmentCreateParameters	Creación de parámetros de asignación de roles.
RoleAssignmentProperties	Propiedades de asignación de roles.
RoleAssignmentPropertiesWithScope	Propiedades de asignación de roles con ámbito.
RoleScope	Ámbito del rol.

Error

Error del servidor del almacén de claves.

Nombre	Tipo	Description
code	string	Código de error.
innererror	Error	Error del servidor del almacén de claves.
message	string	El mensaje de error.

KeyVaultError

Excepción de error del almacén de claves.

Nombre	Tipo	Description
error	Error	Error del servidor del almacén de claves.

RoleAssignment

Asignaciones de roles

Nombre	Tipo	Description
id	string	Identificador de la asignación de roles.
name	string	Nombre de asignación de roles.
properties	RoleAssignmentPropertiesWithScope	Propiedades de asignación de roles.
type	string	Tipo de asignación de roles.

RoleAssignmentCreateParameters

Creación de parámetros de asignación de roles.

Nombre	Tipo	Description
properties	RoleAssignmentProperties	Propiedades de asignación de roles.

RoleAssignmentProperties

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 rol usado en la asignación de roles.

RoleAssignmentPropertiesWithScope

Propiedades de asignación de roles con ámbito.

Nombre	Tipo	Description
principalId	string	Identificador de entidad de seguridad.
roleDefinitionId	string	Identificador de la definición de roles.
scope	RoleScope	Ámbito del rol.

RoleScope

Ámbito del rol.

Nombre	Tipo	Description
/	string	Ámbito global
/keys	string	Ámbito de claves