Obter governançaResource

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Cuidado

Esta versão do Privileged Identity Management (PIM) API para recursos Azure será depreciada em breve. Use a nova API DE PIM REST do Azure para funções de recurso do Azure.

Recupere as propriedades e as relações de um objeto governanceResource .

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global	Governo dos EUA L4	GOVERNO DOS EUA L5 (DOD)	China operada pela 21Vianet
✅	✅	✅	❌

Permissões

A tabela a seguir mostra a permissão ou permissões menos privilegiadas necessárias para chamar essa API em cada tipo de recurso com suporte. Siga as práticas recomendadas para solicitar permissões menos privilegiadas. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Recurso com suporte	Delegada (conta corporativa ou de estudante)	Delegada (conta pessoal da Microsoft)	Aplicativo
Microsoft Entra ID	PrivilegedAccess.ReadWrite.AzureAD	Sem suporte.	PrivilegedAccess.Read.AzureAD
Recursos do Azure	PrivilegedAccess.ReadWrite.AzureResources	Sem suporte.	PrivilegedAccess.Read.AzureResources
group	PrivilegedAccess.ReadWrite.AzureADGroup	Sem suporte.	PrivilegedAccess.Read.AzureADGroup

O solicitante também deve ter pelo menos uma atribuição de função no recurso.

Solicitação HTTP

GET /privilegedAccess/azureResources/resources/{id}

Parâmetros de consulta opcionais

Esse método só dá suporte a parâmetros $selectde consulta OData e $expand para ajudar a personalizar a resposta.

Cabeçalhos de solicitação

Nome	Descrição
Authorization	Portador {code}

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se for bem-sucedido, esse método retornará um código de resposta e um 200 OK objeto governanceResource no corpo da resposta.

Exemplo

Este exemplo mostra como obter os detalhes da assinatura Wingtip Toys – Prod (e5e7d29d-5465-45ac-885f-4716a5ee74b5).

Solicitação

GET https://graph.microsoft.com/beta/privilegedAccess/azureResources/resources/e5e7d29d-5465-45ac-885f-4716a5ee74b5

Resposta

HTTP/1.1 200 OK
Content-type: application/json
Content-Length: 459

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#governanceResources/$entity",
    "id": "e5e7d29d-5465-45ac-885f-4716a5ee74b5",
    "externalId": "/subscriptions/38ab2ccc-3747-4567-b36b-9478f5602f0d",
    "type": "subscription",
    "displayName": "Wingtip Toys - Prod",
    "status": "Active",
    "registeredDateTime": "2018-04-05T22:30:37.13Z",
    "registeredRoot": "/subscriptions/38ab2ccc-3747-4567-b36b-9478f5602f0d",    
}