Compartilhar via

Adicionar agentInstance a agentCollection

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.

Adicione um agentInstance a um agentCollection. Para adicionar vários agentInstance no batch, considere utilizar a criação de batches JSON.

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) AgentCollection.ReadWrite.All e AgentInstance.Read.All AgentCollection.ReadWrite.All e AgentInstance.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application AgentCollection.ReadWrite.ManagedBy e AgentInstance.Read.All AgentCollection.ReadWrite.All, AgentCollection.ReadWrite.ManagedBy e AgentInstance.Read.All, AgentCollection.ReadWrite.ManagedBy e AgentInstance.ReadWrite.All, AgentCollection.ReadWrite.ManagedBy e AgentInstance.ReadWrite.ManagedBy

Importante

Além das permissões listadas na tabela anterior, são suportadas as seguintes permissões com privilégios menores no âmbito das coleções especiais para esta API:

  • Para a coleção Global : AgentCollection.ReadWrite.Global e AgentInstance.Read.All; AgentCollection.ReadWrite.Global e AgentInstance.ReadWrite.All
  • Para a coleção em quarentena : AgentCollection.ReadWrite.Quarantined e AgentInstance.Read.All; AgentCollection.ReadWrite.Quarantined e AgentInstance.ReadWrite.All

Importante

Ao utilizar permissões delegadas, tem de ser atribuída ao utilizador autenticado uma função de Microsoft Entra suportada ou uma função personalizada com uma permissão de função suportada. O Administrador de Registo do Agente é a função com menos privilégios suportada para esta operação.

Solicitação HTTP

POST /agentRegistry/agentInstances/{agentInstanceId}/collections/{agentCollectionId}/members/$ref

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 um objeto JSON que contenha uma propriedade @odata.id com uma referência por ID a um agentInstance.

Resposta

Se tiver êxito, este método retornará um código de resposta 204 No Content.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/agentRegistry/agentInstances/{agentInstanceId}/collections/{agentCollectionId}/members/$ref
Content-Type: application/json

{
  "@odata.id": "https://graph.microsoft.com/beta/agentRegistry/agentInstances('agent-instance-id')"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content
  • Last updated on