Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você 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.
Importante
Próxima mudança nas APIs do Agent Registry
A partir de maio de 2026, as APIs de Registro de Agente no Microsoft Graph serão substituídas pelas APIs de Registro de Agente da plataforma Microsoft Agent 365. Essa alteração consolida as experiências de gerenciamento de agentes para facilitar a observação, o controle e a segurança de todos os agentes em seu locatário. Recomendamos que você planeje migrar para as novas APIs baseadas no Agent 365 quando elas forem lançadas. Saiba mais sobre a convergência do Registro de Agente com o Microsoft Agent 365.
Atualize as propriedades de um objeto agentCollection .
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
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ões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| 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, há suporte para as seguintes permissões delegadas com menos privilégios no escopo das coleções especiais para essa API:
- AgentCollection.ReadWrite.Global para a coleção Global
- AgentCollection.ReadWrite.Quarantined para coleta em quarentena
Importante
Ao usar permissões delegadas, o usuário autenticado deve receber uma função do Microsoft Entra com suporte ou uma função personalizada que conceda as permissões necessárias para esta operação.
O Administrador de Registro do Agente é a função com menos privilégios com suporte para essa 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 da solicitação, forneça apenas os valores das propriedades a serem atualizadas. 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.
A tabela a seguir especifica as propriedades que podem ser atualizadas.
| Propriedade | Tipo | Descrição |
|---|---|---|
| ownerIds | String collection | Lista de identificadores de proprietário para a coleção de agentes, podem ser usuários ou entidades de serviço. Obrigatório. |
| managedBy | Cadeia de caracteres | ID do aplicativo (entidade de serviço) gerenciando a coleção. Opcional. |
| originatingStore | Cadeia de caracteres | Sistema de origem/repositório de origem no qual a coleção se originou. Opcional. |
| createdBy | Cadeia de caracteres | Usuário que criou a coleção. Opcional. |
| displayName | Cadeia de caracteres | Nome amigável da coleção. Obrigatório. |
| description | Cadeia de caracteres | Descrição / finalidade da coleta. 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