Operazioni di base per i registri Amazon QLDB - Database Amazon Quantum Ledger (Amazon QLDB)
Creare un libro mastroDescrizione di 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 i registri Amazon QLDB

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 registro Amazon QLDB su Amazon Aurora PostgreSQL.

Puoi utilizzare l'API QLDB o AWS Command Line Interface il AWS CLI() per creare, aggiornare ed eliminare i registri in Amazon QLDB. 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 per 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 tutto: una modalità di autorizzazioni legacy che consente il controllo degli accessi con granularità a livello di API per i registri.

      Questa modalità consente agli utenti che dispongono dell'autorizzazione API SendCommand per questo libro mastro per eseguire tutti i comandi PartiQL (quindi, ALLOW_ALL) su qualsiasi tabella nel libro mastro specificato. Questa modalità ignora tutte le policy di autorizzazione IAM a livello di tabella o di comando create per il libro mastro.

    • 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 policy di autorizzazione IAM per specifiche risorse di tabella e azioni PartiQL, oltre all'autorizzazione SendCommand API per il registro. Per informazioni, consultare Guida introduttiva alla modalità di autorizzazione standard in Amazon QLDB.

  • Protezione dall'eliminazione: (Facoltativa) 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 chiave KMS di proprietà: utilizza una chiave KMS di proprietà e gestita da per tuo AWS conto.

      Se non definisci questo parametro durante la creazione del libro contabile, il registro 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.

    • Chiave KMS gestita dal cliente: utilizza una chiave KMS con crittografia simmetrica nel tuo account che crei, possiedi e gestisci. QLDB non supporta le chiavi asimmetriche.

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

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

      Nota

      Le chiavi interregionali non sono supportate. La chiave KMS specificata deve trovarsi nello Regione AWS stesso registro.

    Per ulteriori informazioni, consulta Crittografia didei dati inattivi in Amazon QLDB.

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

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

Per creare un libro mastro utilizzando il AWS SDK per 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).

  • Chiave KMS: chiave KMS AWS di proprietà.

Esempio — Disattiva la protezione dall'eliminazione, utilizza una chiave KMS 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).

  • Chiave KMS: chiave KMS AWS di proprietà.

Oppure, crea un nuovo registro denominato vehicle-registration con la protezione dall'eliminazione disattivata, con una chiave KMS 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 AWS::QLDB::Ledgerrisorsa nella Guida per l'AWS CloudFormation utente.

Descrizione di 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: Amazon Resource Name (ARN) per il registro 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 API per i 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: l'ARN della chiave KMS gestita dal cliente che il registro utilizza per la crittografia a riposo. Se non è definito, il registro utilizza una AWS chiave KMS 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 in 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 chiave KMS 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 KMS gestita dal cliente è irreversibile. 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 chiave KMS è diventata inaccessibile per la prima volta, in caso di errore.

      Questo non è definito se la chiave KMS è accessibile.

    Per ulteriori informazioni, consulta Crittografia didei dati inattivi in Amazon QLDB.

Nota

Dopo aver creato un registro QLDB, questo diventa pronto per l'uso quando il suo stato cambia da a. CREATING ACTIVE

Per descrivere un libro mastro utilizzando il AWS SDK per 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 chiave KMS del registro.

    Nota

    Amazon QLDB ha lanciato il supporto per la AWS KMS keys gestione dei clienti il 22 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.

    Puoi visualizzare l'ora di creazione del tuo libro mastro sulla console QLDB.

    Utilizzare una delle opzioni seguenti:

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

    • Chiave KMS gestita dal cliente: utilizza una chiave KMS con crittografia simmetrica nel tuo account che crei, possiedi e gestisci. QLDB non supporta le chiavi asimmetriche.

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

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

      Nota

      Le chiavi interregionali non sono supportate. La chiave KMS specificata deve trovarsi nello Regione AWS stesso registro.

    Le modifiche principali in 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 didei dati inattivi in Amazon QLDB.

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

Per aggiornare un libro mastro utilizzando il AWS SDK per 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 registro insieme a un nuovo valore booleano per la protezione dall'eliminazione o 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 chiave KMS 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 — Utilizza una chiave AWS KMS di proprietà
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 KMS gestita 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 chiave KMS AWS di proprietà.

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 livello di API per i registri.

    Questa modalità consente agli utenti che dispongono dell'autorizzazione API SendCommand per questo libro mastro per eseguire tutti i comandi PartiQL (quindi, ALLOW_ALL) su qualsiasi tabella nel libro mastro specificato. Questa modalità ignora tutte le policy di autorizzazione IAM a livello di tabella o di comando create per il libro mastro.

  • 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 policy di autorizzazione IAM per specifiche risorse di tabella e azioni PartiQL, oltre all'autorizzazione SendCommand API per il registro. Per informazioni, consultare Guida introduttiva alla modalità di autorizzazione standard in Amazon QLDB.

Importante

Prima di passare alla modalità di STANDARD autorizzazione, devi prima creare tutte le politiche IAM 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 per 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 migrare alla modalità STANDARD autorizzazioni, consigliamo di analizzare i modelli di accesso QLDB e aggiungere policy IAM che concedano agli utenti le autorizzazioni appropriate per accedere alle proprie risorse.

Prima di passare alla modalità di STANDARD autorizzazione, devi prima creare tutte le politiche IAM e i tag di tabella richiesti. In caso contrario, il cambio della modalità di autorizzazione può causare interruzioni agli utenti fino a quando non si creano le politiche IAM 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

Puoi anche utilizzare una policy AWS gestita per concedere l'accesso completo a tutte le risorse QLDB. Le policy AmazonQLDBFullAccess AmazonQLDBConsoleFullAccess gestite includono tutte le azioni QLDB, 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 Policy 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 registro è 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 registro non esiste più in QLDB.

Per eliminare un libro mastro utilizzando il AWS SDK per 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 registri QLDB per la regione corrente e quella corrente. Account AWS

Per elencare i libri contabili presenti nel tuo account utilizzando il AWS SDK per 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