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

オブジェクトへのアクセス

ディレクトリのオブジェクトは、パス、または objectIdentifier を使用してアクセスできます。

パス— Cloud Directory ツリー内の各オブジェクトは、到達する方法を示すパス名を使用して特定し、表示することができます。パスの開始地点は、ディレクトリのルート (前述の図のノード 000) です。パス表記は、スラッシュ (/) でラベル付けしたリンクから開始し、パスの末尾まで、パスの区切り文字 (スラッシュを含む) で区切られた子リンクが続きます。たとえば、前に示した図のオブジェクト 005 は、パス /group/a/d を使用して特定できます。オブジェクトがリーフノードの場合は複数の親が存在するため、複数のパスでオブジェクトを識別する場合があります。また、以下のパスを使用して、オブジェクト 005 : /group/b/e を識別することもできます。

オブジェクト識別子— ディレクトリの各オブジェクトには、一意のグローバル識別子 () が割り当てられています。ObjectIdentifier。ObjectIdentifier「」の一部として、が返ります。CreateObjectAPI コールを使用します。また、「ObjectIdentifier」の API コールを使用して、GetObjectInformation を取得することもできます。たとえば、オブジェクト 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()

オブジェクトの追加

新しいファセットをオブジェクトに追加するには、「AddFacetToObject」の API コールを使用します。オブジェクトタイプは、オブジェクトにアタッチされたファセットに基づいて判断されます。ディレクトリのオブジェクトアタッチメントは、オブジェクトタイプに基づいて使用できます。オブジェクトをアタッチするときは、次のルールに注意してください。

オブジェクトの更新

オブジェクトは、複数の方法で更新できます。

オブジェクトの削除

アタッチされたオブジェクトをディレクトリから削除するには、一定の条件を満たしている必要があります。

オブジェクトは削除するツリーから完全にデタッチされているため、オブジェクト識別子を使用して削除する必要があります。

オブジェクトのクエリ

このセクションでは、ディレクトリ内のオブジェクトのクエリに関連するさまざまな要素について説明します。

ディレクトリのトラバーサル

Cloud Directory はツリー構造になっているため、上部から、オブジェクトのクエリを行うことができます。ListObjectChildrenAPI 操作を使用するか、ListObjectParentsAPI オペレーション。

ポリシーの検索

オブジェクトリファレンスを指定すると、「LookupPolicy」 API オペレーションでルートへのパスに沿ってアタッチされているすべてのポリシーが上位から返ります。ルートに到達しないパスはすべて無視されます。ポリシータイプのオブジェクトがすべて返ります。

オブジェクトがリーフノードの場合は、複数のパスをルートに含めることができます。この呼び出しでは、各呼び出しのパスが 1 つのみ返ります。追加のパスを取得するには、ページ分割トークンを使用します。

インデックスのクエリ実行

クラウドディレクトリでは、次の範囲を使用してインデックスのクエリを行う豊富な機能を使用できます。

親パスの表示

「ListObjectParentPaths」の API コールを使用して、すべてのオブジェクトタイプ (ノード、リーフノード、ポリシーノード、インデックスノード) で利用できる親パスをすべて取得できます。この API オペレーションは、オブジェクトのすべての親を評価する必要がある場合に役立ちます。この呼び出しでは、リクエストされたオブジェクトまで、ディレクトリルートからすべてのオブジェクトを返します。また、親までに複数のパスが存在する場合は、ユーザーが定義した MaxResults に基づき、パス数を返します。返されるパスおよびノードの順序は、オブジェクトが削除または移動されている場合を除き、複数の API コール間で一貫しています。ディレクトリルートにつながらないパスは、ターゲットオブジェクトから無視されます。

この仕組みに関する一例として、ディレクトリには、以下の図のようなオブジェクト階層があります。

番号付きの形状は、オブジェクトが異なることを意味します。このオブジェクトとディレクトリルート (000) の間にある矢印数は、完全なパスを表しており、出力で表現されます。階層内の特定のリーフノードオブジェクトへのクエリのリクエストおよびレスポンスを以下のテーブルに示します。