Atualizar agentIdentityBlueprint

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"
    }
  }
}