Update agentIdentityBlueprint

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

Важно!

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

Обновление свойств объекта agentIdentityBlueprint .

Разрешения

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

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

Важно!

Известная проблема. Если клиенту предоставлено разрешение Directory.AccessAsUser.All или Directory.ReadWrite.All , разрешения клиента на создание, обновление и удаление идентификаторов агента игнорируются, что может привести к сбою запросов с 403 Unauthorized ошибкой. Чтобы устранить эту проблему, удалите Directory.AccessAsUser.All разрешение или Directory.ReadWrite.All у клиента, запросите новые маркеры доступа и повторите запрос.
При использовании делегированных разрешений пользователю, прошедшему проверку подлинности, должна быть назначена одна из следующих поддерживаемых Microsoft Entra ролей:
- Администратор идентификатора агента.
- Разработчик идентификатора агента— создание схем удостоверений агента. Субъект с этой ролью является владельцем создаваемой схемы и может выполнять операции записи в этой схеме.

HTTP-запрос

PATCH /applications/{id}/microsoft.graph.agentIdentityBlueprint

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

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

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

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

Свойство	Тип	Описание
displayName	String	Отображаемое имя схемы удостоверения агента.
managerApplications	Коллекция объектов Guid	Коллекция идентификаторов приложений для приложений, назначенных в качестве диспетчеров схемы удостоверений агента. Приложения диспетчера могут создавать субъекты схемы агента, удостоверения агента и пользователей агентов для управляемых схем, не требуя высокопривилегированных разрешений, таких как `AgentIdentityBlueprintPrincipal.ReadWrite.All`. В настоящее время в качестве значений можно задать только идентификаторы приложений майкрософт первого производителя. Не более 10 значений. Значение null не допускается.

Отклик

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

Сведения об ошибках, возвращаемых API-интерфейсами удостоверений агента, см. в разделе Коды ошибок удостоверений агента.

Примеры

Пример 1. Обновление схемы displayName удостоверения агента

Запрос

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

HTTP
JavaScript

PATCH https://graph.microsoft.com/beta/applications/{id}/microsoft.graph.agentIdentityBlueprint
Content-Type: application/json

{
  "displayName": "My New Name"
}


const options = {
	authProvider,
};

const client = Client.init(options);

const agentIdentityBlueprint = {
  displayName: 'My New Name'
};

await client.api('/applications/{id}/microsoft.graph.agentIdentityBlueprint')
	.version('beta')
	.update(agentIdentityBlueprint);

Важно!

Пакеты SDK для Microsoft Graph по умолчанию используют версию API версии 1.0 и поддерживают не все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к бета-API с помощью SDK см. в статье Использование пакетов Microsoft Graph SDK с бета-API.

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Отклик

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

HTTP/1.1 204 No Content

Пример 2. Обновление диспетчераприложения к схеме удостоверений агента

Свойство managerApplications полностью доступно для записи как сторонними (1P), так и сторонними (3P) вызывающими лицами в схемах удостоверений агента.

Запрос

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

HTTP
JavaScript

PATCH https://graph.microsoft.com/beta/applications/graph.agentIdentityBlueprint/e5006f10-6462-4816-97ad-7f5a53204d11
Content-Type: application/json

{
  "managerApplications": [
    "77504268-3426-435e-99c0-9bc8656bc20e"
  ]
}


const options = {
	authProvider,
};

const client = Client.init(options);

const agentIdentityBlueprint = {
  managerApplications: [
    '77504268-3426-435e-99c0-9bc8656bc20e'
  ]
};

await client.api('/applications/graph.agentIdentityBlueprint/e5006f10-6462-4816-97ad-7f5a53204d11')
	.version('beta')
	.update(agentIdentityBlueprint);

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Отклик

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

HTTP/1.1 204 No Content

Пример 3. Попытка добавления в качестве руководителя приложения, не являющегося первым поставщиком

В настоящее время в качестве значений в коллекции можно задать только идентификаторы сторонних приложений managerApplications Майкрософт.

Запрос

В следующем примере показан запрос, пытающийся добавить приложение, не относящееся к первому поставщику.

HTTP
JavaScript

PATCH https://graph.microsoft.com/beta/applications/graph.agentIdentityBlueprint/e5006f10-6462-4816-97ad-7f5a53204d11
Content-Type: application/json

{
  "managerApplications": [
    "b43716e4-8cd1-4e88-b4ef-94611f4c6c46"
  ]
}


const options = {
	authProvider,
};

const client = Client.init(options);

