Operazioni di base per Amazon QLDB Ledger - Database Amazon Quantum Ledger (Amazon) QLDB
Creare un libro mastroDescrivere un libro mastroAggiornamento di un libro mastroAggiornamento di una modalità di autorizzazione del registroEliminazione di un libro mastroElencare i libri mastri

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à.

Operazioni di base per Amazon QLDB Ledger

Importante

Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto il 31/07/2025. Per ulteriori dettagli, consulta Migrare un Amazon QLDB Ledger ad Amazon Aurora Postgre. SQL

Puoi utilizzare QLDB API o il AWS Command Line Interface (AWS CLI) per creare, aggiornare ed eliminare i registri in AmazonQLDB. Puoi anche elencare tutti i registri del tuo account o ottenere informazioni su un registro specifico.

I seguenti argomenti forniscono brevi esempi di codice che mostrano i passaggi più comuni per le operazioni sui libri contabili utilizzando and the AWS SDK for Java . AWS CLI

Per esempi di codice che illustrano queste operazioni in un'applicazione di esempio completa, consulta i Guida introduttiva al driver tutorial e gli archivi seguenti: GitHub

Creare un libro mastro

Usa l'CreateLedgeroperazione per creare un libro mastro nel tuo. Account AWSÈ necessario fornire le seguenti informazioni:

  • Nome libro contabile: il nome del libro contabile che desideri creare nel tuo account. Il nome deve essere univoco tra tutti i registri correnti. Regione AWS

    I vincoli di denominazione per i nomi dei libri contabili sono definiti in. Quote e limiti in Amazon QLDB

  • Modalità autorizzazioni: la modalità di autorizzazione da assegnare al registro. Selezionare una delle seguenti opzioni:

    • Consenti tutti: una modalità di autorizzazioni legacy che consente il controllo degli accessi con API granularità a livello di granularità per i registri.

      Questa modalità consente agli utenti che dispongono dell'SendCommandAPIautorizzazione per questo registro di eseguire tutti i comandi PartiQL (quindiALLOW_ALL) su qualsiasi tabella nel registro specificato. Questa modalità ignora qualsiasi politica di IAM autorizzazione a livello di tabella o di comando creata per il registro.

    • Standard: (consigliata) Una modalità di autorizzazione che consente il controllo degli accessi con una granularità più precisa per registri, tabelle e comandi PartiQL. Consigliamo vivamente di utilizzare questa modalità di autorizzazione per massimizzare la sicurezza dei dati del registro.

      Per impostazione predefinita, questa modalità nega tutte le richieste di esecuzione di comandi PartiQL su qualsiasi tabella in questo registro. Per consentire i comandi PartiQL, è necessario creare politiche di IAM autorizzazione per specifiche risorse di tabella e azioni PartiQL, oltre all'autorizzazione per il SendCommand API registro. Per informazioni, consulta Guida introduttiva alla modalità di autorizzazione standard in Amazon QLDB.

  • Protezione dall'eliminazione: (Facoltativo) Il contrassegno che impedisce l'eliminazione di un registro da parte di qualsiasi utente. Se non lo specifichi durante la creazione del registro, questa funzionalità è abilitata (true) per impostazione predefinita.

    Se la protezione dall'eliminazione è abilitata, è necessario innanzitutto disabilitarla prima di poter eliminare il libro mastro. È possibile disabilitarla utilizzando l'UpdateLedgeroperazione per impostare il flag su. false

  • AWS KMS key— (Facoltativo) La chiave in AWS Key Management Service (AWS KMS) da utilizzare per la crittografia dei dati inattivi. Scegliete uno dei seguenti tipi di AWS KMS keys:

    • AWS KMSchiave di proprietà: utilizza una KMS chiave posseduta e gestita da per tuo AWS conto.

      Se non definisci questo parametro durante la creazione del libro contabile, il libro contabile utilizza questo tipo di chiave per impostazione predefinita. È inoltre possibile utilizzare la stringa AWS_OWNED_KMS_KEY per specificare questo tipo di chiave. Questa opzione non richiede alcuna configurazione aggiuntiva.

    • KMSChiave gestita dal cliente: utilizza una KMS chiave di crittografia simmetrica nel tuo account che crei, possiedi e gestisci. QLDBnon supporta le chiavi asimmetriche.

      Questa opzione richiede la creazione di una KMS chiave o l'utilizzo di una chiave esistente nel tuo account. Per istruzioni sulla creazione di una chiave gestita dal cliente, consulta Creazione di KMS chiavi di crittografia simmetriche nella Guida per gli AWS Key Management Service sviluppatori.

      Puoi specificare una KMS chiave gestita dal cliente utilizzando un ID, un alias o Amazon Resource Name (ARN). Per ulteriori informazioni, consulta Key identifiers (KeyId) nella AWS Key Management Service Developer Guide.

      Nota

      Le chiavi interregionali non sono supportate. La KMS chiave specificata deve trovarsi nella Regione AWS stessa cartella del registro.

    Per ulteriori informazioni, consulta Crittografia inattiva in Amazon QLDB.

  • Tag: (Facoltativo) Aggiungi metadati al registro allegando i tag come coppie chiave-valore. Puoi aggiungere tag al libro mastro per organizzarli e identificarli. Per ulteriori informazioni, consulta Etichettare le risorse Amazon QLDB.

