Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: 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.
Создайте объект agentCollection .
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
| Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
|---|---|---|
| Делегированные (рабочая или учебная учетная запись) | AgentCollection.ReadWrite.All | Недоступно. |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
| Приложение | AgentCollection.ReadWrite.All | AgentCollection.ReadWrite.ManagedBy |
Важно!
В дополнение к разрешениям, перечисленным в предыдущей таблице, для этого API поддерживаются следующие делегированные и ограниченные разрешения приложений для специальных коллекций:
- AgentCollection.ReadWrite.Global для глобальной коллекции
- AgentCollection.ReadWrite.Quarantined для коллекции в карантине
Важно!
При использовании делегированных разрешений пользователю, прошедшему проверку подлинности, должна быть назначена поддерживаемая Microsoft Entra роль или пользовательская роль, которая предоставляет разрешения, необходимые для этой операции.
Администратор реестра агентов — это наименее привилегированная роль, поддерживаемая для этой операции.
HTTP-запрос
POST /agentRegistry/agentCollections
Заголовки запросов
| Имя | Описание |
|---|---|
| Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
| Content-Type | application/json. Обязательно. |
Текст запроса
В тексте запроса укажите представление объекта agentCollection в формате JSON.
При создании agentCollection можно указать следующие свойства.
| Свойство | Тип | Описание |
|---|---|---|
| ownerIds | Коллекция строк | Идентификаторы владельцев, которым разрешено управлять коллекцией. Обязательно. |
| Managedby | String | Идентификатор приложения (субъекта-службы), управляющего коллекцией. Необязательный параметр. |
| originatingStore | String | Исходная система или хранилище, в котором возникла коллекция. Необязательный параметр. |
| createdBy | String | Пользователь, создавший коллекцию. Необязательный параметр. |
| displayName | String | Понятное имя коллекции. Обязательный. |
| description | String | Описание или назначение коллекции. Необязательный параметр. |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 201 Created и объект agentCollection в теле отклика.
Примеры
Запрос
Ниже показан пример запроса.
POST https://graph.microsoft.com/beta/agentRegistry/agentCollections
Content-Type: application/json
{
"id": "Security Copilot Platform Workspace: 001",
"ownerIds": [
"daf58b0e-44e1-433c-b6b0-ca70cae320b8",
"b9108c41-d2d2-4e78-b073-92f57b752bd0"
],
"managedBy": "719cc904-9700-4e08-9941-fd826cc84c60",
"originatingStore": "Microsoft Security Copilot",
"createdBy": "d47bffae-411a-4de9-8548-05e79bc01f0d",
"displayName": "Conditional Access Agents",
"description": "A collection of agents to manage your organizations conditional access policies"
}
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.agentCollection",
"id": "c2d9e3ff-01a4-890c-f2bc-8edd3bc2eb24",
"ownerIds": [
"String"
],
"managedBy": "String",
"originatingStore": "String",
"createdBy": "String",
"displayName": "String",
"description": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)"
}