Compartilhar via

Criar agentIdentity

Namespace: microsoft.graph

Crie um novo objeto agentIdentity a partir do esquema de identidade do agente especificado.

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissão com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) Sem suporte. Sem suporte.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application AgentIdentity.CreateAsManager, AgentIdentity.Create.All Não disponível

Importante

Para acesso delegado através de contas escolares ou profissionais, tem de ser atribuída ao administrador uma função de Microsoft Entra suportada. Esta operação suporta as seguintes funções incorporadas, que fornecem apenas o menor privilégio necessário:

  • Administrador de ID do Agente.
  • ID do Agente Programador – crie esquemas de identidade do agente e principais de esquema. O principal com esta função tem a propriedade atribuída do esquema ou principal de esquema que criam e pode realizar operações de escrita nos recursos que possuem.

Problema conhecido: se for concedida ao cliente a permissão Directory.AccessAsUser.All ou Directory.ReadWrite.All, as permissões do cliente para criar, atualizar e eliminar IDs do Agente são ignoradas, o que pode fazer com que os pedidos falhem com 403 Forbidden o erro. Para resolve este problema, remova estas permissões do cliente, peça novos tokens de acesso e repita o pedido.

Solicitação HTTP

POST /servicePrincipals/microsoft.graph.agentIdentity

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 do pedido, forneça uma representação JSON de um objeto agentIdentity . O corpo do pedido tem de conter displayName, agentIdentityBlueprintId e uma referência de patrocinador válida.

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto agentIdentity no corpo da resposta.

Para obter informações sobre os erros devolvidos pelas APIs de identidade do agente, veja Códigos de erro de identidade do agente.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/v1.0/servicePrincipals/microsoft.graph.agentIdentity
Content-type: application/json

{
  "displayName": "My Agent Identity",
  "agentIdentityBlueprintId": "65415bb1-9267-4313-bbf5-ae259732ee12",
  "sponsors@odata.bind": [
    "https://graph.microsoft.com/v1.0/users/acc9f0a1-9075-464f-9fe7-049bf1ae6481",
    "https://graph.microsoft.com/v1.0/groups/47309f33-e0ff-7be6-defe-28b504c8cd2e"
  ]
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#servicePrincipals/$entity",
    "@odata.type": "#microsoft.graph.agentIdentity",
    "id": "59e617e5-e447-4adc-8b88-00af644d7c92",
    "createdByAppId": "f98c895e-6ce2-4f5b-a31b-da7e48f25daa",
    "displayName": "My Agent Identity",
    "servicePrincipalType": "ServiceIdentity",
    "tags": [],
    "agentIdentityBlueprintId": "65415bb1-9267-4313-bbf5-ae259732ee12"
}
  • Last updated on