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à.
Links
Un collegamento è un confine diretto tra due oggetti che definiscono una relazione. Cloud Directory supporta attualmente i seguenti tipi di collegamento.
Collegamenti figli
Un collegamento figlio crea una relazione padre-figlio tra gli oggetti che collega. Ad esempio, nella precedente illustrazione, il collegamento figlio b connette oggetti 001 e 003. I collegamenti figli definiscono la gerarchia nella Cloud Directory. I collegamenti figli dispongono di nomi se partecipano nella definizione del percorso dell'oggetto al quale il collegamento punta.
Collegamenti di allegati
Un collegamento di allegati applica un oggetto di policy nodo foglia a un altro nodo foglia o a un altro oggetto nodo. I collegamenti di allegati non definiscono la struttura gerarchica della Cloud Directory. Ad esempio, nella figura precedente, il collegamento di allegati applica la policy archiviata nell'oggetto nodo foglia della policy 006 sull'oggetto nodo 002 . Ogni oggetto può avere più policy collegate ma non può essere collegata più di una policy di qualsiasi tipo di policy.
Collegamenti di indici
I collegamenti di indici forniscono una ricca ricerca di informazioni sulla base di un oggetto di indice e degli attributi indicizzati definiti, abilitando attraversamenti e ricerche della struttura all'interno delle strutture di directory. Concettualmente, gli indici sono simili ai nodi con figli: I collegamenti ai nodi indicizzati sono etichettati sulla base degli attributi indicizzati, piuttosto che ricevere un'etichetta al collegamento del figlio. Tuttavia, i collegamenti dell'indice non sono confini padre-figlio. Essi dispongono inoltre del proprio set di operazioni API di enumerazione. Per ulteriori informazioni, consulta Indicizzazione e ricerca.
Collegamenti tipizzati
I collegamenti tipizzati consentono di stabilire una relazione tra gli oggetti all'interno o tra gerarchie in Cloud Directory. È quindi possibile utilizzare queste relazioni per eseguire query e ottenere informazioni, ad esempio Quali utenti hanno il dispositivo "xyz" o Quali dispositivi sono di proprietà dell'utente "abc".
Puoi utilizzare collegamenti tipizzati per modellare relazioni tra oggetti differenti della directory. Ad esempio, nell'illustrazione sopra riportata, considera la relazione tra l'oggetto 004, che rappresenta un utente, e l'oggetto 005, che rappresenta un dispositivo.
Possiamo utilizzare un collegamento tipizzato per modellare una relazione di proprietà tra i due oggetti. Possiamo aggiungere attributi ai collegamenti tipizzati che rappresentino il costo di acquisto o se il dispositivo è in affitto o è stato acquistato. Esistono due tipi di attributi associati ai collegamenti tipizzati:
-
Attributi basati sulle identità – Un attributo di un collegamento tipizzato che lo distingue da altri collegamenti (ad esempio, collegamenti figlio, allegato, indice). Ogni facet del collegamento tipizzato definisce un set ordinato di attributi di identità. L'identità di un collegamento tipizzato è l'id dell'oggetto di origine, un identificatore del facet (tipo), i valori degli attributi di identità (definiti dal facet) e l'id dell'oggetto di destinazione. Gli identificatori devono essere univoci all'interno di una singola directory.
-
Attributi opzionali - Attributo che memorizza le caratteristiche di localizzazione del collegamento tipizzato che non sono correlate all'identità del link. Ad esempio, un attributo opzionale potrebbe identificare la data in cui il collegamento tipizzato è stato per la prima volta stabilito o modificato per l'ultima volta.
Come per gli oggetti, è necessario creare un facet di un collegamento tipizzato utilizzando l'API CreateTypedLinkFacet per definire la struttura del collegamento tipizzato e i relativi attributi. I facet dei collegamenti tipizzati richiedono un nome facet e un set di attributi univoci associati al collegamento. Durante la progettazione della struttura del collegamento tipizzato, è possibile definire un set ordinato di attributi sul facet del collegamento tipizzato. Per visualizzare uno schema di esempio di collegamenti tipizzati, consulta Documento dello schema con link tipizzati.
Gli attributi dei collegamenti tipizzati possono essere utilizzati quando devi eseguire le operazioni seguenti:
-
Consenti il filtraggio dei collegamenti tipizzati in entrata e in uscita. Per ulteriori informazioni, consulta Elenco dei collegamenti tipizzati.
-
Rappresenta la relazione tra due oggetti.
-
Registra i dati amministrativi sul collegamento tipizzato, ad esempio la data in cui il collegamento è stato creato.
Tieni in considerazione quanto segue quando decidi se i collegamenti tipizzati sono giusti per il tuo caso d'uso:
-
I collegamenti tipizzati non possono essere utilizzati nelle specificazioni di oggetti basati sul percorso. Al contrario, è necessario selezionare collegamenti tipizzati utilizzando l'operazione API
ListOutgoingTypedLinksoListIncomingTypedLinks. -
I collegamenti tipizzati non partecipano alle operazioni API
LookupPolicyoListObjectParentPaths. -
I collegamenti tipizzati tra due stessi oggetti e nella stessa direzione potrebbero non avere gli stessi valori di attributo. Questo può aiutare a evitare collegamenti tipizzati duplicati tra gli stessi oggetti.
-
Gli attributi aggiuntivi possono essere utilizzati per aggiungere informazioni facoltative.
-
La dimensione combinata di tutti i valori di attributo di identità si limita a 64 byte. Per ulteriori informazioni, consulta I limiti della Amazon Cloud Directory.
Articolo del blog della Cloud Directory correlato
Identità dei collegamenti tipizzati
L'identità è ciò che definisce univocamente se un collegamento tipizzato può esistere tra due oggetti. La sola eccezione è quando connetti due oggetti in una direzione con esattamente gli stessi valori di attributo. Gli attributi devono essere configurati come REQUIRED_ALWAYS.
I collegamenti tipizzati che vengono creati da diversi facet di collegamenti tipizzati non sono mai in conflitto tra loro. Ad esempio, considera il diagramma seguente:
-
L'oggetto
001dispone di collegamenti tipizzati e di attributi (A1 e A2) con gli stessi valori di attributo (x1 e x2) che vanno su oggetti differenti (002e003). Questa operazione dovrebbe andare a buon fine. -
Gli oggetti
002e003hanno tra loro un collegamento tipizzato. Questa operazione avrebbe esito negativo perché due collegamenti tipizzati nella stessa direzione e con gli stessi attributi non possono esistere tra oggetti. -
Gli oggetti
001e003hanno tra loro due collegamenti tipizzati con gli stessi attributi. Tuttavia, poiché i collegamenti vanno in direzioni diverse, questa operazione dovrebbe avere esito positivo. -
Gli oggetti
002e003hanno tra loro collegamenti tipizzati con lo stesso valore per A1, ma con valori diversi per A2. Poiché l'identità dei collegamenti tipizzati considera tutti gli attributi, questa operazione dovrebbe avere esito positivo.
Regole dei collegamenti tipizzati
Puoi aggiungere regole agli attributi di collegamenti tipizzati quando desideri aggiungere limitazioni agli attributi di collegamenti. Queste regole sono uguali alle regole degli attributi dell'oggetto. Per ulteriori informazioni, consulta Regole di attributi.
Elenco dei collegamenti tipizzati
Cloud Directory fornisce le operazioni API che puoi utilizzare per selezionare collegamenti tipizzati in entrata e in uscita da un oggetto. Puoi selezionare una sottorete specifica di collegamenti tipizzati invece di scorrere tutti i collegamenti tipizzati. Puoi specificare anche un particolare facet di un collegamento tipizzato per filtrare solo i collegamenti tipizzati di quel tipo.
Puoi filtrare i collegamenti tipizzati sulla base dell'ordine con cui gli attributi sono definiti sul facet del collegamento tipizzato. Puoi fornire filtri di intervallo per attributi multipli. Quando fornisci intervalli per una selezione di collegamenti tipizzati, gli intervalli non corretti devono essere specificati alla fine. Tutti gli attributi senza alcun intervallo specificato corrispondono all'intero intervallo. I filtri vengono interpretati nell'ordine in cui gli attributi vengono definiti sul facet di collegamento tipizzato e non nell'ordine in cui vengono forniti alle chiamate API.
Ad esempio, nel seguente diagramma, considera una Cloud Directory utilizzata per archiviare le informazioni sui dipendenti e le loro abilità.
Supponiamo di modellare le capacità dei dipendenti tramite un collegamento tipizzato denominato EmployeeCapability, configurato con tre attributi di stringa: Status, Role e Created. I seguenti filtri sono supportati su ListIncomingTypedLinks e sulle operazioni API ListOutgoingTypedLinks .
-
Facet =
EmployeeCapability, stato =Active, ruolo =Driver-
Seleziona i dipendenti attivi che sono conducenti. Questo filtro include due corrispondenze esatte.
-
-
Facet =
EmployeeCapability, stato =Active, ruolo =Driver, creato =05/31/18-
Seleziona i dipendenti attivi che sono conducenti e i facet creati il o dopo il 31 maggio 2018.
-
-
Facet =
EmployeeCapability, stato =Active-
Seleziona tutti i dipendenti attivi.
-
-
Facet =
EmployeeCapability, stato =Active, ruolo =AaM-
Seleziona i dipendenti attivi con ruoli a partire da
AattraversoM.
-
-
Facet =
EmployeeCapability-
Seleziona tutti i collegamenti tipizzati del tipo
EmployeeCapability.
-
I filtri seguenti NON sono supportati:
-
Facet =
EmployeeCapability, stato traAeC, ruolo =Driver-
Questo filtro non è consentito in quanto eventuali intervalli devono comparire alla fine del filtro.
-
-
Facet =
EmployeeCapability, ruolo =Driver-
Questo filtro non è consentito in quanto l'intervallo di stato implicito non è una corrispondenza esatta e non compare alla fine dell'elenco di intervalli.
-
-
Stato =
Active-
Questo filtro non è consentito in quanto il facet del collegamento tipizzato non è specificato.
-
Schema di collegamenti tipizzati
Puoi creare facet di collegamento tipizzati in due modi. Puoi gestire i tuo facet di collegamento tipizzati da singole chiamate API, tra cui CreateTypedLinkFacet, DeleteTypedLinkFacet e UpdateTypedLinkFacet. È inoltre possibile caricare un documento in formato JSON che rappresenta lo schema in una singola chiamata API PutSchemaFromJson. Per ulteriori informazioni, consulta Formato di schemi JSON. Per visualizzare uno schema di esempio di collegamenti tipizzati, consulta Documento dello schema con link tipizzati.
I tipi di modifiche consentite in diverse fasi del ciclo di vita di sviluppo di uno schema sono simili alle modifiche consentite per la manipolazione di facet di oggetti. Gli schemi in stato di sviluppo supportano tutte le modifiche. Gli schemi in stato di pubblicazione non sono modificabili e non è supportata alcuna modifica. Sono consentite solo alcune modifiche agli schemi applicate a una directory di dati. Una volta impostato l'ordine e gli attributi su un facet di collegamento tipizzato applicato, tale ordine non può essere modificato.
Due altri facet di elenco di operazioni API e i relativi attributi:
Interazione di collegamenti tipizzati
Una volta creato un facet di collegamento tipizzato, sei pronto per iniziare a creare e a interagire con i collegamenti tipizzati. Per collegare e scollegare i collegamenti tipizzati, utilizza le operazioni API AttachTypedLink e DetachTypedLink.
L'operazione TypedLinkSpecifier è una struttura contenente tutte le informazioni per identificare in modo univoco un collegamento tipizzato. All'interno di tale struttura puoi individuare TypedLinkFacet, SourceObjectID, DestinationObjectID e IdentityAttributeValues. Queste informazioni vengono utilizzate unicamente per specificare il collegamento tipizzato su cui è svolta l'operazione. L'operazione API AttachTypedLink restituisce un identificatore del collegamento tipizzato, mentre l'operazione API DetachTypedLink ne accetta uno come input. Analogamente, le operazioni ListIncomingTypedLinks e le ListOutgoingTypedLinks API forniscono identificatori di collegamento tipizzati come output. Puoi inoltre creare un identificatore di collegamento tipizzato da zero. L'elenco completo delle operazioni API relative ai collegamenti tipizzati include quanto segue:
Nota
Non sono supportati i riferimenti di attributo e i collegamenti tipizzati di aggiornamento. Per aggiornare un collegamento tipizzato, è necessario rimuoverlo e aggiungere la versione aggiornata.
