agentIdentityBlueprint の更新

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

agentIdentityBlueprint オブジェクトのプロパティを更新します。

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) AgentIdentityBlueprint.AddRemoveCreds.All、AgentIdentityBlueprint.UpdateBranding.All AgentIdentityBlueprint.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション AgentIdentityBlueprint.AddRemoveCreds.All、AgentIdentityBlueprint.UpdateBranding.All AgentIdentityBlueprint.ReadWrite.All

重要

  • エージェント ID ブループリントまたはブループリント プリンシパルを作成したプリンシパルは、自動的に所有者として割り当てられます。
  • 所有者は、エージェントIDロールを割り当てなくても、所有するブループリントに関連付けられたエージェントIDを作成および変更できます。
  • 非所有者が委任されたシナリオで職場または学校アカウントを使用してこの API を呼び出すには、管理者にサポートされている Microsoft Entra ロールが割り当てられている必要があります。 この操作では、次の最小特権の組み込みロールがサポートされます。

特定のシナリオのアクセス許可

  • keyCredentials や passwordCredentials などの資格情報関連のプロパティを更新するための最小特権アクセス許可は、AgentIdentityBlueprint.AddRemoveCreds.All です。
  • displayName や説明などのブランド プロパティを更新するための最小特権アクセス許可は、AgentIdentityBlueprint.UpdateBranding.All です。
  • 両方のアクセス許可スコープの対象となるプロパティを更新するには、より高い特権を持つ AgentIdentityBlueprint.ReadWrite.All アクセス許可を使用します。

HTTP 要求

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

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
Content-Type application/json. 必須です。

要求本文

要求本文で、更新する関連フィールドの値を指定します。 要求本文に含まれていない既存のプロパティは、以前の値を維持するか、他のプロパティ値の変更に基づいて再計算されます。 最適なパフォーマンスを得るためには、変更されていない既存の値を含めないでください。

プロパティ 型 説明
displayName 文字列 エージェント ID ブループリントの表示名。 このプロパティを更新するための最小特権アクセス許可は AgentIdentityBlueprint.UpdateBranding.All です。
isDisabled ブール型 エージェント ID ブループリントに関連付けられているサービス プリンシパルが新しいアクセス トークンを取得できるかどうか、または保護されたリソースにアクセスできるかどうかを指定します。 true に設定すると、既存のトークンは、構成された有効期間に基づいて有効期限が切れるまで有効です。 true エージェント ID ブループリントが非アクティブ化されている場合。それ以外の場合は false。
managerApplications Guid コレクション このエージェント ID ブループリントのマネージャーとして指定されているアプリケーションのアプリケーション ID のコレクション。 マネージャ・アプリケーションは、 AgentIdentityBlueprintPrincipal.ReadWrite.Allなどの高い権限を持つ権限を必要とせずに、管理対象ブループリントのエージェント・ブループリント・プリンシパル、エージェントID、およびエージェント・ユーザーを作成できます。 現時点では、値として設定できるのは Microsoft のファースト パーティ アプリケーション ID のみです。 最大 10 個の値。 null 許容ではありません。

応答

成功した場合、このメソッドは 204 No Content 応答コードを返します。

エージェント ID API によって返されるエラーの詳細については、「 エージェント ID エラー コード」を参照してください。

例

例 1: エージェント ID ブループリントの displayName を更新する

要求

次の例は要求を示しています。

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

{
  "displayName": "My New Name"
}

応答

次の例は応答を示しています。

HTTP/1.1 204 No Content

例 2: エージェント ID ブループリントでのマネージャーアプリケーションの更新

managerApplicationsプロパティは、エージェント ID ブループリント上でファースト パーティ (1P) とサードパーティ (3P) の両方の呼び出し元によって完全に書き込み可能です。

要求

次の例は要求を示しています。

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

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

応答

次の例は応答を示しています。

HTTP/1.1 204 No Content

例 3: ファースト パーティ以外のアプリケーションをマネージャーとして追加しようとする

現在、 managerApplications コレクションの値として設定できるのは、Microsoft のファースト パーティ アプリケーション ID のみです。

要求

次の例は、ファースト パーティ以外のアプリケーションを追加しようとする要求を示しています。

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

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

応答

次の例は、エラー応答を示しています。

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 個のマネージャー アプリケーションを設定しようとする要求を示しています。

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"
  ]
}

応答

次の例は、エラー応答を示しています。

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"
    }
  }
}
  • 最終更新: