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 agentIdentityBlueprint .
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.AddRemoveCreds.All, AgentIdentityBlueprint.UpdateBranding.All | AgentIdentityBlueprint.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | AgentIdentityBlueprint.AddRemoveCreds.All, AgentIdentityBlueprint.UpdateBranding.All | AgentIdentityBlueprint.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:
Permissões para cenários específicos
- A permissão menos privilegiada para atualizar propriedades relacionadas a credenciais, como keyCredentials e passwordCredentials, é AgentIdentityBlueprint.AddRemoveCreds.All.
- A permissão menos privilegiada para atualizar propriedades de identidade visual, como displayName e descrição , é AgentIdentityBlueprint.UpdateBranding.All.
- Para atualizar as propriedades cobertas por ambos os escopos de permissão, use a permissão AgentIdentityBlueprint.ReadWrite.All com privilégios mais altos.
Solicitação HTTP
PATCH /applications/{id}/microsoft.graph.agentIdentityBlueprint
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 os valores para os campos relevantes que devem ser atualizados. 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. Para obter um melhor desempenho, não inclua valores existentes que não foram alterados.
| Propriedade | Tipo | Descrição |
|---|---|---|
| displayName | Cadeia de caracteres | O nome de exibição do blueprint de identidade do agente. A permissão menos privilegiada para atualizar essa propriedade é AgentIdentityBlueprint.UpdateBranding.All. |
| isDisabled | Booliano | Especifica se a entidade de serviço associada ao blueprint de identidade do agente pode obter novos tokens de acesso ou acessar recursos protegidos. Quando definido como true, os tokens existentes permanecem válidos até expirarem com base em seus tempos de vida configurados.
true se o blueprint de identidade do agente estiver desativado; caso contrário false. |
| managerApplications | Coleção de GUIDs | Uma coleção de IDs de aplicativos para aplicativos designados como gerentes desse blueprint de identidade de agente. Os aplicativos do Manager podem criar entidades de entidade de blueprint de agente, identidades de agente e usuários de agente para seus blueprints gerenciados sem exigir permissões de alto privilégio, como AgentIdentityBlueprintPrincipal.ReadWrite.All. Atualmente, somente IDs de aplicativos internos da Microsoft podem ser definidos como valores. Máximo de 10 valores. Não anulável. |
Resposta
A propriedade isSingleInstance é imutável após a criação. Uma tentativa de alterá-lo, em qualquer direção, retorna 400 Bad Request com o código Request_BadRequestde erro .
Se tiver êxito, este método retornará um código de resposta 204 No Content.
Para obter informações sobre erros retornados por APIs de identidade do agente, consulte Códigos de erro de identidade do agente.
Exemplos
Exemplo 1: Atualizar o displayName de um blueprint de identidade de agente
Solicitação
O exemplo a seguir mostra uma solicitação.
PATCH https://graph.microsoft.com/beta/applications/{id}/microsoft.graph.agentIdentityBlueprint
Content-Type: application/json
{
"displayName": "My New Name"
}
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 204 No Content
Exemplo 2: Atualizar managerApplications em um blueprint de identidade de agente
A managerApplications propriedade é totalmente gravável por chamadores primários (1P) e terceirizados (3P) em blueprints de identidade de agente.
Solicitação
O exemplo a seguir mostra uma solicitação.
PATCH https://graph.microsoft.com/beta/applications/graph.agentIdentityBlueprint/e5006f10-6462-4816-97ad-7f5a53204d11
Content-Type: application/json
{
"managerApplications": [
"77504268-3426-435e-99c0-9bc8656bc20e"
]
}
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 204 No Content
Exemplo 3: Tentativa de adicionar um aplicativo não primário como gerente
No momento, somente IDs de aplicativos próprios da managerApplications Microsoft podem ser definidas como valores na coleção.
Solicitação
O exemplo a seguir mostra uma solicitação tentando adicionar um aplicativo que não é primário.
PATCH https://graph.microsoft.com/beta/applications/graph.agentIdentityBlueprint/e5006f10-6462-4816-97ad-7f5a53204d11
Content-Type: application/json
{
"managerApplications": [
"b43716e4-8cd1-4e88-b4ef-94611f4c6c46"
]
}
Resposta
O exemplo a seguir mostra a resposta de erro.
HTTP/1.1 400 Bad Request
Content-type: application/json
{
"error": {
"code": "BadRequest",
"message": "Application b43716e4-8cd1-4e88-b4ef-94611f4c6c46 is not a Microsoft first-party application. Managers must be Microsoft first-party applications.",
"innerError": {
"date": "2026-01-09T18:19:01",
"request-id": "b67ef789-eb9c-4639-8847-4425f27c3c13",
"client-request-id": "7b3c375e-a647-4e57-9452-6a8539b2256f"
}
}
}
Exemplo 4: Tente exceder o limite de 10 aplicativos do gerenciador
Os aplicativos são limitados a um máximo de 10 aplicativos gerenciadores.
Solicitação
O exemplo a seguir mostra uma solicitação tentando definir 11 aplicativos gerenciadores.
PATCH https://graph.microsoft.com/beta/applications/graph.agentIdentityBlueprint/e5006f10-6462-4816-97ad-7f5a53204d11
Content-Type: application/json
{
"managerApplications": [
"030bd5f7-db55-4925-959e-5cd332851a0d",
"1bcc0f3a-18c2-44cb-851a-26e344c2b1bd",
"6ed7705a-21de-4de9-9e98-95d1a2b5caa5",
"1925068d-8f9f-4fe8-8d4f-af7d70dce238",
"383b3cea-2ad2-4ca9-8c86-7f66e507ee77",
"00f03cc4-3d1f-4b44-8bfa-fca7b181cbb9",
"9d089274-e6dc-4640-bae2-0c88b4dc89a3",
"8ea5293f-5d07-45dd-8333-64edfd907423",
"2a0c3ca6-102f-4f22-a19e-4e5d1d99337d",
"d40473a1-1d8c-4db9-bc87-1296c90e516b",
"d902c7bd-7fe6-486a-86e8-00da01936fba"
]
}
Resposta
O exemplo a seguir mostra a resposta de erro.
HTTP/1.1 400 Bad Request
Content-type: application/json
{
"error": {
"code": "BadRequest",
"message": "The number of ManagerApplications exceeds the limit. A blueprint can have only 10 ManagerApplications values.",
"innerError": {
"date": "2026-01-09T18:19:01",
"request-id": "b67ef789-eb9c-4639-8847-4425f27c3c13",
"client-request-id": "7b3c375e-a647-4e57-9452-6a8539b2256f"
}
}
}