本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
使用 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
-
批次讀取、批次寫入
API 的計費方 Cloud Directory
API 呼叫的計費會因所進行之 API 呼叫的特定類型而有所不同。最終一致讀取 API 呼叫、強式一致讀取 API 呼叫與寫入 API 呼叫會有特定的計費費率。中繼資料 API 呼叫是免費的。
強式一致操作可在讀取值時用於寫入後讀取一致性。最終一致操作可在更新執行時用於擷取值。在最終一致操作中，由於您讀取值的特定主機仍在處理更新，因此擷取的結果可能不是最準確的。不過，當您擷取效能呼叫時，這類讀取操作的延遲會很低。
當您從 Cloud Directory 讀取資料時，您必須指定最終一致讀取或強式一致讀取類型操作。讀取類型取決於一致性層級。這兩個一致性層級為適用於最終一致讀取的 EVENTUAL 與適用於強式一致讀取的 SERIALIZABLE。如需詳細資訊，請參閱 一致性層級。
下表列出所有 Cloud Directory 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 定價
