Удаление agentInstance из agentCollection

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Важно!

Предстоящее изменение API реестра агентов

Начиная с мая 2026 г. API реестра агентов в Microsoft Graph будут заменены API реестра агентов на основе Microsoft Agent 365. Это изменение объединяет возможности управления агентами, упрощая наблюдение, управление и защиту всех агентов в клиенте. Мы рекомендуем запланировать переход на новые API на основе Agent 365 при их выпуске. Дополнительные сведения о конвергенции реестра агентов с Microsoft Agent 365.

Удалите объект agentInstance из agentCollection.

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешение с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) AgentCollection.ReadWrite.All AgentCollection.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение AgentCollection.ReadWrite.ManagedBy AgentCollection.ReadWrite.All

Важно!

В дополнение к разрешениям, перечисленным в предыдущей таблице, для этого API поддерживаются следующие делегированные и ограниченные разрешения приложений для специальных коллекций:

  • AgentCollection.ReadWrite.Global для глобальной коллекции
  • AgentCollection.ReadWrite.Quarantined для коллекции в карантине

Важно!

При использовании делегированных разрешений пользователю, прошедшему проверку подлинности, должна быть назначена поддерживаемая Microsoft Entra роль или пользовательская роль, которая предоставляет разрешения, необходимые для этой операции.

Администратор реестра агентов — это наименее привилегированная роль, поддерживаемая для этой операции.

HTTP-запрос

DELETE /agentRegistry/agentInstances/{agentInstanceId}/collections/{agentCollectionId}/members/{id}/$ref

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 204 No Content.

Примеры

Запрос

Ниже показан пример запроса.

DELETE https://graph.microsoft.com/beta/agentRegistry/agentInstances/{agentInstanceId}/collections/{agentCollectionId}/members/{id}/$ref

Отклик

Ниже приводится пример отклика.

HTTP/1.1 204 No Content
  • Last updated on