Obter governaçãoResource

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.

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

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global	US Government L4	US Government L5 (DOD)	China operada pela 21Vianet
✅	✅	✅	❌

Permissões

A tabela seguinte mostra as permissões ou permissões com menos privilégios necessárias para chamar esta API em cada tipo de recurso suportado. Siga as melhores práticas para pedir permissões com menos privilégios. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Recurso com suporte	Delegada (conta corporativa ou de estudante)	Delegada (conta pessoal da Microsoft)	Application
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 requerente também tem de ter, pelo menos, uma atribuição de função no recurso.

Solicitação HTTP

GET /privilegedAccess/azureResources/resources/{id}

Parâmetros de consulta opcionais

Este método só suporta parâmetros $select$expand de consulta OData 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, este método devolve um 200 OK código de resposta e um objeto governanceResource no corpo da resposta.

Exemplo

Este exemplo mostra como obter os detalhes da subscrição 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",    
}