governanceResource: RegistergovernanceResource: register

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Importante

Las API de la /beta versión de Microsoft Graph están sujetas a cambios.APIs under the /beta version in Microsoft Graph are subject to change. No se admite el uso de estas API en aplicaciones de producción.Use of these APIs in production applications is not supported. Para determinar si una API está disponible en v 1.0, use el selector de versiones .To determine whether an API is available in v1.0, use the Version selector.

Registre un objeto governanceResource en la administración de identidades privilegiada.Register a governanceResource object in Privileged Identity Management.

PermisosPermissions

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Nota: Esta API también requiere que el solicitante tenga al menos una asignación de roles activa en el recurso.Note: This API also requires that the requester have at least one active role assignment on the resource.

Recursos de AzureAzure resources

Tipo de permisoPermission type PermisosPermissions
Delegado (cuenta profesional o educativa)Delegated (work or school account) PrivilegedAccess.ReadWrite.AzureResourcesPrivilegedAccess.ReadWrite.AzureResources
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
AplicaciónApplication No admitida.Not supported.

Azure ADAzure AD

Tipo de permisoPermission type PermisosPermissions
Delegado (cuenta profesional o educativa)Delegated (work or school account) PrivilegedAccess.ReadWrite.AzureADPrivilegedAccess.ReadWrite.AzureAD
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
AplicaciónApplication No admitida.Not supported.

GruposGroups

Tipo de permisoPermission type PermisosPermissions
Delegado (cuenta profesional o educativa)Delegated (work or school account) PrivilegedAccess. ReadWrite. AzureADGroupsPrivilegedAccess.ReadWrite.AzureADGroups
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
AplicaciónApplication No admitida.Not supported.

Solicitud HTTPHTTP request

POST /privilegedAccess/azureResources/resources/register

Parámetros de consulta opcionalesOptional query parameters

Este método solo admite los $select parámetros de consulta de $expand OData de y para ayudar a personalizar la respuesta.This method only supports the $select and $expand OData query parameters to help customize the response.

Encabezados de solicitudRequest headers

NombreName DescripciónDescription
AuthorizationAuthorization Bearer {token}Bearer {token}
Tipo de contenidoContent-type application/jsonapplication/json

Cuerpo de solicitudRequest body

PropiedadesProperties TipoType DescripciónDescription
externalIdexternalId StringString Identificador externo del recurso que se va a registrar en PIM.The external identifier of the resource to be registered in PIM. Si se registra una suscripción, el identificador es el identificador de suscripción precedido por /subscriptions/ .If registering a subscription, the identifier is the subscription identifier prepended by /subscriptions/. Por ejemplo, /subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac.For example, /subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac.

RespuestaResponse

Si se ejecuta correctamente, este método devuelve una 200 OK respuesta.If successful, this method returns a 200 OK response.

EjemploExample

En el siguiente ejemplo se muestra cómo llamar a esta API.The following example shows how to call this API.

SolicitudRequest

POST https://graph.microsoft.com/beta/privilegedAccess/azureResources/resources/register
Content-type: application/json

{
  "externalId": "/subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac"
}

RespuestaResponse

HTTP/1.1 200 OK