本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
使用 Cloud Directory API
Amazon Cloud Directory 包含一组 API 操作，通过这些操作可以对 Cloud Directory 功能进行编程访问。您可以将Amazon Cloud Directory API 参考指南了解如何对 Cloud Directory API 进行请求以便创建和管理各种元素。另外还介绍请求的组成部分、响应的内容以及如何对请求进行身份验证。
Cloud Directory 提供了所有必需的 API 操作供开发人员构建新应用程序。它提供以下类别的 API 调用：
-
架构的创建、读取、更新、删除 (CRUD)
-
分面的 CRUD
-
目录的 CRUD
-
对象 (节点、策略等) 的 CRUD
-
索引定义的 CRUD
-
批处理读取、批处理写入
账单如何与 Cloud Directory API 配合工作
API 调用的账单因发出的 API 调用的具体类型而异。最终一致性读取 API 调用、强一致性读取 API 调用和写入 API 调用都有特定的账单费率。元数据 API 调用是免费的。
强一致性读取操作用于读取值时的先写后读一致性。最终一致性操作用于在运行更新时检索值。使用最终一致性操作时，检索的结果可能不是最准确的，因为您从中读取值的特定主机仍在处理更新。不过，当您检索高性能调用时，这些读取操作的延迟是非常低的。
从 Cloud Directory 读取数据时，您必须指定最终一致性读取类型操作或强一致性读取类型操作。读取类型基于一致性级别。两种一致性级别是，对于最终一致性读取为 EVENTUAL，对于强一致性读取为 SERIALIZABLE。有关更多信息，请参阅 一致性级别。
下表列出了所有云目录 API 以及它们如何影响您的 AWS 账户的账单。
| API | 最终一致性读取 1 | 强一致性读取 2 | 写入 3 | 元数据 4 |
|---|---|---|---|---|
| AddFacetToObject | X | |||
| ApplySchema | X | |||
| AttachObject | X | |||
| AttachPolicy | X | |||
| AttachToIndex | X | |||
| AttachTypedLink | X | |||
| BatchRead | X | X | ||
| BatchWrite | X | |||
| CreateDirectory | X | |||
| CreateFacet | X | |||
| CreateIndex | X | |||
| CreateObject | X | |||
| CreateSchema | X | |||
| CreateTypedLinkFacet | X | |||
| DeleteDirectory | X | |||
| DeleteFacet | X | |||
| DeleteObject | X | |||
| DeleteSchema | X | |||
| DetachFromIndex | X | |||
| DetachObject | X | |||
| DetachPolicy | X | |||
| DetachTypedLink | X | |||
| DeleteTypedLinkFacet | X | |||
| DisableDirectory | X | |||
| EnableDirectory | X | |||
| GetAppliedSchemaVersion | X | |||
| GetDirectory | X | |||
| GetFacet | X | |||
| GetLinkAttributes | X | X | ||
| GetObjectAttributes | X | X | ||
| GetObjectInformation | X | X | ||
| GetSchemaAsJson | X | |||
| GetTypedLinkFacetInformation | X | |||
| ListAppliedSchemaArns | X | |||
| ListAttachedIndices | X | X | ||
| ListDevelopmentSchemaArns | X | |||
| ListDirectories | X | |||
| ListFacetAttributes | X | |||
| ListFacetNames | X | |||
| ListIncomingTypedLinks | X | X | ||
| ListIndex | X | X | ||
| ListManagedSchemaArns | X | |||
| ListObjectAttributes | X | X | ||
| ListObjectChildren | X | X | ||
| ListObjectParentPaths | X | |||
| ListObjectParents | X | X | ||
| ListObjectPolicies | X | X | ||
| ListOutgoingTypedLinks | X | X | ||
| ListPolicyAttachments | X | X | ||
| ListPublishedSchemaArns | X | |||
| ListTagsForResource | X | |||
| ListTypedLinkFacetAttributes | X | |||
| ListTypedLinkFacetNames | X | |||
| LookupPolicy | X | |||
| PublishSchema | X | |||
| PutSchemaFromJson | X | |||
| RemoveFacetFromObject | X | |||
| TagResource | X | |||
| UntagResource | X | |||
| UpdateFacet | X | |||
| UpdateLinkAttributes | X | |||
| UpdateObjectAttributes | X | |||
| UpdateSchema | X | |||
| UpdateTypedLinkFacet | X | |||
| UpgradeAppliedSchema | X | |||
| UpgradePublishedSchema | X |
1 最终一致性读取 API 是在 EVENTUAL 一致性级别调用的
2 强一致性读取 API 是在 SERIALIZABLE 一致性级别调用的
3 写入 API 是按写入 API 调用次数收费的
4 元数据 API 不收费，但分类为元数据 API 调用
有关账单的附加信息，请参阅Amazon Cloud Directory 定价
