Operazioni di base per i libri mastri Amazon QLDB

Puoi usare l'API QLDB o ilAWS Command Line Interface (AWS CLI) per creare, aggiornare ed eliminare i registri in Amazon QLDB. Puoi anche elencare tutti i libri mastri nel tuo account o ottenere informazioni su un libro mastro specifico.

I seguenti argomenti forniscono brevi esempi di codice che mostrano i passaggi comuni per le operazioni di contabilità utilizzandoAWS SDK for Java e ilAWS CLI.

Per esempi di codice che dimostrano queste operazioni in un'applicazione di esempio completa, consulta i seguentiNozioni base sul driver tutorial e GitHub repository:

• Java: Tutorial | GitHub repository

• Node.js: Tutorial | GitHub repository

• Python: Tutorial | GitHub repository

Creazione di un registro

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

• Nome libro mastro: il nome della contabilità che desideri creare nel tuo account. Il nome deve essere univoco tra tutti i libri mastri nel momentoRegione AWS.

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

• Modalità autorizzazioni: la modalità di autorizzazione da assegnare alla contabilità. Seleziona una delle seguenti opzioni:

  • Consenti tutto: una modalità di autorizzazione legacy che consente il controllo degli accessi con granularità a livello di API per i libri mastri.

    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: (impostazione consigliata) una modalità di autorizzazione che consente il controllo degli accessi con una granularità più fine per libri mastri, tabelle e comandi PartiQL. Ti consigliamo di utilizzare questa modalità di autorizzazione per incrementare la sicurezza dei dati nel libro mastro.

    Per impostazione predefinita, questa modalità nega tutte le richieste di eseguire qualsiasi comando PartiQL su qualsiasi tabella in questo libro mastro. Per consentire i comandi PartiQL, devi creare le policy di autorizzazione IAM per risorse di tabelle e operazioni PartiQL specifiche, oltre all'autorizzazioneSendCommand API per il libro mastro. Per informazioni, consulta Guida introduttiva alla modalità di autorizzazione standard in Amazon QLDB.

• Protezione da eliminazione: (Facoltativo) il flag che impedisce a un utente qualsiasi di eliminare una contabilità. Se non la si specifica durante la creazione della contabilità, questa caratteristica è abilitata (true) per impostazione predefinita.

  Se la protezione dall'eliminazione è abilitata, è necessario innanzitutto disabilitarla prima di poter eliminare il libro mastro. Puoi disabilitarla usando l'UpdateLedgeroperazione per impostare il flag sufalse.

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

  • AWSchiave KMS di proprietà: usa una chiave KMS di proprietà e gestita da per tuoAWS conto.

    Se non si definisce questo parametro durante la creazione del libro mastro, il libro mastro utilizza questo tipo di chiave per impostazione predefinita. Puoi anche usare la stringaAWS_OWNED_KMS_KEY per specificare questo tipo di chiave. Questa opzione non richiede alcuna configurazione aggiuntiva.

  • Chiave KMS gestita dal cliente: usa una chiave KMS di crittografia simmetrica nel tuo account che crei, possiedi e gestisci. QLDB non supporta 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 gliAWS Key Management Service sviluppatori.

    Puoi specificare una chiave KMS gestita dal cliente utilizzando un ID, un alias o un nome di risorsa Amazon (ARN). Per ulteriori informazioni, consulta Identificatori chiave (KeyId) nella Guida per gliAWS Key Management Service sviluppatori.

    Nota

    Le chiavi tra Regioni non sono supportate. La chiave KMS specificata deve trovarsi nelloRegione AWS stesso libro mastro.

  Per ulteriori informazioni, consulta Crittografia inattiva in Amazon QLDB.

• Tag: (Facoltativo) Aggiungere metadati alla contabilità collegando i tag come coppie chiave-valore. Puoi aggiungere tag al libro mastro per facilitarne l'organizzazione e l'identificazione. Per ulteriori informazioni, consulta Assegnazione di tag alle risorse Amazon QLDB.

Il libro mastro non è pronto per l'uso fino a quando QLDB lo crea e ne imposta lo stato suACTIVE.

Creazione di un libro mastro (Java)

Per creare un registro utilizzandoAWS 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 registro e una modalità di autorizzazione.

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

