本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

访问对象

可以通过路径或通过 objectIdentifier 访问目录中的对象。

Path (路径)— Cloud Directory 树中的每个对象都可以通过描述如何访问它的路径名称进行标识和查找。路径从目录的根 (上图中的节点 000) 开始。路径表示法以使用斜杠 (/) 标记的链接开头，后跟通过路径分隔符 (也是斜杠) 分隔的子链接，直到到达路径的最后一部分。例如，上图中的对象 005 可以使用路径 /group/a/d 进行标识。多个路径可能会标识一个对象，因为作为叶节点的对象可以具有多个父级。以下路径也可以用于标识对象 005：/group/b/e

对象标识符— 目录中的每个对象都具有唯一全局标识符，即。ObjectIdentifier。ObjectIdentifier作为CreateObjectAPI 调用。还可以使用 ObjectIdentifier API 调用提取 GetObjectInformation。例如，要提取对象 005 的对象标识符，可以通过将对象引用作为指向对象的路径 (即 group/b/e 或 group/a/d) 来调用 GetObjectInformation。

GetObjectInformationRequest request = new GetObjectInformationRequest()
    .withDirectoryArn(directoryArn)
    .withObjectReference("/group/b/e")
    .withConsistencyLevel(level)
GetObjectInformationResult result = cdClient.getObjectInformation(request)
String objectIdentifier = result.getObjectIdentifier()

填充对象

可以使用 AddFacetToObject API 调用将新分面添加到对象。对象的类型基于附加到对象的分面来确定。目录中的对象附加基于对象的类型进行工作。附加对象时，请注意以下规则：

更新对象

可以通过多种方式更新对象：

删除对象

附加的对象必须满足特定条件，您才能从目录中将其删除：

因为对象必须从树中完全分离才能进行删除，所以必须使用对象标识符才能将其删除。

查询对象

本部分讨论用于在目录中查询对象的各种相关元素。

目录遍历

由于 Cloud Directory 是一种树，因此可以使用ListObjectChildrenAPI 操作或从下而上使用ListObjectParentsAPI 操作

策略查找

如果提供对象引用，则 LookupPolicy API 操作可采用从上向下的方式，沿其指向根的路径返回附加的所有策略。任何不指向根的路径都会被忽略。返回所有策略类型对象。

如果对象是叶节点，则它可以具有多个指向根的路径。此调用对于每次调用仅返回一个路径。要提取其他路径，请使用分页标记。

索引查询

Cloud Directory 通过使用以下范围，支持丰富的索引查询功能：

父路径列表

使用 ListObjectParentPaths API 调用可以为任何类型的对象 (节点、叶节点、策略节点、索引节点) 检索所有可用父路径。如果需要计算对象的所有父级，此 API 操作十分有用。该调用从目录根返回所有对象，直到请求的对象。它还基于用户定义的 MaxResults 返回路径数 (如果存在多个指向父级的路径)。返回的路径和节点的顺序在多个 API 调用间是一致的，除非删除或移动了对象。会从目标对象中忽略不指向目录根的路径。

举例来说明此工作原理，假设一个目录的对象层次结构类似于下面的示意图。

编号形状表示不同对象。该对象与目录根 (000) 之间的箭头数表示完整路径，会在输出中进行表示。下表显示对层次结构中特定叶节点对象进行的查询的请求和响应。