Il libro mastro non è pronto per l'uso finché non lo QLDB crea e ne imposta lo stato su. ACTIVE

Per creare un libro mastro utilizzando il AWS SDK for Java

  1. Creare un'istanza della classe AmazonQLDB.

  2. Crea un'istanza della classe CreateLedgerRequest per fornire le informazioni della richiesta.

    È necessario fornire il nome del libro contabile e una modalità di autorizzazione.

  3. Eseguire il metodo createLedger fornendo l'oggetto della richiesta come parametro.

La createLedger richiesta restituisce un CreateLedgerResult oggetto che contiene informazioni sul registro. Vedi la sezione successiva per un esempio di utilizzo dell'DescribeLedgeroperazione per controllare lo stato del libro mastro dopo averlo creato.

Gli esempi seguenti illustrano i passaggi precedenti.

Esempio — Utilizza le impostazioni di configurazione predefinite
AmazonQLDB client = AmazonQLDBClientBuilder.standard().build();
CreateLedgerRequest request = new CreateLedgerRequest()
        .withName(ledgerName)
        .withPermissionsMode(PermissionsMode.STANDARD);
CreateLedgerResult result = client.createLedger(request);
Nota

Il registro utilizza le seguenti impostazioni predefinite se non le specificate:

  • Protezione da eliminazione: abilitata (true).

  • KMSchiave: KMS chiave AWS proprietaria.

Esempio — Disattiva la protezione dall'eliminazione, utilizza una KMS chiave gestita dal cliente e allega tag
AmazonQLDB client = AmazonQLDBClientBuilder.standard().build();

Map<String, String> tags = new HashMap<>();
tags.put("IsTest", "true");
tags.put("Domain", "Test");

CreateLedgerRequest request = new CreateLedgerRequest()
        .withName(ledgerName)
        .withPermissionsMode(PermissionsMode.STANDARD)
        .withDeletionProtection(false)
        .withKmsKey("arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab")
        .withTags(tags);
CreateLedgerResult result = client.createLedger(request);

Crea un nuovo registro denominato vehicle-registration utilizzando le impostazioni di configurazione predefinite.

Esempio 
aws qldb create-ledger --name vehicle-registration --permissions-mode STANDARD
Nota

Il registro utilizza le seguenti impostazioni predefinite se non le specificate:

  • Protezione da eliminazione: abilitata (true).

  • KMSchiave: KMS chiave AWS proprietaria.

In alternativa, crea un nuovo registro denominato vehicle-registration con la protezione dall'eliminazione disattivata, con una KMS chiave gestita dal cliente specificata e con tag specifici.

Esempio 
aws qldb create-ledger \
    --name vehicle-registration \
    --no-deletion-protection \
    --permissions-mode STANDARD \
    --kms-key arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab \
    --tags IsTest=true,Domain=Test

Puoi anche usare un AWS CloudFormationmodello per creare libri contabili. Per ulteriori informazioni, consulta la risorsa AWS::QLDB: Ledger nella Guida per l'AWS CloudFormation utente.

Descrivere un libro mastro

