Compartir a través de


Role Definitions - Get

Obtiene la definición de roles por nombre (GUID).

GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleDefinitions/{roleDefinitionId}?api-version=2022-04-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
roleDefinitionId
path True

string

Identificador de la definición de roles.

scope
path True

string

Ámbito de la definición de roles.

api-version
query True

string

Versión de API que se usará para la operación.

Respuestas

Nombre Tipo Description
200 OK

RoleDefinition

Aceptar: devuelve información sobre la definición de roles.

Other Status Codes

ErrorResponse

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

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

Ámbitos

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

Get role definition by name

Solicitud de ejemplo

GET https://management.azure.com/scope/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId?api-version=2022-04-01

Respuesta de muestra

{
  "properties": {
    "roleName": "Role name",
    "type": "roletype",
    "description": "Role description",
    "assignableScopes": [
      "/subscriptions/subId"
    ],
    "permissions": [
      {
        "actions": [
          "action"
        ],
        "notActions": [],
        "dataActions": [
          "dataAction"
        ],
        "notDataActions": []
      }
    ]
  },
  "id": "/subscriptions/subID/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
  "type": "Microsoft.Authorization/roleDefinitions",
  "name": "roleDefinitionId"
}

Definiciones

Nombre Description
ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

Permission

Permisos de definición de roles.

RoleDefinition

Definición de roles.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Los detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

Permission

Permisos de definición de roles.

Nombre Tipo Description
actions

string[]

Acciones permitidas.

dataActions

string[]

Acciones de datos permitidas.

notActions

string[]

Acciones denegadas.

notDataActions

string[]

Acciones de datos denegadas.

RoleDefinition

Definición de roles.

Nombre Tipo Description
id

string

Identificador de la definición de roles.

name

string

Nombre de la definición de rol.

properties.assignableScopes

string[]

Ámbitos asignables de definición de roles.

properties.createdBy

string

Identificador del usuario que creó la asignación

properties.createdOn

string

Hora en que se creó

properties.description

string

Descripción de la definición de roles.

properties.permissions

Permission[]

Permisos de definición de roles.

properties.roleName

string

Nombre del rol.

properties.type

string

Tipo de rol.

properties.updatedBy

string

Identificador del usuario que actualizó la asignación

properties.updatedOn

string

Hora en que se actualizó

type

string

Tipo de definición de rol.