Compartilhar via

governanceResource: registar

  • Artigo

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.

Registar um objeto governanceResource no Privileged Identity Management.

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. Sem suporte.
Recursos do Azure PrivilegedAccess.ReadWrite.AzureResources Sem suporte. Sem suporte.
group PrivilegedAccess.ReadWrite.AzureADGroup Sem suporte. Sem suporte.

O requerente também tem de ter, pelo menos, uma atribuição de função ativa no recurso.

Solicitação HTTP

POST /privilegedAccess/azureResources/resources/register

Parâmetros de consulta opcionais

Este método só suporta os $selectparâmetros de consulta OData e $expand para ajudar a personalizar a resposta.

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-type application/json

Corpo da solicitação

Propriedades Tipo Descrição
externalId Cadeia de caracteres O identificador externo do recurso a registar no PIM. Se registar uma subscrição, o identificador será o identificador da subscrição pré-anexado por /subscriptions/. Por exemplo, /subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac.

Resposta

Se for bem-sucedido, este método devolve uma 200 OK resposta.

Exemplo

O exemplo a seguir mostra como chamar essa API.

Solicitação

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

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

Resposta

HTTP/1.1 200 OK