Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Accesso agli oggetti

Puoi accedere agli oggetti in una directory tramite un percorso o tramite objectIdentifier.

Percorso— ogni oggetto in una struttura Cloud Directory può essere identificato e individuato tramite il nome di percorso che descrive come raggiungerlo. Il percorso inizia dalla radice della directory (Nodo 000 nella figura precedente). La notazione del percorso inizia con il collegamento contrassegnato con una barra (/) e segue i collegamenti figli separati dal separatore di percorso (anch'esso una barra) fino a raggiungere l'ultima parte del percorso. Ad esempio, l'oggetto 005 nella figura precedente può essere identificato tramite il percorso /group/a/d. Più percorsi possono identificare un oggetto, in quanto gli oggetti che sono nodi foglia possono avere più padri. Il percorso seguente può essere utilizzato anche per identificare l'oggetto 005 : /group/b/e

ObjectiDentifier— ciascun oggetto della directory ha un identificatore globale univoco, ovvero l'ObjectIdentifier: .ObjectIdentifierviene restituito come parte dellaCreateObjectChiamata API. Puoi inoltre recuperare l'ObjectIdentifier tramite la chiamata API GetObjectInformation. Ad esempio, per recuperare l'identificatore di oggetto dell'oggetto 005, puoi chiamare GetObjectInformation con riferimento dell'oggetto come percorso che porta all'oggetto, ovvero group/b/e o group/a/d.

GetObjectInformationRequest request = new GetObjectInformationRequest()
    .withDirectoryArn(directoryArn)
    .withObjectReference("/group/b/e")
    .withConsistencyLevel(level)
GetObjectInformationResult result = cdClient.getObjectInformation(request)
String objectIdentifier = result.getObjectIdentifier()

Popolamento degli oggetti

Nuovi facet possono essere aggiunti a un oggetto tramite la chiamata API AddFacetToObject. Il tipo di oggetto viene determinato in base ai facet collegati all'oggetto. L'allegato dell'oggetto in una directory funziona in base al tipo dell'oggetto. Quando colleghi un oggetto, tieni presente queste regole:

Aggiornamento di oggetti

Puoi aggiornare un oggetto in più modi:

Eliminazione di oggetti

Un oggetto collegato deve soddisfare determinate condizioni prima di poterlo eliminare da una directory:

Poiché un oggetto deve essere distaccato completamente dalla struttura per essere eliminato, è necessario utilizzare l'identificatore dell'oggetto per poterlo eliminare.

Esecuzione di query sugli oggetti

Questa sezione illustra vari elementi rilevanti per l'esecuzione di query sugli oggetti all'interno di una directory.

Attraversamento di directory

Poiché Cloud Directory è una struttura, puoi eseguire query sugli oggetti dall'alto verso il basso tramite l'ListObjectChildrenoperazione API o dal basso verso l'alto utilizzando il metodoListObjectParentsOperazione API.

Ricerca di policy

Considerando un riferimento dell'oggetto, l'operazione API LookupPolicy restituisce tutte le policy collegate lungo il suo percorso (o i percorsi) verso la radice procedendo dall'alto verso il basso. Tutti i percorsi non relativi alla radice verranno ignorati. Vengono restituiti tutti gli oggetti di tipo policy.

Se l'oggetto è un nodo foglia, può presentare più percorsi verso la radice. Questa chiamata restituisce un solo percorso per ciascuna chiamata. Per recuperare percorsi aggiuntivi, utilizza il token di paginazione.

Esecuzione di query sugli indici

Cloud Directory supporta una ricca funzionalità di esecuzione di query sugli indici con l'uso dei seguenti intervalli:

Elenco dei percorsi padre

Tramite la chiamata API ListObjectParentPaths, puoi recuperare tutti i percorsi padre disponibili per qualsiasi tipo di oggetto (nodo, nodo foglia, nodo di policy, nodo di indice). Questa operazione API può essere utile quando è necessario valutare tutti i padri di un oggetto. La chiamata restituisce tutti gli oggetti dalla directory radice fino all'oggetto richiesto. Restituisce inoltre il numero di percorsi basati MaxResults definito dall'utente, in caso di più percorsi verso il padre. L'ordine dei percorsi e dei nodi restituiti è coerente tra più chiamate API, a meno che gli oggetti vengano eliminati o spostati. I percorsi non relativi alla directory radice verranno ignorati dall'oggetto di destinazione.

Per un esempio su tale funzionamento, presupponiamo che una directory presenti una gerarchia di oggetti simile all'illustrazione riportata di seguito.

Le forme numerati rappresentano i diversi oggetti. Il numero di frecce tra l'oggetto e la directory radice (000) rappresentano il percorso completo che verrà espresso nell'output. La tabella seguente mostra le richieste e le risposte dalle query effettuate a oggetti nodo foglia specifici della gerarchia.