directoryObject 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

表示Microsoft Entra 对象。 directoryObject 类型是以下目录实体类型（通常称为目录对象）的基类型：

• application
• administrativeUnit
• appRoleAssignment
• directoryObject
• directoryRole
• 设备
• externalProfile
• 组
• orgContact
• servicePrincipal
• 用户

该资源支持：

• 通过提供 delta 函数，使用 delta 查询跟踪增量添加、删除和更新。

方法

方法	返回类型	说明
获取 directoryObject	directoryObject	读取目录对象的属性。
获取增量	directoryObject collection	获取目录对象（例如用户、组、应用程序和服务主体）的增量更改。 需要对派生类型的 ID 或派生类型本身进行筛选。 有关增量查询的详细信息，请参阅 使用增量查询跟踪 Microsoft Graph 数据中的更改。
删除	无	删除 directory 对象。
checkMemberGroups	String collection	检查指定组列表中的成员身份，并从该列表返回指定用户、组、服务主体、组织联系人或目录对象所属的组。 检查是可传递的。
getMemberGroups	String collection	返回用户、组、服务主体、组织联系人、设备或目录对象所属的所有组。 检查是可传递的。
checkMemberObjects	String 集合	检查指定用户、组、设备、组织联系人或目录对象的组、管理单元或目录角色列表中的成员身份。 此方法是可传递的。
getMemberObjects	String collection	返回用户、组、设备、组织联系人或目录对象所属的所有组、管理单元和目录角色。 检查是可传递的。
getByIds	directoryObject 集合	基于提供的 ID 集获取目录对象集。
validateProperties	JSON	验证 Microsoft 365 组的显示名称或邮件昵称是否符合命名策略。

属性

属性	类型	说明
deletedDateTime	DateTimeOffset	删除此对象的日期和时间。 在对象尚未删除时始终为 null。
id	String	对象的全局唯一标识符。 例如，12345678-9abc-def0-1234-56789abcde。 id 属性的值通常（但不总是）用 GUID 表示；将它视为不透明标识符，不要总将它视为 GUID。 键。 不可为 null。 只读。

关系

无。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "deletedDateTime": "String (timestamp)",
  "id": "String (identifier)"
}