const agentIdentityBlueprint = {
  managerApplications: [
    'b43716e4-8cd1-4e88-b4ef-94611f4c6c46'
  ]
};

await client.api('/applications/graph.agentIdentityBlueprint/e5006f10-6462-4816-97ad-7f5a53204d11')
	.version('beta')
	.update(agentIdentityBlueprint);

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Отклик

В следующем примере показан ответ на ошибку.

HTTP/1.1 400 Bad Request
Content-type: application/json

{
  "error": {
    "code": "BadRequest",
    "message": "Application b43716e4-8cd1-4e88-b4ef-94611f4c6c46 is not a Microsoft first-party application. Managers must be Microsoft first-party applications.",
    "innerError": {
      "date": "2026-01-09T18:19:01",
      "request-id": "b67ef789-eb9c-4639-8847-4425f27c3c13",
      "client-request-id": "7b3c375e-a647-4e57-9452-6a8539b2256f"
    }
  }
}

Пример 4. Попытка превышения лимита в 10 приложений диспетчера

Количество приложений ограничено не более 10 приложениями диспетчера.

Запрос

В следующем примере показан запрос, пытающийся задать 11 приложений диспетчера.

HTTP
JavaScript

PATCH https://graph.microsoft.com/beta/applications/graph.agentIdentityBlueprint/e5006f10-6462-4816-97ad-7f5a53204d11
Content-Type: application/json

{
  "managerApplications": [
    "030bd5f7-db55-4925-959e-5cd332851a0d",
    "1bcc0f3a-18c2-44cb-851a-26e344c2b1bd",
    "6ed7705a-21de-4de9-9e98-95d1a2b5caa5",
    "1925068d-8f9f-4fe8-8d4f-af7d70dce238",
    "383b3cea-2ad2-4ca9-8c86-7f66e507ee77",
    "00f03cc4-3d1f-4b44-8bfa-fca7b181cbb9",
    "9d089274-e6dc-4640-bae2-0c88b4dc89a3",
    "8ea5293f-5d07-45dd-8333-64edfd907423",
    "2a0c3ca6-102f-4f22-a19e-4e5d1d99337d",
    "d40473a1-1d8c-4db9-bc87-1296c90e516b",
    "d902c7bd-7fe6-486a-86e8-00da01936fba"
  ]
}


const options = {
	authProvider,
};

const client = Client.init(options);

const agentIdentityBlueprint = {
  managerApplications: [
    '030bd5f7-db55-4925-959e-5cd332851a0d',
    '1bcc0f3a-18c2-44cb-851a-26e344c2b1bd',
    '6ed7705a-21de-4de9-9e98-95d1a2b5caa5',
    '1925068d-8f9f-4fe8-8d4f-af7d70dce238',
    '383b3cea-2ad2-4ca9-8c86-7f66e507ee77',
    '00f03cc4-3d1f-4b44-8bfa-fca7b181cbb9',
    '9d089274-e6dc-4640-bae2-0c88b4dc89a3',
    '8ea5293f-5d07-45dd-8333-64edfd907423',
    '2a0c3ca6-102f-4f22-a19e-4e5d1d99337d',
    'd40473a1-1d8c-4db9-bc87-1296c90e516b',
    'd902c7bd-7fe6-486a-86e8-00da01936fba'
  ]
};

await client.api('/applications/graph.agentIdentityBlueprint/e5006f10-6462-4816-97ad-7f5a53204d11')
	.version('beta')
	.update(agentIdentityBlueprint);

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Отклик

В следующем примере показан ответ на ошибку.

HTTP/1.1 400 Bad Request
Content-type: application/json

{
  "error": {
    "code": "BadRequest",
    "message": "The number of ManagerApplications exceeds the limit. A blueprint can have only 10 ManagerApplications values.",
    "innerError": {
      "date": "2026-01-09T18:19:01",
      "request-id": "b67ef789-eb9c-4639-8847-4425f27c3c13",
      "client-request-id": "7b3c375e-a647-4e57-9452-6a8539b2256f"
    }
  }
}

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-03-21

Поделиться через

Update agentIdentityBlueprint

Разрешения

HTTP-запрос

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

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

Отклик

Примеры

Пример 1. Обновление схемы displayName удостоверения агента

Запрос

Отклик

Пример 2. Обновление диспетчераприложения к схеме удостоверений агента

Запрос

Отклик

Пример 3. Попытка добавления в качестве руководителя приложения, не являющегося первым поставщиком

Запрос

Отклик

Пример 4. Попытка превышения лимита в 10 приложений диспетчера

Запрос

Отклик

Обратная связь

Дополнительные ресурсы