Atualizar inheritablePermission

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.

Atualize as propriedades de um objeto inheritablePermission em um blueprint de identidade de agente. Ao mudar para um padrão de herança mais restritivo, como de para enumeratedScopes ou noScopes, quaisquer identidades de agente que exijam acesso exigirão nova concessão de allAllowedScopes consentimento para adquirir os escopos recém-restritos.

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. 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.

Tipo de permissão Permissão com privilégios mínimos Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) AgentIdentityBlueprint.ReadWrite.All Directory.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application AgentIdentityBlueprint.ReadWrite.All Directory.ReadWrite.All

Importante

  • Uma entidade de segurança que cria um blueprint de identidade de agente ou uma entidade de segurança de plano é automaticamente atribuída como proprietária.
  • Os proprietários podem criar e modificar identidades de agente associadas a um blueprint que possuem sem receber uma função de ID de agente.
  • Para que os não proprietários chamem essa API em cenários delegados usando contas corporativas ou de estudante, o administrador deve receber uma função do Microsoft Entra com suporte. Esta operação dá suporte à seguinte função interna com privilégios mínimos:

Solicitação HTTP

PATCH /applications/{id}/microsoft.graph.agentIdentityBlueprint/inheritablePermissions/{resourceAppId}

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. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça apenas os valores das propriedades a serem atualizadas. As propriedades existentes que não estão incluídas no corpo da solicitação mantêm seus valores anteriores ou são recalculadas com base nas alterações de outros valores de propriedade.

A tabela a seguir especifica as propriedades que podem ser atualizadas.

Propriedade Tipo Descrição
inheritableScopes inheritableScopes Padrão de herança aplicado a escopos de permissão delegada para o blueprint de identidade do agente. Obrigatório.

Resposta

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

Exemplos

Exemplo 1: Atualizar inheritablePermission para usar o padrão allAllowedScopes

Este exemplo atualiza um inheritablePermission existente para usar o padrão de herança allAllowedScopes, permitindo que todos os escopos de permissão delegada do aplicativo de recurso sejam herdáveis por identidades de agente.

Solicitação

O exemplo a seguir mostra uma solicitação.

PATCH https://graph.microsoft.com/beta/applications/bc057821-f236-49d6-9f2c-1ebf43e9437a/microsoft.graph.agentIdentityBlueprint/inheritablePermissions/00000003-0000-0ff1-ce00-000000000000
Content-Type: application/json

{
  "inheritableScopes": {
    "@odata.type": "microsoft.graph.allAllowedScopes"
  }
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content

Exemplo 2: Atualizar inheritablePermission para usar o padrão enumeratedScopes

Este exemplo atualiza um inheritablePermission existente para usar o padrão de herança enumeratedScopes, permitindo que apenas os escopos de permissão delegada especificados do aplicativo de recurso sejam herdáveis por identidades de agente.

Solicitação

O exemplo a seguir mostra uma solicitação.

PATCH https://graph.microsoft.com/beta/applications/bc057821-f236-49d6-9f2c-1ebf43e9437a/microsoft.graph.agentIdentityBlueprint/inheritablePermissions/00000003-0000-0000-c000-000000000000
Content-Type: application/json

{
  "inheritableScopes": {
    "@odata.type": "microsoft.graph.enumeratedScopes",
    "scopes": [
      "User.Read",
      "Mail.Read"
    ]
  }
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content

Exemplo 3: Atualizar inheritablePermission para usar o padrão noScopes

Este exemplo atualiza um inheritablePermission existente para usar o padrão de herança noScopes, impedindo que escopos de permissão delegada do aplicativo de recurso sejam herdáveis por identidades de agente.

Solicitação

O exemplo a seguir mostra uma solicitação.

PATCH https://graph.microsoft.com/beta/applications/bc057821-f236-49d6-9f2c-1ebf43e9437a/microsoft.graph.agentIdentityBlueprint/inheritablePermissions/00000003-0000-0000-c000-000000000000
Content-Type: application/json

{
  "inheritableScopes": {
    "@odata.type": "microsoft.graph.noScopes"
  }
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content