翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Cloud Directory API の使用
Amazon Cloud Directory には、Cloud Directory 機能へのプログラムによるアクセスを可能にする一連の API オペレーションが含まれています。「」を使用できます。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 からデータを読み取る場合は、オペレーションのタイプとして、結果的に整合性のある読み込み、または強い整合性のある読み込みのいずれかを指定する必要があります。読み取りタイプは、整合性のレベルに基づきます。2 つの整合性レベルは、結果的に整合性のある読み込みの場合は EVENTUAL、強い整合性のある読み込みの場合は SERIALIZABLE です。詳細については、「整合性のレベル」を参照してください。
次の表は、すべての Cloud Directory API の一覧です。また、各 API と AWS アカウントの請求との関係を示しています。
| API | 結果的に整合性のある読み込み 1 | 強力な整合性のある読み込み 2 | 書き込み 3 | メタデータ 4 |
|---|---|---|---|---|
| AddFacetToObject | X | |||
| ApplySchema | X | |||
| AttachObject | X | |||
| AttachPolicy | X | |||
| AttachToIndex | X | |||
| AttachTypedLink | X | |||
| バッチ読み取り | X | X | ||
| バッチ書き込み | 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 料金表