Usa l'DescribeLedgeroperazione per visualizzare i dettagli su un libro mastro. È necessario fornire il nome del libro contabile. Il formato dell'output da DescribeLedger è identico a quello da CreateLedger. Include le seguenti informazioni:

  • Nome libro contabile: il nome del libro contabile che si desidera descrivere.

  • ARN— L'Amazon Resource Name (ARN) per il libro mastro nel seguente formato.

    arn:aws:qldb:aws-region:account-id:ledger/ledger-name

  • Protezione dall'eliminazione: il contrassegno che indica se la funzione di protezione dall'eliminazione è abilitata.

  • Data e ora di creazione: la data e l'ora, in formato epoch time, in cui è stato creato il libro mastro.

  • Stato: lo stato attuale del libro mastro. Può essere uno dei seguenti valori:

    • CREATING

    • ACTIVE

    • DELETING

    • DELETED

  • Modalità autorizzazioni: la modalità di autorizzazione assegnata al registro. Può essere uno dei seguenti valori:

    • ALLOW_ALL— Una modalità di autorizzazioni legacy che consente il controllo degli accessi con granularità a livello di dettaglio per i API registri.

    • STANDARD— Una modalità di autorizzazione che consente il controllo degli accessi con una maggiore granularità per registri, tabelle e comandi PartiQL.

  • Descrizione della crittografia: informazioni sulla crittografia dei dati inattivi nel registro. Ciò include i seguenti elementi:

    • AWS KMS key ARN— La ARN KMS chiave gestita dal cliente utilizzata dal registro per la crittografia inattiva. Se non è definito, il registro utilizza una KMS chiave AWS proprietaria per la crittografia.

    • Stato della crittografia: lo stato attuale della crittografia a riposo per il registro. Può essere uno dei seguenti valori:

      • ENABLED— La crittografia è completamente abilitata utilizzando la chiave specificata.

      • UPDATING— La modifica della chiave specificata viene elaborata attivamente.

        Le modifiche principali apportate QLDB sono asincrone. Il registro è completamente accessibile senza alcun impatto sulle prestazioni durante l'elaborazione della modifica chiave. Il tempo necessario per aggiornare una chiave varia a seconda delle dimensioni del registro.

      • KMS_KEY_INACCESSIBLE— La KMS chiave gestita dal cliente specificata non è accessibile e il registro è danneggiato. La chiave è stata disabilitata o eliminata oppure le concessioni sulla chiave sono state revocate. Quando un registro è danneggiato, non è accessibile e non accetta richieste di lettura o scrittura.

        Un registro danneggiato torna automaticamente allo stato attivo dopo aver ripristinato le concessioni sulla chiave o dopo aver riattivato la chiave che era disabilitata. Tuttavia, l'eliminazione di una chiave gestita dal cliente è irreversibile. KMS Dopo l'eliminazione di una chiave, non è più possibile accedere ai registri protetti con tale chiave e i dati diventano irrecuperabili in modo permanente.

    • Inaccessibile AWS KMS key: la data e l'ora, in formato epoch time, in cui la KMS chiave è diventata inaccessibile per la prima volta, in caso di errore.

      Questo valore non è definito se la KMS chiave è accessibile.

    Per ulteriori informazioni, consulta Crittografia inattiva in Amazon QLDB.

Nota

Dopo aver creato un QLDB libro mastro, questo diventa pronto per l'uso quando il suo stato cambia da aCREATING. ACTIVE

Per descrivere un libro mastro utilizzando il AWS SDK for Java

  1. Creare un'istanza della classe AmazonQLDB. In alternativa, puoi utilizzare la stessa istanza del AmazonQLDB client che hai istanziato per la richiesta. CreateLedger

  2. Create un'istanza della DescribeLedgerRequest classe e fornite il nome del registro che desiderate descrivere.

  3. Eseguire il metodo describeLedger fornendo l'oggetto della richiesta come parametro.

  4. La describeLedger richiesta restituisce un DescribeLedgerResult oggetto con informazioni correnti sul libro mastro.

Il seguente esempio di codice mostra le fasi precedenti. È possibile chiamare il describeLedger metodo del client per ottenere informazioni sul registro in qualsiasi momento.

Esempio 
AmazonQLDB client = AmazonQLDBClientBuilder.standard().build();
DescribeLedgerRequest request = new DescribeLedgerRequest().withName(ledgerName);
DescribeLedgerResult result = client.describeLedger(request);
System.out.printf("%s: ARN: %s \t State: %s \t CreationDateTime: %s \t DeletionProtection: %s
                   \t PermissionsMode: %s \t EncryptionDescription: %s",
        result.getName(),
        result.getArn(),
        result.getState(),
        result.getCreationDateTime(),
        result.getDeletionProtection(),
        result.getPermissionsMode(),
        result.getEncryptionDescription());