LacreateLedger richiesta restituisce unCreateLedgerResult oggetto che contiene informazioni sul libro mastro. Consulta la sezione successiva per un esempio di utilizzo dell'DescribeLedgeroperazione per controllare lo stato del libro contabile dopo averlo creato.

I seguenti esempi dimostrano i passaggi precedenti.

Esempio — Utilizzo delle 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 libro mastro utilizza le seguenti impostazioni predefinite se non le specificate:

• Protezione dall'eliminazione — Attivata (true).

• Chiave KMS: chiave KMS diAWS 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);

Creazione di un libro mastro (AWS CLI)

Crea un nuovo libro mastro denominatovehicle-registration utilizzando le impostazioni di configurazione predefinite.

Esempio

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

Nota

Il libro mastro utilizza le seguenti impostazioni predefinite se non le specificate:

• Protezione dall'eliminazione — Attivata (true).

• Chiave KMS: chiave KMS diAWS proprietà.

In alternativa, crea un nuovo libro mastro denominatovehicle-registration con protezione dall'eliminazione disattivata, con una chiave KMS specificata gestita dal cliente 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

Creazione di un libro mastro (AWS CloudFormation)

Puoi anche usare un AWS CloudFormationmodello per creare libri mastri. Per ulteriori informazioni, consulta la AWS::QLDB::Ledgerrisorsa nella Guida per l'AWS CloudFormationutente.

Descrizione di un libro mastro

Utilizzare l'DescribeLedgeroperazione per visualizzare i dettagli relativi a un libro mastro. È necessario specificare il nome della contabilità. Il formato dell'output da DescribeLedger è identico a quello da CreateLedger. Include le seguenti informazioni:

• Nome libro mastro: il nome della contabilità che desideri descrivere.

• ARN: il nome della risorsa Amazon (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, nel formato dell'ora dell'epoca, di quando è 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à delle autorizzazioni assegnata al libro mastro. Può essere uno dei seguenti valori:

  • ALLOW_ALL— Una modalità di autorizzazione legacy che consente il controllo degli accessi con granularità a livello di API per i libri mastri.

  • STANDARD— Una modalità di autorizzazione che consente il controllo degli accessi con una granularità più fine per libri mastri, tabelle e comandi PartiQL.

• Descrizione della crittografia: informazioni sulla crittografia dei dati a riposo nel libro mastro. Ciò include i seguenti articoli:

  • AWS KMS keyARN: l'ARN della chiave KMS gestita dal cliente che il libro mastro utilizza per la crittografia a riposo. Se non è definita, il libro mastro utilizza una chiave KMSAWS di proprietà per la crittografia.

  • Stato di crittografia: lo stato corrente della crittografia inattiva per il libro mastro. 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 chiave in QLDB sono asincrone. Il libro mastro è completamente accessibile senza alcun impatto sulle prestazioni durante l'elaborazione della modifica chiave. La quantità di tempo necessaria per aggiornare una chiave varia a seconda della dimensione della contabilità.

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

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

  • InaccessibileAWS 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 inattiva in Amazon QLDB.

Nota

Dopo aver creato un registro QLDB, diventa pronto per l'uso quando il suo stato cambia daCREATING aACTIVE.

Descrizione di un libro mastro (Java)

Per descrivere un libro mastro usandoAWS SDK for Java

1. Creare un'istanza della classe AmazonQLDB. In alternativa, puoi utilizzare la stessa istanza delAmazonQLDB client che hai creato per laCreateLedger richiesta.

2. Creare un'istanza dellaDescribeLedgerRequest classe e specificare il nome della contabilità che si desidera descrivere.

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

4. LadescribeLedger richiesta restituisce unDescribeLedgerResult oggetto che contiene informazioni correnti sul libro mastro.

Il seguente esempio di codice mostra le fasi precedenti. Puoi chiamare ildescribeLedger metodo del cliente 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());

Descrivere un libro mastro (AWS CLI)

Descrizione dellavehicle-registration contabilità appena creata.

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 libro contabile esistente:

• Protezione da eliminazione: il flag che impedisce a un utente qualsiasi di eliminare una contabilità. Se questa caratteristica è abilitata, è necessario innanzitutto disabilitarla impostando il flag sufalse prima di poter eliminare il libro mastro.

  Se non si definisce questo parametro, non vengono apportate modifiche all'impostazione di protezione da eliminazione del libro mastro.

