命名空间：microsoft.graph
表示 Microsoft Entra ID 中的代理标识。 代理标识是 AI 代理用于在 Microsoft Entra ID 生态系统内进行身份验证的帐户。
继承自 servicePrincipal。
此资源是一种开放类型，允许除了此处记录的属性之外的其他属性。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | AgentIdentity 集合 | 获取 agentidentity 对象及其属性的列表。 |
| 创建 | AgentIdentity | 创建新的 agentidentity 对象。 |
| Get | agentIdentity | 读取 agentIdentity 对象的属性和关系。 |
| 更新 | agentIdentity | 更新 agentIdentity 对象的属性。 |
| 删除 | 无 | 删除 agentIdentity 对象。 |
| 应用角色分配 | ||
| 列出 appRoleAssignedTo | appRoleAssignment 集合 | 获取为此代理标识分配应用角色的用户、组和代理标识。 |
| 列出 appRoleAssignments | appRoleAssignment 集合 | 获取分配有此代理标识的应用角色。 |
| 创建 appRoleAssignment | appRoleAssignment | 创建新的 appRoleAssignment 对象。 |
| 删除 appRoleAssignment | appRoleAssignment | 删除现有 appRoleAssignment 对象。 |
| 委派权限授予 | ||
| List oauth2PermissionGrants | oAuth2PermissionGrant 集合 | 获取委派的权限授予，授权此代理标识代表登录用户访问 API。 |
| 已删除项目 | ||
| List | directoryObject collection | 检索最近删除的代理标识列表。 |
| Get | directoryObject | 检索最近删除的代理标识的属性。 |
| 还原 | directoryObject | 还原最近删除的代理标识。 |
| 永久删除 | 无 | 永久删除代理标识。 |
| 目录对象 | ||
| List ownedObjects | directoryObject collection | 获取此代理标识拥有的目录对象。 |
| Memberships | ||
| 列出直接成员身份 | directoryObject collection | 获取此代理标识所属的组。 |
| 列出可传递成员身份 | directoryObject collection | 获取此代理标识所属的组。 此操作是可传递的，包括此代理标识是嵌套成员的组。 |
| Owners | ||
| List owners | directoryObject 集合 | 获取此代理标识的所有者。 |
| 添加所有者 | directoryObject | 通过发布到所有者集合来添加所有者。 |
| 删除所有者 | 无 | 删除 directoryObject 对象。 |
| 赞助商 | ||
| 列出赞助商 | directoryObject collection | 获取此代理标识的发起人。 |
| 添加赞助商 | directoryObject | 通过发布到赞助商集合来添加赞助商。 |
| 删除赞助 | 无 | 删除 directoryObject 对象。 |
属性
重要
虽然此资源继承自 servicePrincipal，但某些属性不适用。
| 属性 | 类型 | 说明 |
|---|---|---|
| odata.type | String |
#microsoft.graph.agentIdentity. 将此对象区分为代理标识。 可用于将此对象标识为代理标识，而不是另一种服务主体。 |
| accountEnabled | Boolean |
true 如果启用了代理标识帐户;否则为 false. 如果设置为 false，则任何用户都无法登录到此应用，即使他们已分配到该应用。 继承自 servicePrincipal。 |
| agentIdentityBlueprintId | String | 用于定义此代理标识配置的代理标识蓝图的 appId 。 |
| customSecurityAttributes | customSecurityAttributeValue | 保留分配给目录对象的自定义安全属性的值的开放式复杂类型。 可为 NULL。 需要 $select 检索。 继承自 servicePrincipal。 |
| createdByAppId | 字符串 | 创建此代理标识的应用程序的 appId 。 由 Microsoft Entra ID 内部设置。 只读。 继承自 servicePrincipal。 |
| createdDateTime | DateTimeOffset | 创建代理标识的日期和时间。 只读。 继承自 servicePrincipal。 |
| disabledByMicrosoftStatus | String | 指定 Microsoft 是否已禁用已注册的代理标识蓝图。 可能的值为： null (默认值) ， NotDisabled (DisabledDueToViolationOfServicesAgreement 原因可能包括可疑、滥用或恶意活动，或违反 Microsoft 服务协议) 。 继承自 servicePrincipal。 |
| displayName | String | 代理标识的显示名称。 继承自 servicePrincipal。 |
| id | String | 代理标识的唯一标识符。 继承自 directoryObject。 键。 不可为 null。 只读。 继承自 entity。 |
| managerApplications | Guid 集合 | 指定为此代理标识的后备 agentIdentityBlueprint 的管理员的应用程序 ID 的集合。 只读;此值由服务器托管，反映后备代理的 managerApplications IdentityBlueprint。 若要更改管理员，所有者或管理员必须在其注册所在的租户中更新后备 agentIdentityBlueprint 上的 managerApplications 属性。 对于多租户代理标识蓝图，仅使用蓝图的租户中的管理员无法进行此更改，他们必须询问蓝图主租户中的所有者或管理员。 不可为 null。 仅在 $select 上返回。 |
| servicePrincipalType | String | 对于所有代理标识，设置为 ServiceIdentity 。 继承自 servicePrincipal。 |
| tags | 字符串集合 | 可用于分类和标识代理身份的自定义字符串。 不可为 null。 该值是此处和关联的代理标识蓝图实体的 标签 属性上设置的字符串的并集。 继承自 servicePrincipal。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| appRoleAssignedTo | appRoleAssignment 集合 | 授予用户、组和其他代理标识的此应用或服务的应用角色分配。 支持 $expand。 继承自 microsoft.graph.servicePrincipal |
| appRoleAssignments | appRoleAssignment 集合 | 授予此代理标识的其他应用或服务的应用角色分配。 支持 $expand。 继承自 microsoft.graph.servicePrincipal |
| createdObjects | directoryObject collection | 由此代理标识创建的目录对象。 只读。 可为 Null。 继承自 microsoft.graph.servicePrincipal |
| memberOf | directoryObject collection | 此代理标识所属的角色。 HTTP 方法：GET 只读。 可为空。 支持 $expand。 继承自 microsoft.graph.servicePrincipal |
| oauth2PermissionGrants | oAuth2PermissionGrant 集合 | 委派的权限授予授权此代理标识代表登录用户访问 API。 只读。 可为 Null。 继承自 microsoft.graph.servicePrincipal |
| ownedObjects | directoryObject collection | 此代理标识拥有的目录对象。 只读。 可为 NULL。 支持$expand和 $filter (/$count eq 0， /$count ne 0， /$count eq 1/$count ne 1 ，) 。 继承自 microsoft.graph.servicePrincipal |
| owners | directoryObject collection | 作为此代理标识所有者的目录对象。 所有者是一组允许修改此对象的非管理员用户或代理标识。 支持$expand和 $filter (/$count eq 0， /$count ne 0， /$count eq 1/$count ne 1 ，) 。 继承自 microsoft.graph.servicePrincipal |
| 赞助 | directoryObject collection | 此代理标识的发起人。 |
JSON 表示形式
以下 JSON 表示形式显示资源类型。 默认情况下仅返回所有属性的子集。 只能使用 $select 检索所有其他属性。
{
"@odata.type": "#microsoft.graph.agentIdentity",
"id": "String (identifier)",
"accountEnabled": "Boolean",
"agentIdentityBlueprintId": "String",
"createdByAppId": "String",
"createdDateTime": "String (timestamp)",
"disabledByMicrosoftStatus": "String",
"displayName": "String",
"managerApplications": [
"Guid"
],
"servicePrincipalType": "String",
"tags": [
"String"
]
}