Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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