Compartir a través de


Role Assignments - List For Scope

Obtiene las asignaciones de roles de un ámbito.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
scope
path True

string

Ámbito de las asignaciones de roles.

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.

$filter
query

string

Filtro que se va a aplicar en la operación. Use $filter=atScope() para devolver todas las asignaciones de roles en o por encima del ámbito. 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

Aceptar: devuelve una matriz de asignaciones de roles.

Other Status Codes

KeyVaultError

Key Vault respuesta de error que describe por qué se produjo un error en la operación.

Ejemplos

ListRoleAssignments

Solicitud de ejemplo

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

Respuesta de muestra

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

Error del servidor del almacén de claves.

KeyVaultError

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

RoleAssignment

Asignaciones de roles

RoleAssignmentListResult

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

RoleAssignmentPropertiesWithScope

Propiedades de asignación de roles con ámbito.

RoleScope

Ámbito de 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

El nombre de la asignación de roles.

properties

RoleAssignmentPropertiesWithScope

Propiedades de asignación de roles.

type

string

Tipo de asignación de roles.

RoleAssignmentListResult

Resultado de la operación de la lista de asignaciones 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 asignaciones 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 de rol.

RoleScope

Ámbito de rol.

Nombre Tipo Description
/

string

Ámbito global

/keys

string

Ámbito de claves