Role Assignments - List For Scope

Servicio:

Key Vault

Versión de la API:

2025-07-01

Obtiene asignaciones de roles para un ámbito.

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

Con parámetros opcionales:

GET {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleAssignments?api-version=2025-07-01&$filter={$filter}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
scope	path	True	string	El ámbito de las asignaciones de funciones.
vaultBaseUrl	path	True	string (uri)	La URL base de la instancia de Key Vault (por ejemplo, https://myvault.vault.azure.net/)
api-version	query	True	string minLength: 1	Versión de API que se usará para esta operación.
$filter	query		string	Filtro que se va a aplicar en la operación. Use $filter=atScope() para devolver todas las asignaciones de funciones en el ámbito o por encima de él. Use $filter=principalId eq {id} para devolver todas las asignaciones de roles en, por encima o por debajo del ámbito de la entidad de seguridad especificada.

Respuestas

Nombre	Tipo	Description
200 OK	RoleAssignmentListResult	La solicitud se ha realizado correctamente.
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

Get role assignments for a scope

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:

200

{
  "value": [
    {
      "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
RoleAssignmentListResult	Resultado de la operación de lista de asignación de roles.
RoleAssignmentPropertiesWithScope	Propiedades de asignación de roles con ámbito.
RoleScope	Ámbito del rol.

Error

Objeto

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

Objeto

Excepción de error de Key Vault.

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

RoleAssignment

Objeto

Asignaciones de roles

Nombre	Tipo	Description
id	string	Identificador de la 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.

RoleAssignmentListResult

Objeto

Resultado de la operación de lista de asignación de roles.

Nombre	Tipo	Description
nextLink	string	Dirección URL que se va a usar para obtener el siguiente conjunto de resultados.
value	RoleAssignment[]	Lista de asignación de roles.

RoleAssignmentPropertiesWithScope

Objeto

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	Ámbito del rol.

RoleScope

Enumeración

Ámbito del rol.

Valor	Description
/	Ámbito global
/keys	Ámbito de claves