• AWS KMS key— La chiave inAWS Key Management Service (AWS KMS) da utilizzare per la crittografia dei dati inattivi. Se non si definisce questo parametro, non vengono apportate modifiche alla chiave KMS del libro mastro.

  Nota

  Amazon QLDB ha lanciato il supporto per la gestioneAWS KMS keys dei clienti il 22 luglio 2021. Tutti i registri creati prima del lancio sono protetti per impostazioneChiavi di proprietà di AWS predefinita, ma al momento non sono idonei alla crittografia inattiva utilizzando chiavi gestite dal cliente.

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

  Utilizzare una delle opzioni seguenti:

  • AWSchiave KMS di proprietà: usa una chiave KMS di proprietà e gestita da per tuoAWS conto. Per utilizzare questo tipo di chiave, specificate la stringaAWS_OWNED_KMS_KEY per questo parametro. Questa opzione non richiede alcuna configurazione aggiuntiva.

  • Chiave KMS gestita dal cliente: usa una chiave KMS di crittografia simmetrica nel tuo account che crei, possiedi e gestisci. QLDB non supporta 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 gliAWS Key Management Service sviluppatori.

    Puoi specificare una chiave KMS gestita dal cliente utilizzando un ID, un alias o un nome di risorsa Amazon (ARN). Per ulteriori informazioni, consulta Identificatori chiave (KeyId) nella Guida per gliAWS Key Management Service sviluppatori.

    Nota

    Le chiavi tra Regioni non sono supportate. La chiave KMS specificata deve trovarsi nelloRegione AWS stesso libro mastro.

  Le modifiche chiave in QLDB sono asincrone. Il libro mastro è 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 libro contabile. È possibile utilizzare l'DescribeLedgeroperazione per verificare lo stato di inattività della crittografia.

  Per ulteriori informazioni, consulta Crittografia inattiva in Amazon QLDB.

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

Aggiornamento di un libro mastro (Java)

Per aggiornare un libro contabile utilizzandoAWS 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 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. LaupdateLedger richiesta restituisce unUpdateLedgerResult oggetto che contiene informazioni aggiornate sul libro mastro.

Esempio — Disabilita protezione da eliminazione

AmazonQLDB client = AmazonQLDBClientBuilder.standard().build();
UpdateLedgerRequest request = new UpdateLedgerRequest()
        .withName(ledgerName)
        .withDeletionProtection(false);
UpdateLedgerResult result = client.updateLedger(request);

Esempio — Utilizzo di 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 — Usa una chiave KMS diAWS proprietà

AmazonQLDB client = AmazonQLDBClientBuilder.standard().build();
UpdateLedgerRequest request = new UpdateLedgerRequest()
        .withName(ledgerName)
        .withKmsKey("AWS_OWNED_KMS_KEY")
UpdateLedgerResult result = client.updateLedger(request);

Aggiornamento di un libro mastro (AWS CLI)

Se lavehicle-registration protezione dall'eliminazione è abilitata, è necessario innanzitutto disabilitarla prima di poterlo eliminare.

Esempio

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

Puoi anche modificare le impostazioni di crittografia del registro a riposo 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 diAWS 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à delle autorizzazioni di un libro mastro esistente. Seleziona una delle seguenti opzioni:

• Consenti tutto: una modalità di autorizzazione legacy che consente il controllo degli accessi con granularità a livello di API per i libri mastri.

  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: (impostazione consigliata) una modalità di autorizzazione che consente il controllo degli accessi con una granularità più fine per libri mastri, tabelle e comandi PartiQL. Ti consigliamo di utilizzare questa modalità di autorizzazione per incrementare la sicurezza dei dati nel libro mastro.

  Per impostazione predefinita, questa modalità nega tutte le richieste di eseguire qualsiasi comando PartiQL su qualsiasi tabella in questo libro mastro. Per consentire i comandi PartiQL, devi creare le policy di autorizzazione IAM per risorse di tabelle e operazioni PartiQL specifiche, oltre all'autorizzazioneSendCommand API per il libro mastro. Per informazioni, consulta Guida introduttiva alla modalità di autorizzazione standard in Amazon QLDB.

Importante

