Atualizar 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.

Atualize as propriedades de um objeto agentCollection .

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global	US Government L4	US Government L5 (DOD)	China operada pela 21Vianet
✅	❌	❌	❌

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ões com menos privilégios	Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante)	AgentCollection.ReadWrite.All	AgentCollection.ReadWrite.Global, AgentCollection.ReadWrite.Quarantined
Delegado (conta pessoal da Microsoft)	Sem suporte.	Sem suporte.
Application	AgentCollection.ReadWrite.All	AgentCollection.ReadWrite.ManagedBy

Importante

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

• AgentCollection.ReadWrite.Global para coleção global
• AgentCollection.ReadWrite.Quarantined para a coleção em quarentena

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

PATCH /agentRegistry/agentCollections/{agentCollectionId}

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 apenas os valores das propriedades a atualizar. As propriedades existentes que não estão incluídas no corpo do pedido mantêm os valores anteriores ou são recalculadas com base em alterações a outros valores de propriedade.

A tabela a seguir especifica as propriedades que podem ser atualizadas.

Propriedade	Tipo	Descrição
ownerIds	String collection	A lista de identificadores de proprietário da coleção de agentes pode ser utilizadores ou principais de serviço. Obrigatório.
managedBy	Cadeia de caracteres	ID da aplicação (principal de serviço) que gere a coleção. Opcional.
originatingStore	Cadeia de caracteres	Sistema/arquivo de origem onde a coleção teve origem. Opcional.
createdBy	Cadeia de caracteres	Utilizador que criou a coleção. Opcional.
displayName	Cadeia de caracteres	Nome amigável da coleção. Obrigatório.
description	Cadeia de caracteres	Descrição/objetivo da coleção. Opcional.
createdDateTime	DateTimeOffset	Carimbo de data/hora quando criado. Opcional.
lastModifiedDateTime	DateTimeOffset	Carimbo de data/hora da última atualização. Opcional.

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.

PATCH https://graph.microsoft.com/beta/agentRegistry/agentCollections/{agentCollectionId}
Content-Type: application/json

{
  "displayName": "New Display Name"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content