名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Entra ID ディレクトリ内のエージェント ID を表します。 エージェント ID は、Microsoft Entra ID エコシステム内で認証するために AI エージェントによって使用されるアカウントです。
servicePrincipal から継承します。
このリソースは、ここに記載されているプロパティを超える追加のプロパティを許可するオープン型です。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List | agentidentity コレクション | agentidentity オブジェクトとそのプロパティの一覧を取得します。 |
| Create | agentidentity | 新しい agentidentity オブジェクトを作成します。 |
| Get | agentIdentity | agentIdentity オブジェクトのプロパティとリレーションシップを読み取ります。 |
| Update | agentIdentity | agentIdentity オブジェクトのプロパティを更新します。 |
| App role assignments | ||
| appRoleAssignedTo をリストする | appRoleAssignment コレクション | このエージェント ID に割り当てられたアプリ ロールのユーザー、グループ、エージェント ID を取得します。 |
| List appRoleAssignments | appRoleAssignment コレクション | このエージェント ID が割り当てられているアプリ ロールを取得します。 |
| appRoleAssignment を作成する | appRoleAssignment | 新しい appRoleAssignment オブジェクトを作成します。 |
| appRoleAssignment を削除する | appRoleAssignment | 既存の appRoleAssignment オブジェクトを削除します。 |
| 委任された権限の付与 | ||
| oauth2PermissionGrants を一覧表示する | oAuth2PermissionGrant コレクション | 委任されたアクセス許可を取得すると、サインインしているユーザーの代わりに API にアクセスすることをこのエージェント ID に許可できます。 |
| 削除済みアイテム | ||
| List | directoryObject コレクション | 最近削除されたエージェント ID の一覧を取得します。 |
| Get | directoryObject | 最近削除されたエージェント ID のプロパティを取得します。 |
| 復元 | directoryObject | 最近削除したエージェント ID を復元します。 |
| 完全に削除 | なし | エージェント ID を完全に削除します。 |
| Directory objects | ||
| List ownedObjects | directoryObject コレクション | このエージェント ID が所有するディレクトリ オブジェクトを取得します。 |
| Memberships | ||
| 直接メンバーシップを一覧表示する | directoryObject コレクション | このエージェント ID が直接メンバーであるグループを取得します。 |
| 推移的なメンバーシップを一覧表示する | directoryObject コレクション | このエージェント ID がメンバーであるグループを取得します。 この操作は推移的であり、このエージェント ID が入れ子になったメンバーであるグループが含まれます。 |
| 所有者 | ||
| 所有者を一覧表示する | directoryObject コレクション | このエージェント ID の所有者を取得します。 |
| 所有者の追加 | directoryObject | 所有者コレクションに投稿して所有者を追加します。 |
| 所有者を削除する | なし | directoryObject オブジェクトを削除します。 |
| Sponsors | ||
| List sponsors | directoryObject コレクション | このエージェント ID のスポンサーを取得します。 |
| スポンサーを追加する | directoryObject | スポンサー コレクションに投稿してスポンサーを追加します。 |
| Remove sponsors | なし | directoryObject オブジェクトを削除します。 |
プロパティ
重要
このリソースは servicePrincipal から継承されますが、一部のプロパティは適用されません。
| プロパティ | 型 | 説明 |
|---|---|---|
| odata.type | 文字列 |
#microsoft.graph.agentIdentity. このオブジェクトをエージェント ID として区別します。 別の種類のサービス プリンシパルではなく、このオブジェクトをエージェント ID として識別するために使用できます。 |
| accountEnabled | ブール値 |
true エージェント ID アカウントが有効になっている場合。それ以外の場合は、 false。
falseに設定されている場合、ユーザーは割り当てられている場合でも、このアプリにサインインできません。
servicePrincipal から継承されます。 |
| agentIdentityBlueprintId | 文字列 | このエージェント ID の構成を定義するエージェント ID ブループリントの appId 。 |
| customSecurityAttributes | customSecurityAttributeValue | ディレクトリ オブジェクトに割り当てられたカスタム セキュリティ属性の値を保持するオープン複合型。 Null 許容型。
$select でのみ返されます。
servicePrincipal から継承されます。 |
| createdByAppId | String | エージェント ID の作成に使用されるアプリケーションの appId 。 Microsoft Entra IDによって内部的に設定します。 読み取り専用です。 servicePrincipal から継承されます。 |
| createdDateTime | DateTimeOffset | エージェント ID が作成された日時。 読み取り専用です。 servicePrincipal から継承されます。 |
| disabledByMicrosoftStatus | String | 登録済みのエージェント ID ブループリントを Microsoft が無効にするかどうかを指定します。 使用可能な値は、 null (既定値)、 NotDisabled、および DisabledDueToViolationOfServicesAgreement です (疑わしい、虐待的、または悪意のあるアクティビティ、または Microsoft サービス契約違反が考えられます)。
servicePrincipal から継承されます。 |
| displayName | 文字列 | エージェント ID の表示名。 servicePrincipal から継承されます。 |
| id | 文字列 | エージェント ID の一意識別子。 directoryObject から継承されます。 キー。 null 許容ではありません。 読み取り専用です。 エンティティから継承 されます。 |
| servicePrincipalType | String | すべてのエージェント ID の ServiceIdentity に設定します。 servicePrincipal から継承されます。 |
| tags | String collection | エージェント ID の分類と識別に使用できるカスタム文字列。 null 許容ではありません。 値は、ここで、関連付けられているエージェント ID Blueprint エンティティの tags プロパティに設定された文字列の和集合です。 servicePrincipal から継承されます。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| appRoleAssignedTo | appRoleAssignment コレクション | ユーザー、グループ、その他のエージェント ID に付与される、このアプリまたはサービスのアプリ ロールの割り当て。
$expand をサポートします。
microsoft.graph.servicePrincipal から継承 |
| appRoleAssignments | appRoleAssignment コレクション | このエージェント ID に付与される、別のアプリまたはサービスのアプリ ロールの割り当て。
$expand をサポートします。
microsoft.graph.servicePrincipal から継承 |
| createdObjects | directoryObject コレクション | このエージェント ID によって作成されたディレクトリ オブジェクト。 読み取り専用です。 Null 許容型。 microsoft.graph.servicePrincipal から継承 |
| memberOf | directoryObject コレクション | このエージェント ID がメンバーであるロール。 HTTP メソッド: GET 読み取り専用。 Null 許容型です。
$expand をサポートします。
microsoft.graph.servicePrincipal から継承 |
| oauth2PermissionGrants | oAuth2PermissionGrant コレクション | 委任されたアクセス許可は、サインインしているユーザーの代わりに API にアクセスすることをこのエージェント ID に許可します。 読み取り専用です。 Null 許容型。 microsoft.graph.servicePrincipal から継承 |
| ownedObjects | directoryObject コレクション | このエージェント ID によって所有されるディレクトリ オブジェクト。 読み取り専用です。 Null 許容型。
$expand および $filter (/$count eq 0、/$count ne 0、/$count eq 1、/$count ne 1) をサポートします。
microsoft.graph.servicePrincipal から継承 |
| owners | directoryObject コレクション | このエージェント ID の所有者であるディレクトリ オブジェクト。 所有者は、このオブジェクトの変更を許可されている管理者以外のユーザーまたはエージェント ID のセットです。
$expand および $filter (/$count eq 0、/$count ne 0、/$count eq 1、/$count ne 1) をサポートします。
microsoft.graph.servicePrincipal から継承 |
| スポンサー | directoryObject コレクション | このエージェント ID のスポンサー。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。 既定では、すべてのプロパティのサブセットのみが返されます。 その他のすべてのプロパティは、$selectを使用してのみ取得できます。
{
"@odata.type": "#microsoft.graph.agentIdentity",
"id": "String (identifier)",
"accountEnabled": "Boolean",
"agentIdentityBlueprintId": "String",
"createdByAppId": "String",
"createdDateTime": "String (timestamp)",
"disabledByMicrosoftStatus": "String",
"displayName": "String",
"servicePrincipalType": "String",
"tags": [
"String"
]
}