Prima di passare alla modalità diSTANDARD autorizzazione, devi prima creare tutte le politiche IAM e i tag di tabella necessari per evitare interruzioni per gli utenti. Per saperne di più, procedi aMigrazione alla modalità di autorizzazione standard.

Aggiornamento di una modalità di autorizzazione del registro (Java)

Per aggiornare la modalità di autorizzazione di un registro utilizzandoAWS 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 libro contabile 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. LaupdateLedgerPermissionsMode richiesta restituisce unUpdateLedgerPermissionsModeResult oggetto che contiene informazioni aggiornate sul libro mastro.

Esempio — Assegnazione della modalità di autorizzazione standard

AmazonQLDB client = AmazonQLDBClientBuilder.standard().build();
UpdateLedgerPermissionsModeRequest request = new UpdateLedgerPermissionsModeRequest()
        .withName(ledgerName)
        .withPermissionsMode(PermissionsMode.STANDARD);
UpdateLedgerPermissionsModeResult result = client.updateLedgerPermissionsMode(request);

Aggiornamento di una modalità di autorizzazione del registro (AWS CLI)

Assegna la modalitàSTANDARD delle autorizzazioni al tuovehicle-registration libro mastro.

Esempio

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

Migrazione alla modalità di autorizzazione standard

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

Prima di passare alla modalità diSTANDARD autorizzazione, devi prima creare tutte le politiche IAM e i tag di tabella richiesti. In caso contrario, il passaggio dalla modalità delle autorizzazioni può disturbare gli utenti fino a quando non si creano le politiche IAM corrette o si ripristina la modalità delle autorizzazioniALLOW_ALL. Per informazioni sulla creazione di queste policy, consultaGuida introduttiva alla modalità di autorizzazione standard in Amazon QLDB.

È inoltre possibile utilizzare una policyAWS gestita per garantire l'accesso completo a tutte le risorse QLDB. LeAmazonQLDBFullAccess politicheAmazonQLDBConsoleFullAccess gestite includono tutte le azioni QLDB, comprese tutte le azioni PartiQL. Collegare una di queste politiche a un principale equivale alla modalità diALLOW_ALL autorizzazione per quel preside. Per ulteriori informazioni, consulta AWS politiche gestite per Amazon QLDB.

Eliminazione di un libro mastro

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

Se la protezione dall'eliminazione è abilitata per il libro mastro, è necessario innanzitutto disabilitarla prima di poter eliminare il libro mastro.

Quando si invia unaDeleteLedger richiesta, lo stato del libro mastro cambia daACTIVE aDELETING. L'eliminazione del libro mastro potrebbe richiedere del tempo, a seconda della quantità di spazio di archiviazione utilizzato. A conclusione dell'DeleteLedgeroperazione, il libro mastro non esiste più in QLDB.

Eliminazione di un libro mastro (Java)

Per eliminare un libro contabile utilizzandoAWS SDK for Java

1. Creare un'istanza della classe AmazonQLDB.

2. Creare un'istanza dellaDeleteLedgerRequest classe e specificare il nome della contabilità che si desidera 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);

Eliminazione di un libro mastro (AWS CLI)

Elimina il tuovehicle-registration libro mastro.

Esempio

aws qldb delete-ledger --name vehicle-registration

Registri di quotazione

L'ListLedgersoperazione restituisce informazioni riepilogative di tutti i registri QLDB per l'attualeAccount AWS e la regione.

Registri di quotazione (Java)

Per elencare i libri contabili nel tuo account utilizzandoAWS SDK for Java

1. Creare un'istanza della classe AmazonQLDB.

2. Creare un'istanza della classe ListLedgersRequest.

   Se hai ricevuto un valore perNextToken nella risposta a unaListLedgers 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. LalistLedgers richiesta restituisce unListLedgersResult oggetto. Questo oggetto ha un elenco diLedgerSummary oggetti e un token di impaginazione che indica se sono disponibili altri risultati:

   • SeNextToken è vuota, l'ultima pagina dei risultati è stata elaborata e non ci sono altri risultati.

   • Se nonNextToken è vuoto, sono disponibili altri risultati. Per recuperare la pagina successiva di risultati, usa il valore diNextToken in unaListLedgers 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);
     

Registri di quotazione (AWS CLI)

Elenca tutti i registri della correnteAccount AWS e della regione.

Esempio

aws qldb list-ledgers