翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Directory
<a name="key_concepts_directory"></a>

ディレクトリは、複数階層構造で編成された特定のタイプのオブジェクトを含むスキーマベースのデータストアです (詳細については、「[ディレクトリ構造](key_concepts_directorystructure.md)」を参照)。たとえば、ユーザーのディレクトリは、構造、場所、およびプロジェクト所属の報告に基づいて階層表示を提供することができます。同様に、デバイスのディレクトリは、その製造元、現在の所有者、および物理的な場所に基づいて、複数の階層表示を持つことができます。

ディレクトリは、データストアの論理境界を定義し、サービス内の他のすべてのディレクトリと完全に分離します。また、個別リクエストの境界を定義します。単一のトランザクションまたはクエリは、単一のディレクトリのコンテキスト内で実行されます。スキーマなしでディレクトリを作成することはできず、通常はスキーマが 1 つ適用されます。ただし、Cloud Directory API 操作を使用して、ディレクトリに追加のスキーマを適用します。詳細については、「」を参照してください。[https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_ApplySchema.html](https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_ApplySchema.html)()*Amazon Cloud Directory API リファレンスガイド*。

## Objects
<a name="key_concepts_objects"></a>

オブジェクトは、ディレクトリ内の構造化されたデータエンティティです。ディレクトリ内のオブジェクトは、通常、情報の発見やポリシーの実施を目的として、物理エンティティまたは論理エンティティに関するメタデータ (または属性) を取得することを目的としています。たとえば、ユーザー、デバイス、アプリケーション、AWS アカウント、EC2 インスタンス、Amazon S3 バケットはすべて、ディレクトリ内のさまざまなタイプのオブジェクトとして表現できます。

オブジェクトの構造と型情報は、ファセットの集合として表現されます。`Path` または `ObjectIdentifier` を使ってオブジェクトにアクセスできます。オブジェクトには、メタデータのユーザー定義の単位である属性も含めることができます。たとえば、ユーザーオブジェクトは *email-address* と呼ばれる属性を持つことができます。属性は常にオブジェクトに関連付けられます。

## Policies
<a name="key_concepts_policies"></a>

ポリシーは、アクセス権限や機能を格納するのに便利な特別な種類のオブジェクトです。ポリシーは、[https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_LookupPolicy.html](https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_LookupPolicy.html) API アクションを提供します。参照ポリシーアクションは、任意のオブジェクトを開始入力として参照します。次に、ディレクトリからルートに移動します。このアクションは、ルートへの各パスで遭遇する すべてのポリシーオブジェクトを収集します。クラウドディレクトリは、これらのポリシーのいずれも解釈しません。代わりに、クラウドディレクトリユーザーは、独自の特殊なビジネスロジックを使用してポリシーを解釈します。

たとえば、従業員の情報を格納するシステムを想像してみてください。従業員は職務機能によってグループ化されます。人事部門と経理部門のメンバーに対して異なる権限を設定したいと考えています。人事部門のメンバーは給与情報にアクセスでき、経理部門は元帳情報にアクセスできます。これらの権限を確立するには、これらの各グループにポリシーをアタッチします。ユーザーのアクセス権限を評価するときは、そのユーザーのオブジェクトに対して `LookupPolicy` API アクションを使用できます。-`LookupPolicy`API アクションは、ツリー上を、指定されたポリシーオブジェクトからルートまで移動します。ノードごとに停止して、アタッチされているポリシーがあるか確認し、あれば返します。

**ポリシーのアタッチメント**

ポリシーは、通常の親子アタッチメントと特別なポリシーアタッチメントの 2 つの方法で他のオブジェクトにアタッチできます。通常の親子アタッチメントを使用して、親ノードにポリシーをアタッチすることができます。これは、データディレクトリ内のポリシーを見つけるための簡単なメカニズムを提供するのに便利です。ポリシーは子を持つことはできません。`LookupPolicy` API コール中に、親子アタッチメントを介してアタッチされたポリシーは返されません。

ポリシーオブジェクトは、ポリシーのアタッチメントを介して他のオブジェクトにもアタッチできます。これらのポリシーのアタッチメントは、[https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_AttachPolicy.html](https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_AttachPolicy.html) API アクションおよび [https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_DetachPolicy.html](https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_DetachPolicy.html) API アクションを使用して管理できます。ポリシーのアタッチメントを使用すると、LookupPolicy API を使用するときにポリシーノードを配置できます。

**ポリシースキーマの仕様**

ポリシーの使用を開始するには、まずポリシーの作成をサポートするファセットをスキーマに追加する必要があります。これを実現するには、ファセットを作成し、ファセットの `objectType` を POLICY に設定します。POLICY タイプのファセットを使用してオブジェクトを作成すると、オブジェクトにポリシー機能が確実に適用されます。

ポリシーファセットは、ユーザーが定義に追加した属性に加えて、以下の 2 つの属性を継承します。
+ **policy\$1type** (文字列、必須) – これは、複数の異なるポリシーの使用を区別するために指定できる識別子です。ポリシーが論理的に明確なカテゴリに該当する場合は、ポリシータイプ属性を適切に設定することをお勧めします。`LookupPolicy` API は、アタッチされたポリシーのポリシータイプを返します (「[https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_PolicyAttachment.html](https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_PolicyAttachment.html)」を参照)。これにより、探している特定のポリシータイプを簡単にフィルタリングできます. policy\$1type を使用して、ドキュメントを処理または解釈する方法も判断できます。
+ **policy\$1document** (バイナリ、必須) – この属性には、アプリケーション固有のデータ (ポリシーに関連付けられたアクセス権限の付与など) を保存できます。必要に応じて、アプリケーション関連のデータをファセットの通常の属性に保存することもできます。

**Policy API の概要**

ポリシーの操作には、さまざまな特殊な API アクションを使用できます。使用可能なオペレーションのリストについては、[[Amazon クラウドディレクトリのアクション](https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_Operations.html)] を参照してください。

ポリシーオブジェクトを作成するには、[https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_CreateObject.html](https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_CreateObject.html) API アクションを適切なファセットと共に使用します。
+ オブジェクトのポリシーをアタッチまたはデタッチするには、`AttachPolicy` アクションと `DetachPolicy` アクションをそれぞれ使用します。
+ ツリー上のオブジェクトにアタッチされているポリシーを検索するには、`LookupPolicy` API アクションを使用します。
+ 特定のオブジェクトにアタッチされているポリシーを表示するには、[https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_ListObjectPolicies.html](https://docs.aws.amazon.com/clouddirectory/latest/APIReference/API_ListObjectPolicies.html) API アクションを使用します。

操作のリストと、各 API アクションを実行するための必要な権限については、「[Amazon Cloud Directory API のアクセス許可: アクション、リソース、条件リファレンス](iam_auth_access_usingwith_iam_resourcepermissions.md)」 を参照してください。