Comentários Editar

governanceResource: registrar

  • Artigo
  • 2 minutos para o fim da leitura

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 de 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.

Registre um objeto governanceResource Privileged Identity Management.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Nota: Essa API também exige que o solicitante tenha pelo menos uma atribuição de função ativa no recurso.

Recursos do Azure

Tipo de permissão Permissões
Delegada (conta corporativa ou de estudante) PrivilegedAccess.ReadWrite.AzureResources
Delegada (conta pessoal da Microsoft) Sem suporte.
Aplicativo Sem suporte.

Azure AD

Tipo de permissão Permissões
Delegada (conta corporativa ou de estudante) PrivilegedAccess.ReadWrite.AzureAD
Delegada (conta pessoal da Microsoft) Sem suporte.
Aplicativo Sem suporte.

Grupos

Tipo de permissão Permissões
Delegada (conta corporativa ou de estudante) PrivilegedAccess.ReadWrite.AzureADGroup
Delegada (conta pessoal da Microsoft) Sem suporte.
Aplicativo Sem suporte.

Solicitação HTTP

POST /privilegedAccess/azureResources/resources/register

Parâmetros de consulta opcionais

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

Cabeçalhos de solicitação

Nome Descrição
Autorização Portador {token}
Content-type application/json

Corpo da solicitação

Propriedades Tipo Descrição
externalId Cadeia de caracteres O identificador externo do recurso a ser registrado no PIM. Se estiver registrando uma assinatura, o identificador será o identificador de assinatura precedido por /subscriptions/. Por exemplo, /subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac.

Resposta

Se for bem-sucedido, este método retornará 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