Descrivi il vehicle-registration libro mastro che hai appena creato.

Esempio 
aws qldb describe-ledger --name vehicle-registration

Aggiornamento di un libro mastro

L'UpdateLedgeroperazione attualmente consente di modificare le seguenti impostazioni di configurazione per un registro esistente:

  • Protezione dall'eliminazione: il contrassegno che impedisce l'eliminazione di un registro da parte di qualsiasi utente. Se questa funzionalità è abilitata, devi prima disabilitarla impostando il flag su false prima di poter eliminare il registro.

    Se non si definisce questo parametro, non viene apportata alcuna modifica all'impostazione di protezione da eliminazione del registro.

  • AWS KMS key— La chiave in AWS Key Management Service (AWS KMS) da utilizzare per la crittografia dei dati inattivi. Se non si definisce questo parametro, non viene apportata alcuna modifica alla KMS chiave del registro.

    Nota

    Amazon QLDB ha lanciato il supporto per Customer Managed il 22 AWS KMS keys luglio 2021. Tutti i registri creati prima del lancio sono protetti per impostazione Chiavi di proprietà di AWS predefinita, ma al momento non sono idonei per la crittografia a riposo utilizzando chiavi gestite dal cliente.

    È possibile visualizzare l'ora di creazione del registro sulla QLDB console.

    Utilizzare una delle opzioni seguenti:

    • AWS KMSchiave di proprietà: utilizza una KMS chiave posseduta e gestita da per tuo AWS conto. Per utilizzare questo tipo di chiave, specifica la stringa AWS_OWNED_KMS_KEY per questo parametro. Questa opzione non richiede alcuna configurazione aggiuntiva.

    • KMSChiave gestita dal cliente: utilizza una KMS chiave di crittografia simmetrica nel tuo account che crei, possiedi e gestisci. QLDBnon supporta le chiavi asimmetriche.

      Questa opzione richiede la creazione di una KMS chiave o l'utilizzo di una chiave esistente nel tuo account. Per istruzioni sulla creazione di una chiave gestita dal cliente, consulta Creazione di KMS chiavi di crittografia simmetriche nella Guida per gli AWS Key Management Service sviluppatori.

      Puoi specificare una KMS chiave gestita dal cliente utilizzando un ID, un alias o Amazon Resource Name (ARN). Per ulteriori informazioni, consulta Key identifiers (KeyId) nella AWS Key Management Service Developer Guide.

      Nota

      Le chiavi interregionali non sono supportate. La KMS chiave specificata deve trovarsi nella Regione AWS stessa cartella del registro.

    Le modifiche principali apportate QLDB sono asincrone. Il registro è completamente accessibile senza alcun impatto sulle prestazioni durante l'elaborazione della modifica chiave.

    È possibile cambiare chiave tutte le volte che è necessario, ma il tempo necessario per aggiornare una chiave varia a seconda delle dimensioni del registro. È possibile utilizzare l'DescribeLedgeroperazione per verificare lo stato della crittografia a riposo.

    Per ulteriori informazioni, consulta Crittografia inattiva in Amazon QLDB.

Il formato dell'output da UpdateLedger è identico a quello da CreateLedger.

Per aggiornare un libro mastro utilizzando il AWS SDK for Java

  1. Creare un'istanza della classe AmazonQLDB.

  2. Crea un'istanza della classe UpdateLedgerRequest per fornire le informazioni della richiesta.

    È necessario fornire il nome del libro contabile insieme a un nuovo valore booleano per la protezione dall'eliminazione o a un nuovo valore di stringa per la chiave. KMS

  3. Eseguire il metodo updateLedger fornendo l'oggetto della richiesta come parametro.

I seguenti esempi di codice illustrano i passaggi precedenti. La updateLedger richiesta restituisce un UpdateLedgerResult oggetto con informazioni aggiornate sul registro.

Esempio — Disabilita la protezione da eliminazione
AmazonQLDB client = AmazonQLDBClientBuilder.standard().build();
UpdateLedgerRequest request = new UpdateLedgerRequest()
        .withName(ledgerName)
        .withDeletionProtection(false);
UpdateLedgerResult result = client.updateLedger(request);
Esempio — Utilizza una KMS chiave gestita dal cliente
AmazonQLDB client = AmazonQLDBClientBuilder.standard().build();
UpdateLedgerRequest request = new UpdateLedgerRequest()
        .withName(ledgerName)
        .withKmsKey("arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab")
