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

# 访问对象
<a name="directory_objects_access_objects"></a>

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

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

 **对象标识符**— 目录中的每个对象都具有唯一全局标识符，即。`ObjectIdentifier`。`ObjectIdentifier`作为[https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_CreateObject.html](https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_CreateObject.html)API 调用。还可以使用 `ObjectIdentifier`[ API 调用提取 `GetObjectInformation`。](https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_GetObjectInformation.html)例如，要提取对象 `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()
```

## 填充对象
<a name="directory_objects_access_objects_populatingobjects"></a>

可以使用 [`AddFacetToObject` API 调用将新分面添加到对象。](https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_AddFacetToObject.html)对象的类型基于附加到对象的分面来确定。目录中的对象附加基于对象的类型进行工作。附加对象时，请注意以下规则：
+  叶节点对象不能有子级。
+  节点对象可以有多个子级。
+  策略类型的对象不能有子级，可以有零个或一个父级。

## 更新对象
<a name="directory_objects_access_objects_updatingobjects"></a>

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

1.  使用 [`UpdateObjectAttributes` 操作可更新对象上的各个分面属性。](https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_UpdateObjectAttributes.html)

1.  使用 [`AddFacetToObject` 操作可将新分面添加到对象。](https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_AddFacetToObject.html)

1.  使用 [`RemoveFacetFromObject` 操作可从对象删除现有分面。](https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_RemoveFacetFromObject.html)

## 删除对象
<a name="directory_objects_access_objects_deletingobjects"></a>

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

1.  必须将对象从树分离。仅当对象没有任何子级时才能分离对象。如果对象有子级，则必须先分离所有子级。

1.  仅当删除了分离的对象上的所有属性时，才能删除该对象。通过删除附加到某个对象的每个分面，可以删除该对象上的属性。可以通过调用 [https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_GetObjectInformation.html](https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_GetObjectInformation.html) 来提取附加到对象的分面的列表。

1.  对象还必须没有父级、没有策略附加并且没有索引附加。

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

## 查询对象
<a name="directory_objects_access_objects_queryobjects"></a>

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

### 目录遍历
<a name="directory_objects_access_objects_directorytraversal"></a>

由于 Cloud Directory 是一种树，因此可以使用[https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_ListObjectChildren.html](https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_ListObjectChildren.html)API 操作或从下而上使用[https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_ListObjectParents.html](https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_ListObjectParents.html)API 操作

### 策略查找
<a name="directory_objects_access_objects_policylookup"></a>

如果提供对象引用，则 [`LookupPolicy` API 操作可采用从上向下的方式，沿其指向根的路径返回附加的所有策略。](https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_LookupPolicy.html)任何不指向根的路径都会被忽略。返回所有策略类型对象。

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

### 索引查询
<a name="directory_objects_access_objects_indexquerying"></a>

Cloud Directory 通过使用以下范围，支持丰富的索引查询功能：
+ **FIRST - **从第一个索引属性值开始。开始属性值是可选的。
+ **LAST - **返回直到索引结束的属性值，包括缺失值。结束属性值是可选的。
+ **LAST\$1BEFORE\$1MISSING\$1VALUES - **返回直到索引结束的属性值，不包括缺失值。
+ **INCLUSIVE - **包括所指定的属性值。
+ **EXCLUSIVE - **不包括所指定的属性值。

### 父路径列表
<a name="directory_objects_access_objects_parentpath"></a>

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

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

![\[Object hierarchy diagram showing nodes, links, and policy objects in a tree structure.\]](http://docs.aws.amazon.com/zh_cn/clouddirectory/latest/developerguide/images/parent_path.png)


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

 


**针对对象的示例查询**  

| 请求 | 响应 | 
| --- | --- | 
| 004, PageToken: null, MaxResults: 1 | [\$1/group/a/c], [000, 001, 002, 004]\$1], PageToken: null | 
| 005, PageToken: null, MaxResults: 2 | [\$1/group/a/d, [000, 001, 002, 005]\$1, \$1 /group/b/e, [000, 001, 003, 005]\$1], PageToken: null 在此示例中，对象 `005` 将节点 `002` 和 `003` 作为父级。此外，因为 `MaxResults` 为 2，所以两个路径都会在列表中显示对象。  | 
| 005, PageToken: null, MaxResults: 1 | [\$1/group/a/d, [000, 001, 002, 005]\$1], PageToken: <encrypted\$1next\$1token> | 
| 005, PageToken: <encrypted\$1next\$1token>, MaxResults: 1 | [\$1/group/b/e, [000, 001, 003, 005]\$1], PageToken: null 在此示例中，对象 `005` 将节点 `002` 和 `003` 作为父级。此外，因为 `MaxResults` 为 1，所以进行多个包含页面标记的分页调用来获取所有路径及对象列表。  | 
| 006, PageToken: null, MaxResults: 1 | [\$1/group/b/f, [000, 001, 003, 006]\$1], PageToken: null | 
| 007, PageToken: null, MaxResults: 1 | [\$1/group/a/index, [000, 001, 002, 007]\$1], PageToken: null |