UpdateLedgerResult result = client.updateLedger(request);
Esempio — Usa una KMS chiave AWS proprietaria
AmazonQLDB client = AmazonQLDBClientBuilder.standard().build();
UpdateLedgerRequest request = new UpdateLedgerRequest()
        .withName(ledgerName)
        .withKmsKey("AWS_OWNED_KMS_KEY")
UpdateLedgerResult result = client.updateLedger(request);

Se sul vehicle-registration registro è abilitata la protezione da eliminazione, devi prima disabilitarlo prima di poterlo eliminare.

Esempio 
aws qldb update-ledger --name vehicle-registration --no-deletion-protection

Puoi anche modificare le impostazioni di crittografia a riposo del registro per utilizzare una chiave gestita KMS dal cliente.

Esempio 
aws qldb update-ledger --name vehicle-registration --kms-key arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

In alternativa, puoi modificare le impostazioni di crittografia a riposo per utilizzare una KMS chiave AWS proprietaria.

Esempio 
aws qldb update-ledger --name vehicle-registration --kms-key AWS_OWNED_KMS_KEY

Aggiornamento di una modalità di autorizzazione del registro

L'UpdateLedgerPermissionsModeoperazione consente di modificare la modalità di autorizzazione di un registro esistente. Selezionare una delle seguenti opzioni:

  • Consenti tutto: una modalità di autorizzazioni legacy che consente il controllo degli accessi con granularità a API livello di dettaglio per i registri.

    Questa modalità consente agli utenti che dispongono dell'SendCommandAPIautorizzazione per questo registro di eseguire tutti i comandi PartiQL (quindiALLOW_ALL) su qualsiasi tabella nel registro specificato. Questa modalità ignora qualsiasi politica di IAM autorizzazione a livello di tabella o di comando creata per il registro.

  • Standard: (consigliata) Una modalità di autorizzazione che consente il controllo degli accessi con una granularità più precisa per registri, tabelle e comandi PartiQL. Consigliamo vivamente di utilizzare questa modalità di autorizzazione per massimizzare la sicurezza dei dati del registro.

    Per impostazione predefinita, questa modalità nega tutte le richieste di esecuzione di comandi PartiQL su qualsiasi tabella in questo registro. Per consentire i comandi PartiQL, è necessario creare politiche di IAM autorizzazione per specifiche risorse di tabella e azioni PartiQL, oltre all'autorizzazione per il SendCommand API registro. Per informazioni, consulta Guida introduttiva alla modalità di autorizzazione standard in Amazon QLDB.

Importante

Prima di passare alla modalità STANDARD autorizzazioni, è necessario creare tutte le IAM politiche e i tag di tabella richiesti per evitare interruzioni per gli utenti. Per saperne di più, procedi a. Migrazione alla modalità di autorizzazione standard

Per aggiornare una modalità di autorizzazione del registro utilizzando il AWS SDK for Java

  1. Creare un'istanza della classe AmazonQLDB.

  2. Crea un'istanza della classe UpdateLedgerPermissionsModeRequest per fornire le informazioni della richiesta.

    È necessario fornire il nome del registro insieme a un nuovo valore di stringa per la modalità autorizzazioni.

  3. Eseguire il metodo updateLedgerPermissionsMode fornendo l'oggetto della richiesta come parametro.

I seguenti esempi di codice illustrano i passaggi precedenti. La updateLedgerPermissionsMode richiesta restituisce un UpdateLedgerPermissionsModeResult oggetto con informazioni aggiornate sul registro.

Esempio — Assegna la modalità di autorizzazione standard
AmazonQLDB client = AmazonQLDBClientBuilder.standard().build();
UpdateLedgerPermissionsModeRequest request = new UpdateLedgerPermissionsModeRequest()
        .withName(ledgerName)
        .withPermissionsMode(PermissionsMode.STANDARD);
UpdateLedgerPermissionsModeResult result = client.updateLedgerPermissionsMode(request);

Assegna la modalità di STANDARD autorizzazione al tuo libro mastro. vehicle-registration

Esempio 
aws qldb update-ledger-permissions-mode --name vehicle-registration --permissions-mode STANDARD

Migrazione alla modalità di autorizzazione standard

Per passare alla modalità STANDARD autorizzazioni, consigliamo di analizzare i modelli di QLDB accesso e di aggiungere IAM politiche che concedano agli utenti le autorizzazioni appropriate per accedere alle proprie risorse.

Prima di passare alla modalità STANDARD autorizzazioni, è necessario creare tutte le politiche e i tag di tabella richiesti. IAM In caso contrario, la modifica della modalità di autorizzazione può causare interruzioni agli utenti fino a quando non si creano le IAM politiche corrette o si ripristina la modalità di autorizzazione. ALLOW_ALL Per informazioni sulla creazione di queste politiche, consulta. Guida introduttiva alla modalità di autorizzazione standard in Amazon QLDB

È inoltre possibile utilizzare una politica AWS gestita per concedere l'accesso completo a tutte le QLDB risorse. Le policy AmazonQLDBFullAccess AmazonQLDBConsoleFullAccess gestite includono tutte le QLDB azioni, incluse tutte le azioni PartiQl. L'associazione di una di queste politiche a un'entità equivale alla modalità di ALLOW_ALL autorizzazione di tale entità. Per ulteriori informazioni, consulta AWS politiche gestite per Amazon QLDB.

Eliminazione di un libro mastro

Usa l'DeleteLedgeroperazione per eliminare un libro mastro e tutto il suo contenuto. L'eliminazione di un libro mastro è un'operazione irrecuperabile.

Se la protezione da eliminazione è abilitata per il registro, è necessario disattivarla prima di poter eliminare il libro contabile.

Quando si invia una DeleteLedger richiesta, lo stato del registro cambia da a. ACTIVE DELETING L'eliminazione del registro potrebbe richiedere del tempo, a seconda della quantità di spazio di archiviazione utilizzata. Al termine dell'DeleteLedgeroperazione, il libro mastro non esiste più in. QLDB

Per eliminare un libro mastro utilizzando il AWS SDK for Java

  1. Creare un'istanza della classe AmazonQLDB.

  2. Create un'istanza della DeleteLedgerRequest classe e fornite il nome del libro contabile che desiderate eliminare.

  3. Eseguire il metodo deleteLedger fornendo l'oggetto della richiesta come parametro.

Il seguente esempio di codice mostra le fasi precedenti.

Esempio 
AmazonQLDB client = AmazonQLDBClientBuilder.standard().build();
DeleteLedgerRequest request = new DeleteLedgerRequest().withName(ledgerName);
DeleteLedgerResult result = client.deleteLedger(request);

Eliminare il libro mastro. vehicle-registration

Esempio 
aws qldb delete-ledger --name vehicle-registration

Elencare i libri mastri

L'ListLedgersoperazione restituisce informazioni di riepilogo di tutti i QLDB libri contabili per la regione corrente Account AWS e quella corrente.

Per elencare i libri contabili presenti nel tuo account utilizzando il AWS SDK for Java

  1. Creare un'istanza della classe AmazonQLDB.

  2. Creare un'istanza della classe ListLedgersRequest.

    Se hai ricevuto un valore per NextToken nella risposta a una ListLedgers chiamata precedente, devi fornire quel valore in questa richiesta per ottenere la pagina successiva di risultati.

  3. Eseguire il metodo listLedgers fornendo l'oggetto della richiesta come parametro.

  4. La listLedgers richiesta restituisce un ListLedgersResult oggetto. Questo oggetto ha un elenco di LedgerSummary oggetti e un token di impaginazione che indica se ci sono più risultati disponibili:

    • Se NextToken è vuoto, l'ultima pagina dei risultati è stata elaborata e non ci sono altri risultati.

    • Se non NextToken è vuoto, ci sono altri risultati disponibili. Per recuperare la pagina successiva di risultati, usa il valore di NextToken in una ListLedgers chiamata successiva.

Il seguente esempio di codice mostra le fasi precedenti.

Esempio 
AmazonQLDB client = AmazonQLDBClientBuilder.standard().build();
List<LedgerSummary> ledgerSummaries = new ArrayList<>();
String nextToken = null;
do {
    ListLedgersRequest request = new ListLedgersRequest().withNextToken(nextToken);
    ListLedgersResult result = client.listLedgers(request);
    ledgerSummaries.addAll(result.getLedgers());
    nextToken = result.getNextToken();
} while (nextToken != null);

Elenca tutti i libri contabili della regione corrente Account AWS e di quella attuale.

Esempio 
aws qldb list-ledgers