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
<a name="API_Operations"></a>

**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](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

Le seguenti azioni sono supportate da Amazon QLDB:
+  [CancelJournalKinesisStream](API_CancelJournalKinesisStream.md) 
+  [CreateLedger](API_CreateLedger.md) 
+  [DeleteLedger](API_DeleteLedger.md) 
+  [DescribeJournalKinesisStream](API_DescribeJournalKinesisStream.md) 
+  [DescribeJournalS3Export](API_DescribeJournalS3Export.md) 
+  [DescribeLedger](API_DescribeLedger.md) 
+  [ExportJournalToS3](API_ExportJournalToS3.md) 
+  [GetBlock](API_GetBlock.md) 
+  [GetDigest](API_GetDigest.md) 
+  [GetRevision](API_GetRevision.md) 
+  [ListJournalKinesisStreamsForLedger](API_ListJournalKinesisStreamsForLedger.md) 
+  [ListJournalS3Exports](API_ListJournalS3Exports.md) 
+  [ListJournalS3ExportsForLedger](API_ListJournalS3ExportsForLedger.md) 
+  [ListLedgers](API_ListLedgers.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [StreamJournalToKinesis](API_StreamJournalToKinesis.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateLedger](API_UpdateLedger.md) 
+  [UpdateLedgerPermissionsMode](API_UpdateLedgerPermissionsMode.md) 

Le seguenti azioni sono supportate dalla sessione Amazon QLDB:
+  [SendCommand](API_QLDB-Session_SendCommand.md) 

# Amazon QLDB
<a name="API_Operations_Amazon_QLDB"></a>

**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](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

Le seguenti azioni sono supportate da Amazon QLDB:
+  [CancelJournalKinesisStream](API_CancelJournalKinesisStream.md) 
+  [CreateLedger](API_CreateLedger.md) 
+  [DeleteLedger](API_DeleteLedger.md) 
+  [DescribeJournalKinesisStream](API_DescribeJournalKinesisStream.md) 
+  [DescribeJournalS3Export](API_DescribeJournalS3Export.md) 
+  [DescribeLedger](API_DescribeLedger.md) 
+  [ExportJournalToS3](API_ExportJournalToS3.md) 
+  [GetBlock](API_GetBlock.md) 
+  [GetDigest](API_GetDigest.md) 
+  [GetRevision](API_GetRevision.md) 
+  [ListJournalKinesisStreamsForLedger](API_ListJournalKinesisStreamsForLedger.md) 
+  [ListJournalS3Exports](API_ListJournalS3Exports.md) 
+  [ListJournalS3ExportsForLedger](API_ListJournalS3ExportsForLedger.md) 
+  [ListLedgers](API_ListLedgers.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [StreamJournalToKinesis](API_StreamJournalToKinesis.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateLedger](API_UpdateLedger.md) 
+  [UpdateLedgerPermissionsMode](API_UpdateLedgerPermissionsMode.md) 

# CancelJournalKinesisStream
<a name="API_CancelJournalKinesisStream"></a>

Termina un determinato stream di journal Amazon QLDB. Prima che uno stream possa essere annullato, deve essere il suo stato attuale. `ACTIVE`

Non puoi riavviare uno stream dopo averlo annullato. Le risorse di streaming QLDB annullate sono soggette a un periodo di conservazione di 7 giorni, quindi vengono eliminate automaticamente dopo la scadenza di questo limite.

## Sintassi della richiesta
<a name="API_CancelJournalKinesisStream_RequestSyntax"></a>

```
DELETE /ledgers/name/journal-kinesis-streams/streamId HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_CancelJournalKinesisStream_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_CancelJournalKinesisStream_RequestSyntax) **   <a name="qldb-CancelJournalKinesisStream-request-uri-LedgerName"></a>
Il nome del libro mastro.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

 ** [streamId](#API_CancelJournalKinesisStream_RequestSyntax) **   <a name="qldb-CancelJournalKinesisStream-request-uri-StreamId"></a>
L'UUID (rappresentato nel testo con codifica Base62) del flusso di journal QLDB da annullare.  
Vincoli di lunghezza: lunghezza fissa di 22.  
Modello: `^[A-Za-z-0-9]+$`   
Campo obbligatorio: sì

## Corpo della richiesta
<a name="API_CancelJournalKinesisStream_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_CancelJournalKinesisStream_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "StreamId": "string"
}
```

## Elementi di risposta
<a name="API_CancelJournalKinesisStream_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [StreamId](#API_CancelJournalKinesisStream_ResponseSyntax) **   <a name="qldb-CancelJournalKinesisStream-response-StreamId"></a>
L'UUID (testo con codifica Base62) dello stream di journal QLDB annullato.  
Tipo: stringa  
Vincoli di lunghezza: lunghezza fissa di 22.  
Modello: `^[A-Za-z-0-9]+$` 

## Errori
<a name="API_CancelJournalKinesisStream_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterException **   
Uno o più parametri nella richiesta non sono validi.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

 ** ResourcePreconditionNotMetException **   
L'operazione non è riuscita perché una condizione non era soddisfatta in anticipo.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_CancelJournalKinesisStream_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/CancelJournalKinesisStream) 

# CreateLedger
<a name="API_CreateLedger"></a>

Crea un nuovo registro Account AWS nella tua regione corrente.

## Sintassi della richiesta
<a name="API_CreateLedger_RequestSyntax"></a>

```
POST /ledgers HTTP/1.1
Content-type: application/json

{
   "DeletionProtection": boolean,
   "KmsKey": "string",
   "Name": "string",
   "PermissionsMode": "string",
   "Tags": { 
      "string" : "string" 
   }
}
```

## Parametri della richiesta URI:
<a name="API_CreateLedger_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_CreateLedger_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [DeletionProtection](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-DeletionProtection"></a>
Specifica se il libro mastro è protetto dall'eliminazione da parte di un utente qualsiasi. Se non definita al momento della creazione del libro mastro, 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 chiamando l'operazione `UpdateLedger` per impostare questo parametro su `false`.  
Tipo: Booleano  
Campo obbligatorio: no

 ** [KmsKey](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-KmsKey"></a>
La chiave in AWS Key Management Service (AWS KMS) da usare per la crittografia dei dati inattivi nel registro. Per ulteriori informazioni, consulta [Crittografia dei dati inattivi](https://docs.aws.amazon.com/qldb/latest/developerguide/encryption-at-rest.html) nella *Guida per gli sviluppatori di Amazon QLDB*.  
Per specificare questo parametro, puoi utilizzare una delle opzioni seguenti:  
+  `AWS_OWNED_KMS_KEY`: utilizza una AWS KMS chiave posseduta e gestita da per tuo AWS conto.
+  **Non definito**: per impostazione predefinita, utilizza una chiave KMS AWS di proprietà.
+  **Una chiave KMS simmetrica valida gestita dal cliente**: usa le chiave KMS di crittografia simmetrica specificata nell'account che crei, possiedi e gestisci.

  Amazon QLDB non supporta le chiavi asimmetriche. *Per ulteriori informazioni, consulta [Uso delle chiavi simmetriche e asimmetriche](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) nella Guida per gli sviluppatori. AWS Key Management Service *
Per specificare una chiave KMS gestita dal cliente, utilizza il relativo ID chiave, il nome della risorsa Amazon (ARN), il nome dell'alias o l'ARN dell'alias. Quando utilizzi un nome alias, aggiungi il prefisso `"alias/"`. Per specificare una chiave in un'altra Account AWS, è necessario utilizzare la chiave ARN o l'alias ARN.  
Per esempio:  
+ ID chiave: `1234abcd-12ab-34cd-56ef-1234567890ab` 
+ ARN chiave: `arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` 
+ Nome alias: `alias/ExampleAlias` 
+ ARN alias: `arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias` 
*Per ulteriori informazioni, consulta [Key identifiers (KeyId)](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id) nella Guida per gli sviluppatori. AWS Key Management Service *  
Tipo: stringa  
Vincoli di lunghezza: lunghezza massima di 1600.  
Campo obbligatorio: no

 ** [Name](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-Name"></a>
Il nome della contabilità che desideri creare. Il nome deve essere univoco tra tutti i registri della regione Account AWS corrente.  
I vincoli di denominazione per i nomi dei libri contabili sono definiti in [Quote in Amazon QLDB](https://docs.aws.amazon.com/qldb/latest/developerguide/limits.html#limits.naming) nella *Guida per gli sviluppatori di Amazon QLDB*.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

 ** [PermissionsMode](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-PermissionsMode"></a>
Le autorizzazioni da assegnare alla contabilità che si desidera creare. Questo parametro può avere 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.

  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.

  Per impostazione predefinita, questa modalità nega tutte le richieste degli utenti di eseguire qualsiasi comando PartiQL su qualsiasi tabella in questo libro mastro. Per consentire l'esecuzione dei comandi PartiQL, devi creare le policy di autorizzazione IAM per risorse di tabelle e operazioni PartiQL specifiche, oltre all'autorizzazione API `SendCommand` per il libro mastro. Per informazioni, consulta [Getting started with the standard permissions mode](https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started-standard-mode.html) (Nozioni di base sulla modalità di autorizzazione standard) nella *Guida per gli sviluppatori di Amazon QLDB*.
Ti consigliamo di utilizzare la modalità di autorizzazione `STANDARD` per incrementare la sicurezza dei dati nel libro mastro.
Tipo: stringa  
Valori validi: `ALLOW_ALL | STANDARD`   
Campo obbligatorio: sì

 ** [Tags](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-Tags"></a>
Le coppie chiave-valore da aggiungere come tag al registro che si desidera creare. Le chiavi dei tag prevedono una distinzione tra lettere maiuscole e minuscole. I valori dei tag fanno distinzione tra maiuscole e minuscole e possono essere nulli.  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.  
Limiti di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Campo obbligatorio: no

## Sintassi della risposta
<a name="API_CreateLedger_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Arn": "string",
   "CreationDateTime": number,
   "DeletionProtection": boolean,
   "KmsKeyArn": "string",
   "Name": "string",
   "PermissionsMode": "string",
   "State": "string"
}
```

## Elementi di risposta
<a name="API_CreateLedger_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [Arn](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-Arn"></a>
L'Amazon Resource Name (ARN) per il registro.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 1600 caratteri.

 ** [CreationDateTime](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-CreationDateTime"></a>
La data e l'ora, in formato epoch time, in cui è stato creato il libro mastro. (Il formato dell'ora epoch è il numero di secondi trascorsi dalle 00:00 del 1° gennaio 1970 UTC.)  
Tipo: Timestamp

 ** [DeletionProtection](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-DeletionProtection"></a>
Specifica se il libro mastro è protetto dall'eliminazione da parte di un utente qualsiasi. Se non definita al momento della creazione del libro mastro, 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 chiamando l'operazione `UpdateLedger` per impostare questo parametro su `false`.  
Tipo: Booleano

 ** [KmsKeyArn](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-KmsKeyArn"></a>
L'ARN della chiave KMS gestita dal cliente che il registro utilizza per la crittografia a riposo. Se questo parametro non è definito, il registro utilizza una chiave KMS AWS proprietaria per la crittografia.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 1600 caratteri.

 ** [Name](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-Name"></a>
Il nome del libro mastro.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$` 

 ** [PermissionsMode](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-PermissionsMode"></a>
La modalità di autorizzazione del libro mastro che hai creato.  
Tipo: stringa  
Valori validi: `ALLOW_ALL | STANDARD` 

 ** [State](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-State"></a>
Lo stato attuale del libro mastro.  
Tipo: stringa  
Valori validi: `CREATING | ACTIVE | DELETING | DELETED` 

## Errori
<a name="API_CreateLedger_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterException **   
Uno o più parametri nella richiesta non sono validi.  
Codice di stato HTTP: 400

 ** LimitExceededException **   
Hai raggiunto il limite del numero massimo di risorse consentite.  
Codice di stato HTTP: 400

 ** ResourceAlreadyExistsException **   
La risorsa specificata esiste già.  
Codice di stato HTTP: 409

 ** ResourceInUseException **   
La risorsa specificata non può essere modificata in questo momento.  
Codice di stato HTTP: 409

## Vedi anche
<a name="API_CreateLedger_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/CreateLedger) 

# DeleteLedger
<a name="API_DeleteLedger"></a>

Elimina un registro e tutto il suo contenuto. Questa operazione è irreversibile.

Se la protezione dall'eliminazione è abilitata, è necessario innanzitutto disabilitarla prima di poter eliminare il libro mastro. Puoi disabilitarla chiamando l'operazione `UpdateLedger` per impostare questo parametro su `false`.

## Sintassi della richiesta
<a name="API_DeleteLedger_RequestSyntax"></a>

```
DELETE /ledgers/name HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_DeleteLedger_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_DeleteLedger_RequestSyntax) **   <a name="qldb-DeleteLedger-request-uri-Name"></a>
Il nome del libro contabile che si desidera eliminare.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

## Corpo della richiesta
<a name="API_DeleteLedger_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteLedger_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_DeleteLedger_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_DeleteLedger_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterException **   
Uno o più parametri nella richiesta non sono validi.  
Codice di stato HTTP: 400

 ** ResourceInUseException **   
La risorsa specificata non può essere modificata in questo momento.  
Codice di stato HTTP: 409

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

 ** ResourcePreconditionNotMetException **   
L'operazione non è riuscita perché una condizione non è stata soddisfatta in anticipo.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_DeleteLedger_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/DeleteLedger) 

# DescribeJournalKinesisStream
<a name="API_DescribeJournalKinesisStream"></a>

Restituisce informazioni dettagliate su un determinato flusso di journal Amazon QLDB. L'output include Amazon Resource Name (ARN), il nome dello stream, lo stato corrente, l'ora di creazione e i parametri della richiesta di creazione dello stream originale.

Questa azione non restituisce alcun stream di journal scaduto. Per ulteriori informazioni, consulta [Scadenza per i flussi di terminali](https://docs.aws.amazon.com/qldb/latest/developerguide/streams.create.html#streams.create.states.expiration) nella *Amazon QLDB Developer Guide*.

## Sintassi della richiesta
<a name="API_DescribeJournalKinesisStream_RequestSyntax"></a>

```
GET /ledgers/name/journal-kinesis-streams/streamId HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_DescribeJournalKinesisStream_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_DescribeJournalKinesisStream_RequestSyntax) **   <a name="qldb-DescribeJournalKinesisStream-request-uri-LedgerName"></a>
Il nome del libro mastro.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

 ** [streamId](#API_DescribeJournalKinesisStream_RequestSyntax) **   <a name="qldb-DescribeJournalKinesisStream-request-uri-StreamId"></a>
L'UUID (rappresentato nel testo con codifica Base62) del flusso di journal QLDB da descrivere.  
Vincoli di lunghezza: lunghezza fissa di 22.  
Modello: `^[A-Za-z-0-9]+$`   
Campo obbligatorio: sì

## Corpo della richiesta
<a name="API_DescribeJournalKinesisStream_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DescribeJournalKinesisStream_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Stream": { 
      "Arn": "string",
      "CreationTime": number,
      "ErrorCause": "string",
      "ExclusiveEndTime": number,
      "InclusiveStartTime": number,
      "KinesisConfiguration": { 
         "AggregationEnabled": boolean,
         "StreamArn": "string"
      },
      "LedgerName": "string",
      "RoleArn": "string",
      "Status": "string",
      "StreamId": "string",
      "StreamName": "string"
   }
}
```

## Elementi di risposta
<a name="API_DescribeJournalKinesisStream_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [Stream](#API_DescribeJournalKinesisStream_ResponseSyntax) **   <a name="qldb-DescribeJournalKinesisStream-response-Stream"></a>
Informazioni sullo stream del journal QLDB restituito da una richiesta. `DescribeJournalS3Export`  
Tipo: oggetto [JournalKinesisStreamDescription](API_JournalKinesisStreamDescription.md)

## Errori
<a name="API_DescribeJournalKinesisStream_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterException **   
Uno o più parametri nella richiesta non sono validi.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

 ** ResourcePreconditionNotMetException **   
L'operazione non è riuscita perché una condizione non era soddisfatta in anticipo.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_DescribeJournalKinesisStream_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/DescribeJournalKinesisStream) 

# DescribeJournalS3Export
<a name="API_DescribeJournalS3Export"></a>

Restituisce informazioni su un processo di esportazione del diario, tra cui il nome del libro mastro, l'ID di esportazione, l'ora di creazione, lo stato corrente e i parametri della richiesta di creazione dell'esportazione originale.

Questa azione non restituisce alcun processo di esportazione scaduto. Per ulteriori informazioni, [consulta la scadenza dei lavori di esportazione](https://docs.aws.amazon.com/qldb/latest/developerguide/export-journal.request.html#export-journal.request.expiration) nella *Amazon QLDB Developer Guide*.

Se il processo di esportazione con quello specificato `ExportId` non esiste, viene generato. `ResourceNotFoundException`

Se il libro mastro con quanto indicato `Name` non esiste, viene generato. `ResourceNotFoundException`

## Sintassi della richiesta
<a name="API_DescribeJournalS3Export_RequestSyntax"></a>

```
GET /ledgers/name/journal-s3-exports/exportId HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_DescribeJournalS3Export_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [exportId](#API_DescribeJournalS3Export_RequestSyntax) **   <a name="qldb-DescribeJournalS3Export-request-uri-ExportId"></a>
L'UUID (rappresentato nel testo codificato in Base62) del processo di esportazione del diario da descrivere.  
Vincoli di lunghezza: lunghezza fissa di 22.  
Modello: `^[A-Za-z-0-9]+$`   
Campo obbligatorio: sì

 ** [name](#API_DescribeJournalS3Export_RequestSyntax) **   <a name="qldb-DescribeJournalS3Export-request-uri-Name"></a>
Il nome del libro mastro.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

## Corpo della richiesta
<a name="API_DescribeJournalS3Export_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DescribeJournalS3Export_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ExportDescription": { 
      "ExclusiveEndTime": number,
      "ExportCreationTime": number,
      "ExportId": "string",
      "InclusiveStartTime": number,
      "LedgerName": "string",
      "OutputFormat": "string",
      "RoleArn": "string",
      "S3ExportConfiguration": { 
         "Bucket": "string",
         "EncryptionConfiguration": { 
            "KmsKeyArn": "string",
            "ObjectEncryptionType": "string"
         },
         "Prefix": "string"
      },
      "Status": "string"
   }
}
```

## Elementi di risposta
<a name="API_DescribeJournalS3Export_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [ExportDescription](#API_DescribeJournalS3Export_ResponseSyntax) **   <a name="qldb-DescribeJournalS3Export-response-ExportDescription"></a>
Informazioni sul processo di esportazione del diario restituito da una `DescribeJournalS3Export` richiesta.  
Tipo: oggetto [JournalS3ExportDescription](API_JournalS3ExportDescription.md)

## Errori
<a name="API_DescribeJournalS3Export_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_DescribeJournalS3Export_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/DescribeJournalS3Export) 

# DescribeLedger
<a name="API_DescribeLedger"></a>

Restituisce informazioni su un registro, inclusi lo stato, la modalità di autorizzazione, le impostazioni di crittografia a riposo e la data di creazione.

## Sintassi della richiesta
<a name="API_DescribeLedger_RequestSyntax"></a>

```
GET /ledgers/name HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_DescribeLedger_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_DescribeLedger_RequestSyntax) **   <a name="qldb-DescribeLedger-request-uri-Name"></a>
Il nome del libro mastro che si desidera descrivere.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

## Corpo della richiesta
<a name="API_DescribeLedger_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DescribeLedger_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Arn": "string",
   "CreationDateTime": number,
   "DeletionProtection": boolean,
   "EncryptionDescription": { 
      "EncryptionStatus": "string",
      "InaccessibleKmsKeyDateTime": number,
      "KmsKeyArn": "string"
   },
   "Name": "string",
   "PermissionsMode": "string",
   "State": "string"
}
```

## Elementi di risposta
<a name="API_DescribeLedger_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [Arn](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-Arn"></a>
L'Amazon Resource Name (ARN) per il registro.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 1600 caratteri.

 ** [CreationDateTime](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-CreationDateTime"></a>
La data e l'ora, in formato epoch time, in cui è stato creato il libro mastro. (Il formato dell'ora epoch è il numero di secondi trascorsi dalle 00:00 del 1° gennaio 1970 UTC.)  
Tipo: Timestamp

 ** [DeletionProtection](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-DeletionProtection"></a>
Specifica se il libro mastro è protetto dall'eliminazione da parte di un utente qualsiasi. Se non definita al momento della creazione del libro mastro, 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 chiamando l'operazione `UpdateLedger` per impostare questo parametro su `false`.  
Tipo: Booleano

 ** [EncryptionDescription](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-EncryptionDescription"></a>
Informazioni sulla crittografia dei dati inattivi nel registro. Ciò include lo stato corrente, la AWS KMS chiave e il momento in cui la chiave è diventata inaccessibile (in caso di errore). Se questo parametro non è definito, il registro utilizza una chiave KMS AWS proprietaria per la crittografia.  
Tipo: oggetto [LedgerEncryptionDescription](API_LedgerEncryptionDescription.md)

 ** [Name](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-Name"></a>
Il nome del libro mastro.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$` 

 ** [PermissionsMode](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-PermissionsMode"></a>
La modalità di autorizzazione del libro mastro.  
Tipo: stringa  
Valori validi: `ALLOW_ALL | STANDARD` 

 ** [State](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-State"></a>
Lo stato attuale del libro mastro.  
Tipo: stringa  
Valori validi: `CREATING | ACTIVE | DELETING | DELETED` 

## Errori
<a name="API_DescribeLedger_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterException **   
Uno o più parametri nella richiesta non sono validi.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_DescribeLedger_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/DescribeLedger) 

# ExportJournalToS3
<a name="API_ExportJournalToS3"></a>

Esporta il contenuto del diario entro un intervallo di data e ora da un registro in un bucket Amazon Simple Storage Service (Amazon S3) specificato. Un processo di esportazione del diario può scrivere gli oggetti dati nella rappresentazione testuale o binaria del formato Amazon Ion o nel formato di testo *JSON Lines*.

Se il registro con il dato `Name` non esiste, viene generato. `ResourceNotFoundException`

Se il registro con quanto indicato `Name` è in `CREATING` stato, viene generato. `ResourcePreconditionNotMetException`

È possibile avviare fino a due richieste di esportazione simultanee delle scritture contabili per ogni libro contabile. Oltre questo limite, vengono inviate le richieste di esportazione delle scritture contabili. `LimitExceededException`

## Sintassi della richiesta
<a name="API_ExportJournalToS3_RequestSyntax"></a>

```
POST /ledgers/name/journal-s3-exports HTTP/1.1
Content-type: application/json

{
   "ExclusiveEndTime": number,
   "InclusiveStartTime": number,
   "OutputFormat": "string",
   "RoleArn": "string",
   "S3ExportConfiguration": { 
      "Bucket": "string",
      "EncryptionConfiguration": { 
         "KmsKeyArn": "string",
         "ObjectEncryptionType": "string"
      },
      "Prefix": "string"
   }
}
```

## Parametri della richiesta URI
<a name="API_ExportJournalToS3_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-uri-Name"></a>
Il nome del libro mastro.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

## Corpo della richiesta
<a name="API_ExportJournalToS3_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [ExclusiveEndTime](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-ExclusiveEndTime"></a>
La data e l'ora di fine esclusive per la gamma di contenuti del diario da esportare.  
`ExclusiveEndTime` deve essere in formato data e ora `ISO 8601` e in Universal Coordinated Time (UTC). Ad esempio: `2019-06-13T21:36:34Z`.  
`ExclusiveEndTime`Deve essere inferiore o uguale alla data e all'ora UTC correnti.  
Tipo: Timestamp  
Campo obbligatorio: sì

 ** [InclusiveStartTime](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-InclusiveStartTime"></a>
La data e l'ora di inizio incluse per l'intervallo di contenuti del diario da esportare.  
`InclusiveStartTime` deve essere in formato data e ora `ISO 8601` e in Universal Coordinated Time (UTC). Ad esempio: `2019-06-13T21:36:34Z`.  
`InclusiveStartTime`Deve essere prima`ExclusiveEndTime`.  
Se fornisci un codice `InclusiveStartTime` che precede il registro`CreationDateTime`, Amazon QLDB lo imposta come predefinito sul libro mastro. `CreationDateTime`  
Tipo: Timestamp  
Campo obbligatorio: sì

 ** [OutputFormat](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-OutputFormat"></a>
Il formato di output dei dati del diario esportati. Un processo di esportazione del diario può scrivere gli oggetti dati nella rappresentazione testuale o binaria del formato [Amazon Ion](https://docs.aws.amazon.com/qldb/latest/developerguide/ion.html) o nel formato di testo [JSON Lines](https://jsonlines.org/).  
Impostazione predefinita: `ION_TEXT`   
Nel formato JSON Lines, ogni blocco di journal in un oggetto dati esportato è un oggetto JSON valido delimitato da una nuova riga. Puoi utilizzare questo formato per integrare direttamente le esportazioni JSON con strumenti di analisi come Amazon Athena AWS Glue e perché questi servizi possono analizzare automaticamente JSON delimitato da nuove righe.  
Tipo: stringa  
Valori validi: `ION_BINARY | ION_TEXT | JSON`   
Campo obbligatorio: no

 ** [RoleArn](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-RoleArn"></a>
L'Amazon Resource Name (ARN) del ruolo IAM che concede le autorizzazioni QLDB per un processo di esportazione di riviste per eseguire le seguenti operazioni:  
+ Scrivi oggetti nel tuo bucket Amazon S3.
+ (Facoltativo) Utilizza la chiave gestita dal cliente AWS Key Management Service (AWS KMS) per la crittografia lato server dei dati esportati.
Per passare un ruolo a QLDB quando si richiede l'esportazione di un journal, è necessario disporre delle autorizzazioni per eseguire `iam:PassRole` l'azione sulla risorsa del ruolo IAM. Questo è necessario per tutte le richieste di esportazione del journal.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 1600 caratteri.  
Campo obbligatorio: sì

 ** [S3ExportConfiguration](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-S3ExportConfiguration"></a>
Le impostazioni di configurazione della destinazione del bucket Amazon S3 per la tua richiesta di esportazione.  
Tipo: oggetto [S3ExportConfiguration](API_S3ExportConfiguration.md)  
Campo obbligatorio: sì

## Sintassi della risposta
<a name="API_ExportJournalToS3_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ExportId": "string"
}
```

## Elementi di risposta
<a name="API_ExportJournalToS3_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [ExportId](#API_ExportJournalToS3_ResponseSyntax) **   <a name="qldb-ExportJournalToS3-response-ExportId"></a>
L'UUID (rappresentato nel testo con codifica Base62) che QLDB assegna a ogni processo di esportazione del diario.  
Per descrivere la richiesta di esportazione e verificare lo stato del lavoro, è possibile utilizzare to call. `ExportId` `DescribeJournalS3Export`  
Tipo: stringa  
Vincoli di lunghezza: lunghezza fissa di 22.  
Modello: `^[A-Za-z-0-9]+$` 

## Errori
<a name="API_ExportJournalToS3_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

 ** ResourcePreconditionNotMetException **   
L'operazione non è riuscita perché una condizione non era stata soddisfatta in anticipo.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_ExportJournalToS3_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ExportJournalToS3) 

# GetBlock
<a name="API_GetBlock"></a>

Restituisce un oggetto blocco a un indirizzo specificato in un diario. Restituisce inoltre una prova del blocco specificato per la verifica, se `DigestTipAddress` fornita.

Per informazioni sul contenuto dei dati in un blocco, consulta i [contenuti del Journal](https://docs.aws.amazon.com/qldb/latest/developerguide/journal-contents.html) nella *Amazon QLDB Developer Guide*.

Se il registro specificato non esiste o è in `DELETING` stato, viene generato. `ResourceNotFoundException`

Se il registro specificato è in `CREATING` stato, viene generato. `ResourcePreconditionNotMetException`

Se non esiste alcun blocco con l'indirizzo specificato, viene generato. `InvalidParameterException`

## Sintassi della richiesta
<a name="API_GetBlock_RequestSyntax"></a>

```
POST /ledgers/name/block HTTP/1.1
Content-type: application/json

{
   "BlockAddress": { 
      "IonText": "string"
   },
   "DigestTipAddress": { 
      "IonText": "string"
   }
}
```

## Parametri della richiesta URI
<a name="API_GetBlock_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-request-uri-Name"></a>
Il nome del libro mastro.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

## Corpo della richiesta
<a name="API_GetBlock_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [BlockAddress](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-request-BlockAddress"></a>
La posizione del blocco che desideri richiedere. Un indirizzo è una struttura Amazon Ion con due campi: `strandId` e`sequenceNo`.  
Ad esempio: `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}`.  
Tipo: oggetto [ValueHolder](API_ValueHolder.md)  
Campo obbligatorio: sì

 ** [DigestTipAddress](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-request-DigestTipAddress"></a>
L'ultima ubicazione del blocco coperta dal digest per la quale richiedere una prova. Un indirizzo è una struttura Amazon Ion con due campi: `strandId` e`sequenceNo`.  
Ad esempio: `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}`.  
Tipo: oggetto [ValueHolder](API_ValueHolder.md)  
Campo obbligatorio: no

## Sintassi della risposta
<a name="API_GetBlock_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Block": { 
      "IonText": "string"
   },
   "Proof": { 
      "IonText": "string"
   }
}
```

## Elementi di risposta
<a name="API_GetBlock_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [Block](#API_GetBlock_ResponseSyntax) **   <a name="qldb-GetBlock-response-Block"></a>
L'oggetto di dati a blocchi in formato Amazon Ion.  
Tipo: oggetto [ValueHolder](API_ValueHolder.md)

 ** [Proof](#API_GetBlock_ResponseSyntax) **   <a name="qldb-GetBlock-response-Proof"></a>
L'oggetto di prova in formato Amazon Ion restituito da una `GetBlock` richiesta. Una dimostrazione contiene l'elenco dei valori hash necessari per ricalcolare il digest specificato utilizzando un albero Merkle, a partire dal blocco specificato.  
Tipo: oggetto [ValueHolder](API_ValueHolder.md)

## Errori
<a name="API_GetBlock_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterException **   
Uno o più parametri nella richiesta non sono validi.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

 ** ResourcePreconditionNotMetException **   
L'operazione non è riuscita perché una condizione non era soddisfatta in anticipo.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_GetBlock_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/GetBlock) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/GetBlock) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/GetBlock) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/GetBlock) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/GetBlock) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/GetBlock) 

# GetDigest
<a name="API_GetDigest"></a>

Restituisce il riassunto di un libro mastro nell'ultimo blocco commesso nel diario. La risposta include un valore hash a 256 bit e un indirizzo di blocco.

## Sintassi della richiesta
<a name="API_GetDigest_RequestSyntax"></a>

```
POST /ledgers/name/digest HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_GetDigest_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_GetDigest_RequestSyntax) **   <a name="qldb-GetDigest-request-uri-Name"></a>
Il nome del libro mastro.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

## Corpo della richiesta
<a name="API_GetDigest_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetDigest_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Digest": blob,
   "DigestTipAddress": { 
      "IonText": "string"
   }
}
```

## Elementi di risposta
<a name="API_GetDigest_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [Digest](#API_GetDigest_ResponseSyntax) **   <a name="qldb-GetDigest-response-Digest"></a>
Il valore hash a 256 bit che rappresenta il digest restituito da una richiesta. `GetDigest`  
Tipo: oggetto dati binari con codifica Base64  
Vincoli di lunghezza: lunghezza fissa di 32.

 ** [DigestTipAddress](#API_GetDigest_ResponseSyntax) **   <a name="qldb-GetDigest-response-DigestTipAddress"></a>
L'ultima posizione del blocco coperta dal digest che hai richiesto. Un indirizzo è una struttura Amazon Ion con due campi: `strandId` e`sequenceNo`.  
Tipo: oggetto [ValueHolder](API_ValueHolder.md)

## Errori
<a name="API_GetDigest_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterException **   
Uno o più parametri nella richiesta non sono validi.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

 ** ResourcePreconditionNotMetException **   
L'operazione non è riuscita perché una condizione non era soddisfatta in anticipo.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_GetDigest_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/GetDigest) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/GetDigest) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/GetDigest) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/GetDigest) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/GetDigest) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/GetDigest) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/GetDigest) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/GetDigest) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/GetDigest) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/GetDigest) 

# GetRevision
<a name="API_GetRevision"></a>

Restituisce un oggetto di dati di revisione per un ID di documento e un indirizzo di blocco specificati. Restituisce inoltre una prova della revisione specificata per la verifica, se `DigestTipAddress` fornita.

## Sintassi della richiesta
<a name="API_GetRevision_RequestSyntax"></a>

```
POST /ledgers/name/revision HTTP/1.1
Content-type: application/json

{
   "BlockAddress": { 
      "IonText": "string"
   },
   "DigestTipAddress": { 
      "IonText": "string"
   },
   "DocumentId": "string"
}
```

## Parametri della richiesta URI
<a name="API_GetRevision_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-uri-Name"></a>
Il nome del libro mastro.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

## Corpo della richiesta
<a name="API_GetRevision_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [BlockAddress](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-BlockAddress"></a>
La posizione del blocco della revisione del documento da verificare. Un indirizzo è una struttura Amazon Ion con due campi: `strandId` e`sequenceNo`.  
Ad esempio: `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}`.  
Tipo: oggetto [ValueHolder](API_ValueHolder.md)  
Campo obbligatorio: sì

 ** [DigestTipAddress](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-DigestTipAddress"></a>
L'ultima ubicazione del blocco coperta dal digest per la quale richiedere una prova. Un indirizzo è una struttura Amazon Ion con due campi: `strandId` e`sequenceNo`.  
Ad esempio: `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}`.  
Tipo: oggetto [ValueHolder](API_ValueHolder.md)  
Campo obbligatorio: no

 ** [DocumentId](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-DocumentId"></a>
L'UUID (rappresentato nel testo con codifica Base62) del documento da verificare.  
Tipo: stringa  
Vincoli di lunghezza: lunghezza fissa di 22.  
Modello: `^[A-Za-z-0-9]+$`   
Campo obbligatorio: sì

## Sintassi della risposta
<a name="API_GetRevision_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Proof": { 
      "IonText": "string"
   },
   "Revision": { 
      "IonText": "string"
   }
}
```

## Elementi di risposta
<a name="API_GetRevision_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [Proof](#API_GetRevision_ResponseSyntax) **   <a name="qldb-GetRevision-response-Proof"></a>
L'oggetto di prova in formato Amazon Ion restituito da una `GetRevision` richiesta. Una bozza contiene l'elenco dei valori hash necessari per ricalcolare il digest specificato utilizzando un albero Merkle, a partire dalla revisione del documento specificata.  
Tipo: oggetto [ValueHolder](API_ValueHolder.md)

 ** [Revision](#API_GetRevision_ResponseSyntax) **   <a name="qldb-GetRevision-response-Revision"></a>
L'oggetto dei dati di revisione del documento in formato Amazon Ion.  
Tipo: oggetto [ValueHolder](API_ValueHolder.md)

## Errori
<a name="API_GetRevision_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterException **   
Uno o più parametri nella richiesta non sono validi.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

 ** ResourcePreconditionNotMetException **   
L'operazione non è riuscita perché una condizione non era soddisfatta in anticipo.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_GetRevision_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/GetRevision) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/GetRevision) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/GetRevision) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/GetRevision) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/GetRevision) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/GetRevision) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/GetRevision) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/GetRevision) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/GetRevision) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/GetRevision) 

# ListJournalKinesisStreamsForLedger
<a name="API_ListJournalKinesisStreamsForLedger"></a>

Restituisce tutti i flussi di journal Amazon QLDB per un determinato registro.

Questa azione non restituisce alcun flusso di journal scaduto. Per ulteriori informazioni, consulta [Scadenza per i flussi di terminali](https://docs.aws.amazon.com/qldb/latest/developerguide/streams.create.html#streams.create.states.expiration) nella *Amazon QLDB Developer Guide*.

Questa azione restituisce un massimo di articoli. `MaxResults` È impaginato in modo da poter recuperare tutti gli elementi `ListJournalKinesisStreamsForLedger` chiamando più volte.

## Sintassi della richiesta
<a name="API_ListJournalKinesisStreamsForLedger_RequestSyntax"></a>

```
GET /ledgers/name/journal-kinesis-streams?max_results=MaxResults&next_token=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListJournalKinesisStreamsForLedger_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_ListJournalKinesisStreamsForLedger_RequestSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-request-uri-LedgerName"></a>
Il nome del libro mastro.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

 ** [MaxResults](#API_ListJournalKinesisStreamsForLedger_RequestSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-request-uri-MaxResults"></a>
Il numero massimo di risultati da restituire in una singola richiesta. `ListJournalKinesisStreamsForLedger` (Il numero effettivo di risultati restituiti potrebbe essere inferiore.)  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.

 ** [NextToken](#API_ListJournalKinesisStreamsForLedger_RequestSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-request-uri-NextToken"></a>
Un token di impaginazione, che indica che si desidera recuperare la pagina successiva di risultati. Se hai ricevuto un valore per `NextToken` nella risposta di una `ListJournalKinesisStreamsForLedger` chiamata precedente, dovresti usare quel valore come input qui.  
Vincoli di lunghezza: lunghezza minima di 4. La lunghezza massima è 1024 caratteri.  
Modello: `^[A-Za-z-0-9+/=]+$` 

## Corpo della richiesta
<a name="API_ListJournalKinesisStreamsForLedger_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListJournalKinesisStreamsForLedger_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Streams": [ 
      { 
         "Arn": "string",
         "CreationTime": number,
         "ErrorCause": "string",
         "ExclusiveEndTime": number,
         "InclusiveStartTime": number,
         "KinesisConfiguration": { 
            "AggregationEnabled": boolean,
            "StreamArn": "string"
         },
         "LedgerName": "string",
         "RoleArn": "string",
         "Status": "string",
         "StreamId": "string",
         "StreamName": "string"
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListJournalKinesisStreamsForLedger_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [NextToken](#API_ListJournalKinesisStreamsForLedger_ResponseSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-response-NextToken"></a>
+ Se `NextToken` è vuoto, l'ultima pagina dei risultati è stata elaborata e non ci sono altri risultati da recuperare.
+ Se *non `NextToken`* è vuoto, sono disponibili altri risultati. Per recuperare la pagina successiva di risultati, utilizzare il valore di `NextToken` in una `ListJournalKinesisStreamsForLedger` chiamata successiva.
Tipo: stringa  
Vincoli di lunghezza: lunghezza minima di 4. La lunghezza massima è 1024 caratteri.  
Modello: `^[A-Za-z-0-9+/=]+$` 

 ** [Streams](#API_ListJournalKinesisStreamsForLedger_ResponseSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-response-Streams"></a>
I flussi di journal QLDB attualmente associati al registro specificato.  
Tipo: matrice di oggetti [JournalKinesisStreamDescription](API_JournalKinesisStreamDescription.md)

## Errori
<a name="API_ListJournalKinesisStreamsForLedger_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterException **   
Uno o più parametri nella richiesta non sono validi.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

 ** ResourcePreconditionNotMetException **   
L'operazione non è riuscita perché una condizione non era soddisfatta in anticipo.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_ListJournalKinesisStreamsForLedger_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 

# ListJournalS3Exports
<a name="API_ListJournalS3Exports"></a>

Restituisce tutti i lavori di esportazione delle scritture contabili per tutti i libri contabili associati alla regione corrente Account AWS e alla regione.

Questa azione restituisce un massimo di `MaxResults` elementi ed è suddivisa in pagine in modo da poter recuperare tutti gli elementi chiamando più volte. `ListJournalS3Exports`

Questa azione non restituisce alcun processo di esportazione scaduto. Per ulteriori informazioni, [consulta la scadenza dei lavori di esportazione](https://docs.aws.amazon.com/qldb/latest/developerguide/export-journal.request.html#export-journal.request.expiration) nella *Amazon QLDB Developer Guide*.

## Sintassi della richiesta
<a name="API_ListJournalS3Exports_RequestSyntax"></a>

```
GET /journal-s3-exports?max_results=MaxResults&next_token=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListJournalS3Exports_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [MaxResults](#API_ListJournalS3Exports_RequestSyntax) **   <a name="qldb-ListJournalS3Exports-request-uri-MaxResults"></a>
Il numero massimo di risultati da restituire in una singola `ListJournalS3Exports` richiesta. (Il numero effettivo di risultati restituiti potrebbe essere inferiore.)  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.

 ** [NextToken](#API_ListJournalS3Exports_RequestSyntax) **   <a name="qldb-ListJournalS3Exports-request-uri-NextToken"></a>
Un token di impaginazione, che indica che si desidera recuperare la pagina successiva di risultati. Se hai ricevuto un valore per `NextToken` nella risposta di una `ListJournalS3Exports` chiamata precedente, allora dovresti usare quel valore come input qui.  
Vincoli di lunghezza: lunghezza minima di 4. La lunghezza massima è 1024 caratteri.  
Modello: `^[A-Za-z-0-9+/=]+$` 

## Corpo della richiesta
<a name="API_ListJournalS3Exports_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListJournalS3Exports_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "JournalS3Exports": [ 
      { 
         "ExclusiveEndTime": number,
         "ExportCreationTime": number,
         "ExportId": "string",
         "InclusiveStartTime": number,
         "LedgerName": "string",
         "OutputFormat": "string",
         "RoleArn": "string",
         "S3ExportConfiguration": { 
            "Bucket": "string",
            "EncryptionConfiguration": { 
               "KmsKeyArn": "string",
               "ObjectEncryptionType": "string"
            },
            "Prefix": "string"
         },
         "Status": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementi di risposta
<a name="API_ListJournalS3Exports_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [JournalS3Exports](#API_ListJournalS3Exports_ResponseSyntax) **   <a name="qldb-ListJournalS3Exports-response-JournalS3Exports"></a>
I lavori di esportazione delle scritture contabili per tutti i libri contabili associati alla regione corrente Account AWS e alla regione.  
Tipo: matrice di oggetti [JournalS3ExportDescription](API_JournalS3ExportDescription.md)

 ** [NextToken](#API_ListJournalS3Exports_ResponseSyntax) **   <a name="qldb-ListJournalS3Exports-response-NextToken"></a>
+ Se `NextToken` è vuoto, significa che l'ultima pagina dei risultati è stata elaborata e non ci sono altri risultati da recuperare.
+ Se *non `NextToken`* è vuoto, allora ci sono altri risultati disponibili. Per recuperare la pagina successiva di risultati, usa il valore di `NextToken` in una `ListJournalS3Exports` chiamata successiva.
Tipo: stringa  
Vincoli di lunghezza: lunghezza minima di 4. La lunghezza massima è 1024 caratteri.  
Modello: `^[A-Za-z-0-9+/=]+$` 

## Errori
<a name="API_ListJournalS3Exports_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

## Vedi anche
<a name="API_ListJournalS3Exports_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ListJournalS3Exports) 

# ListJournalS3ExportsForLedger
<a name="API_ListJournalS3ExportsForLedger"></a>

Restituisce tutti i lavori di esportazione delle scritture contabili per un registro specificato.

Questa azione restituisce un massimo di `MaxResults` elementi ed è suddivisa in pagine in modo da poter recuperare tutti gli elementi chiamando più volte. `ListJournalS3ExportsForLedger`

Questa azione non restituisce alcun processo di esportazione scaduto. Per ulteriori informazioni, [consulta la scadenza dei lavori di esportazione](https://docs.aws.amazon.com/qldb/latest/developerguide/export-journal.request.html#export-journal.request.expiration) nella *Amazon QLDB Developer Guide*.

## Sintassi della richiesta
<a name="API_ListJournalS3ExportsForLedger_RequestSyntax"></a>

```
GET /ledgers/name/journal-s3-exports?max_results=MaxResults&next_token=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListJournalS3ExportsForLedger_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [MaxResults](#API_ListJournalS3ExportsForLedger_RequestSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-request-uri-MaxResults"></a>
Il numero massimo di risultati da restituire in una singola `ListJournalS3ExportsForLedger` richiesta. (Il numero effettivo di risultati restituiti potrebbe essere inferiore.)  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.

 ** [name](#API_ListJournalS3ExportsForLedger_RequestSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-request-uri-Name"></a>
Il nome del libro mastro.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

 ** [NextToken](#API_ListJournalS3ExportsForLedger_RequestSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-request-uri-NextToken"></a>
Un token di impaginazione, che indica che si desidera recuperare la pagina successiva di risultati. Se hai ricevuto un valore per `NextToken` nella risposta di una `ListJournalS3ExportsForLedger` chiamata precedente, allora dovresti usare quel valore come input qui.  
Vincoli di lunghezza: lunghezza minima di 4. La lunghezza massima è 1024 caratteri.  
Modello: `^[A-Za-z-0-9+/=]+$` 

## Corpo della richiesta
<a name="API_ListJournalS3ExportsForLedger_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListJournalS3ExportsForLedger_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "JournalS3Exports": [ 
      { 
         "ExclusiveEndTime": number,
         "ExportCreationTime": number,
         "ExportId": "string",
         "InclusiveStartTime": number,
         "LedgerName": "string",
         "OutputFormat": "string",
         "RoleArn": "string",
         "S3ExportConfiguration": { 
            "Bucket": "string",
            "EncryptionConfiguration": { 
               "KmsKeyArn": "string",
               "ObjectEncryptionType": "string"
            },
            "Prefix": "string"
         },
         "Status": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementi di risposta
<a name="API_ListJournalS3ExportsForLedger_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [JournalS3Exports](#API_ListJournalS3ExportsForLedger_ResponseSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-response-JournalS3Exports"></a>
I lavori di esportazione delle scritture contabili attualmente associati al libro mastro specificato.  
Tipo: matrice di oggetti [JournalS3ExportDescription](API_JournalS3ExportDescription.md)

 ** [NextToken](#API_ListJournalS3ExportsForLedger_ResponseSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-response-NextToken"></a>
+ Se `NextToken` è vuoto, significa che l'ultima pagina dei risultati è stata elaborata e non ci sono altri risultati da recuperare.
+ Se *non `NextToken`* è vuoto, ci sono altri risultati disponibili. Per recuperare la pagina successiva di risultati, usa il valore di `NextToken` in una `ListJournalS3ExportsForLedger` chiamata successiva.
Tipo: stringa  
Vincoli di lunghezza: lunghezza minima di 4. La lunghezza massima è 1024 caratteri.  
Modello: `^[A-Za-z-0-9+/=]+$` 

## Errori
<a name="API_ListJournalS3ExportsForLedger_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

## Vedi anche
<a name="API_ListJournalS3ExportsForLedger_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ListJournalS3ExportsForLedger) 

# ListLedgers
<a name="API_ListLedgers"></a>

Restituisce tutti i libri contabili associati alla regione corrente Account AWS e alla regione.

Questa azione restituisce un massimo di `MaxResults` elementi ed è suddivisa in pagine in modo da poter recuperare tutti gli elementi chiamando più volte. `ListLedgers`

## Sintassi della richiesta
<a name="API_ListLedgers_RequestSyntax"></a>

```
GET /ledgers?max_results=MaxResults&next_token=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListLedgers_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [MaxResults](#API_ListLedgers_RequestSyntax) **   <a name="qldb-ListLedgers-request-uri-MaxResults"></a>
Il numero massimo di risultati da restituire in una singola richiesta. `ListLedgers` (Il numero effettivo di risultati restituiti potrebbe essere inferiore.)  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.

 ** [NextToken](#API_ListLedgers_RequestSyntax) **   <a name="qldb-ListLedgers-request-uri-NextToken"></a>
Un token di impaginazione, che indica che si desidera recuperare la pagina successiva di risultati. Se hai ricevuto un valore per `NextToken` nella risposta di una `ListLedgers` chiamata precedente, allora dovresti usare quel valore come input qui.  
Vincoli di lunghezza: lunghezza minima di 4. La lunghezza massima è 1024 caratteri.  
Modello: `^[A-Za-z-0-9+/=]+$` 

## Corpo della richiesta
<a name="API_ListLedgers_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListLedgers_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Ledgers": [ 
      { 
         "CreationDateTime": number,
         "Name": "string",
         "State": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementi di risposta
<a name="API_ListLedgers_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [Ledgers](#API_ListLedgers_ResponseSyntax) **   <a name="qldb-ListLedgers-response-Ledgers"></a>
I libri contabili associati alla corrente Account AWS e alla regione.  
Tipo: matrice di oggetti [LedgerSummary](API_LedgerSummary.md)

 ** [NextToken](#API_ListLedgers_ResponseSyntax) **   <a name="qldb-ListLedgers-response-NextToken"></a>
Un token di impaginazione, che indica se ci sono più risultati disponibili:  
+ Se `NextToken` è vuoto, significa che l'ultima pagina dei risultati è stata elaborata e non ci sono altri risultati da recuperare.
+ Se *non `NextToken`* è vuoto, allora ci sono altri risultati disponibili. Per recuperare la pagina successiva di risultati, usa il valore di `NextToken` in una `ListLedgers` chiamata successiva.
Tipo: stringa  
Vincoli di lunghezza: lunghezza minima di 4. La lunghezza massima è 1024 caratteri.  
Modello: `^[A-Za-z-0-9+/=]+$` 

## Errori
<a name="API_ListLedgers_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

## Vedi anche
<a name="API_ListLedgers_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ListLedgers) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

Restituisce tutti i tag per una risorsa Amazon QLDB specificata.

## Sintassi della richiesta
<a name="API_ListTagsForResource_RequestSyntax"></a>

```
GET /tags/resourceArn HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListTagsForResource_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [resourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="qldb-ListTagsForResource-request-uri-ResourceArn"></a>
L'Amazon Resource Name (ARN) per cui elencare i tag. Per esempio:  
 `arn:aws:qldb:us-east-1:123456789012:ledger/exampleLedger`   
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 1600 caratteri.  
Campo obbligatorio: sì

## Corpo della richiesta
<a name="API_ListTagsForResource_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListTagsForResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Tags": { 
      "string" : "string" 
   }
}
```

## Elementi di risposta
<a name="API_ListTagsForResource_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [Tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="qldb-ListTagsForResource-response-Tags"></a>
I tag attualmente associati alla risorsa Amazon QLDB specificata.  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.  
Limiti di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.

## Errori
<a name="API_ListTagsForResource_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterException **   
Uno o più parametri nella richiesta non sono validi.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_ListTagsForResource_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ListTagsForResource) 

# StreamJournalToKinesis
<a name="API_StreamJournalToKinesis"></a>

Crea uno stream di journal per un determinato registro Amazon QLDB. Il flusso acquisisce ogni revisione del documento di cui viene eseguito il commit al journal del libro mastro e invia i dati a una specifica risorsa Amazon Kinesis Data Streams.

## Sintassi della richiesta
<a name="API_StreamJournalToKinesis_RequestSyntax"></a>

```
POST /ledgers/name/journal-kinesis-streams HTTP/1.1
Content-type: application/json

{
   "ExclusiveEndTime": number,
   "InclusiveStartTime": number,
   "KinesisConfiguration": { 
      "AggregationEnabled": boolean,
      "StreamArn": "string"
   },
   "RoleArn": "string",
   "StreamName": "string",
   "Tags": { 
      "string" : "string" 
   }
}
```

## Parametri della richiesta URI
<a name="API_StreamJournalToKinesis_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-uri-LedgerName"></a>
Il nome del libro mastro.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

## Corpo della richiesta
<a name="API_StreamJournalToKinesis_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [ExclusiveEndTime](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-ExclusiveEndTime"></a>
Data e ora esclusive che specificano quando termina il flusso. Se non si definisce questo parametro, il flusso viene eseguito a tempo indeterminato fino a quando non lo si annulla.  
`ExclusiveEndTime` deve essere in formato data e ora `ISO 8601` e in Universal Coordinated Time (UTC). Ad esempio: `2019-06-13T21:36:34Z`.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** [InclusiveStartTime](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-InclusiveStartTime"></a>
Data e ora di inizio inclusive da cui iniziare lo streaming dei dati del journal. Questo parametro deve essere in formato data e ora `ISO 8601` e in Universal Coordinated Time (UTC). Ad esempio: `2019-06-13T21:36:34Z`.  
`InclusiveStartTime` non può essere in futuro e deve essere precedente a `ExclusiveEndTime`.  
Se si fornisce un `InclusiveStartTime` che è precedente a `CreationDateTime` del libro mastro, QLDB viene effettivamente impostato in modo predefinito su `CreationDateTime` del libro mastro.  
Tipo: Timestamp  
Campo obbligatorio: sì

 ** [KinesisConfiguration](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-KinesisConfiguration"></a>
Le impostazioni di configurazione della destinazione Kinesis Data Streams per la richiesta di flusso.  
Tipo: oggetto [KinesisConfiguration](API_KinesisConfiguration.md)  
Campo obbligatorio: sì

 ** [RoleArn](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-RoleArn"></a>
L'Amazon Resource Name (ARN) del ruolo IAM che concede autorizzazioni QLDB per un flusso di journal per scrivere record di dati in una risorsa Kinesis Data Streams.  
Per passare un ruolo a QLDB quando si richiede un flusso journal, è necessario disporre delle autorizzazioni per eseguire l'operazione `iam:PassRole` sulla risorsa del ruolo IAM. Questa operazione è necessaria per tutte le richieste di flusso journal.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 1600 caratteri.  
Campo obbligatorio: sì

 ** [StreamName](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-StreamName"></a>
Il nome che si desidera assegnare al flusso del journal QLDB. I nomi definiti dall'utente possono aiutare a identificare e indicare lo scopo di un flusso.  
Il nome del flusso deve essere univoco tra gli altri flussi *attivi* per un determinato libro mastro. I nomi dei flussi hanno gli stessi vincoli per la denominazione dei nomi dei libri mastri, come definito nell'argomento relativo alle [quote in Amazon QLDB](https://docs.aws.amazon.com/qldb/latest/developerguide/limits.html#limits.naming) in *Amazon QLDB Developer Guide*.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

 ** [Tags](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-Tags"></a>
Le coppie chiave-valore da aggiungere come tag allo stream che desideri creare. Le chiavi dei tag prevedono una distinzione tra lettere maiuscole e minuscole. I valori dei tag fanno distinzione tra maiuscole e minuscole e possono essere nulli.  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.  
Limiti di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Campo obbligatorio: no

## Sintassi della risposta
<a name="API_StreamJournalToKinesis_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "StreamId": "string"
}
```

## Elementi di risposta
<a name="API_StreamJournalToKinesis_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [StreamId](#API_StreamJournalToKinesis_ResponseSyntax) **   <a name="qldb-StreamJournalToKinesis-response-StreamId"></a>
L'UUID (rappresentato nel testo con codifica Base62) che QLDB assegna a ogni flusso di journal QLDB.  
Tipo: stringa  
Vincoli di lunghezza: lunghezza fissa di 22.  
Modello: `^[A-Za-z-0-9]+$` 

## Errori
<a name="API_StreamJournalToKinesis_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterException **   
Uno o più parametri nella richiesta non sono validi.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

 ** ResourcePreconditionNotMetException **   
L'operazione non è riuscita perché una condizione non era soddisfatta in anticipo.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_StreamJournalToKinesis_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/StreamJournalToKinesis) 

# TagResource
<a name="API_TagResource"></a>

Aggiunge uno o più tag a una risorsa Amazon QLDB specificata.

Una risorsa può avere fino a 50 tag. Se provi a creare più di 50 tag per una risorsa, la richiesta ha esito negativo e restituisce un errore.

## Sintassi della richiesta
<a name="API_TagResource_RequestSyntax"></a>

```
POST /tags/resourceArn HTTP/1.1
Content-type: application/json

{
   "Tags": { 
      "string" : "string" 
   }
}
```

## Parametri della richiesta URI
<a name="API_TagResource_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [resourceArn](#API_TagResource_RequestSyntax) **   <a name="qldb-TagResource-request-uri-ResourceArn"></a>
L'Amazon Resource Name (ARN) a cui desideri aggiungere i tag. Per esempio:  
 `arn:aws:qldb:us-east-1:123456789012:ledger/exampleLedger`   
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 1600 caratteri.  
Campo obbligatorio: sì

## Corpo della richiesta
<a name="API_TagResource_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="qldb-TagResource-request-Tags"></a>
Le coppie chiave-valore da aggiungere come tag alla risorsa QLDB specificata. Le chiavi dei tag prevedono una distinzione tra lettere maiuscole e minuscole. Se si specifica una chiave già esistente per la risorsa, la richiesta ha esito negativo e restituisce un errore. I valori dei tag fanno distinzione tra maiuscole e minuscole e possono essere nulli.  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.  
Limiti di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Campo obbligatorio: sì

## Sintassi della risposta
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_TagResource_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_TagResource_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterException **   
Uno o più parametri nella richiesta non sono validi.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_TagResource_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/TagResource) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/TagResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/TagResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/TagResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/TagResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/TagResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/TagResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/TagResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/TagResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

Rimuove uno o più tag da una risorsa Amazon QLDB specificata. Puoi specificare fino a 50 chiavi di tag da rimuovere.

## Sintassi della richiesta
<a name="API_UntagResource_RequestSyntax"></a>

```
DELETE /tags/resourceArn?tagKeys=TagKeys HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_UntagResource_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [resourceArn](#API_UntagResource_RequestSyntax) **   <a name="qldb-UntagResource-request-uri-ResourceArn"></a>
L'Amazon Resource Name (ARN) da cui rimuovere i tag. Per esempio:  
 `arn:aws:qldb:us-east-1:123456789012:ledger/exampleLedger`   
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 1600 caratteri.  
Campo obbligatorio: sì

 ** [TagKeys](#API_UntagResource_RequestSyntax) **   <a name="qldb-UntagResource-request-uri-TagKeys"></a>
L'elenco delle chiavi dei tag da rimuovere.  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.  
Campo obbligatorio: sì

## Corpo della richiesta
<a name="API_UntagResource_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_UntagResource_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UntagResource_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterException **   
Uno o più parametri nella richiesta non sono validi.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_UntagResource_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/UntagResource) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/UntagResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/UntagResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/UntagResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/UntagResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/UntagResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/UntagResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/UntagResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/UntagResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/UntagResource) 

# UpdateLedger
<a name="API_UpdateLedger"></a>

Aggiorna le proprietà su un libro mastro.

## Sintassi della richiesta
<a name="API_UpdateLedger_RequestSyntax"></a>

```
PATCH /ledgers/name HTTP/1.1
Content-type: application/json

{
   "DeletionProtection": boolean,
   "KmsKey": "string"
}
```

## Parametri della richiesta URI
<a name="API_UpdateLedger_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_UpdateLedger_RequestSyntax) **   <a name="qldb-UpdateLedger-request-uri-Name"></a>
Il nome del libro mastro.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

## Corpo della richiesta
<a name="API_UpdateLedger_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [DeletionProtection](#API_UpdateLedger_RequestSyntax) **   <a name="qldb-UpdateLedger-request-DeletionProtection"></a>
Specifica se il libro mastro è protetto dall'eliminazione da parte di un utente qualsiasi. Se non definita al momento della creazione del libro mastro, 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 chiamando l'operazione `UpdateLedger` per impostare questo parametro su `false`.  
Tipo: Booleano  
Campo obbligatorio: no

 ** [KmsKey](#API_UpdateLedger_RequestSyntax) **   <a name="qldb-UpdateLedger-request-KmsKey"></a>
La chiave in AWS Key Management Service (AWS KMS) da utilizzare per la crittografia dei dati inattivi nel registro. Per ulteriori informazioni, consulta [Crittografia dei dati inattivi](https://docs.aws.amazon.com/qldb/latest/developerguide/encryption-at-rest.html) nella *Guida per gli sviluppatori di Amazon QLDB*.  
Per specificare questo parametro, puoi utilizzare una delle opzioni seguenti:  
+  `AWS_OWNED_KMS_KEY`: utilizza una AWS KMS chiave posseduta e gestita da per tuo AWS conto.
+  **Non definito**: non apporta modifiche alla chiave KMS del registro.
+  **Una chiave KMS simmetrica valida gestita dal cliente**: usa le chiave KMS di crittografia simmetrica specificata nell'account che crei, possiedi e gestisci.

  Amazon QLDB non supporta le chiavi asimmetriche. *Per ulteriori informazioni, consulta [Uso delle chiavi simmetriche e asimmetriche](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) nella Guida per gli sviluppatori. AWS Key Management Service *
Per specificare una chiave KMS gestita dal cliente, utilizza il relativo ID chiave, il nome della risorsa Amazon (ARN), il nome dell'alias o l'ARN dell'alias. Quando utilizzi un nome alias, aggiungi il prefisso `"alias/"`. Per specificare una chiave in un'altra Account AWS, è necessario utilizzare la chiave ARN o l'alias ARN.  
Per esempio:  
+ ID chiave: `1234abcd-12ab-34cd-56ef-1234567890ab` 
+ ARN chiave: `arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` 
+ Nome alias: `alias/ExampleAlias` 
+ ARN alias: `arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias` 
*Per ulteriori informazioni, consulta [Key identifiers (KeyId)](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id) nella Developer Guide. AWS Key Management Service *  
Tipo: stringa  
Vincoli di lunghezza: lunghezza massima di 1600.  
Campo obbligatorio: no

## Sintassi della risposta
<a name="API_UpdateLedger_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Arn": "string",
   "CreationDateTime": number,
   "DeletionProtection": boolean,
   "EncryptionDescription": { 
      "EncryptionStatus": "string",
      "InaccessibleKmsKeyDateTime": number,
      "KmsKeyArn": "string"
   },
   "Name": "string",
   "State": "string"
}
```

## Elementi di risposta
<a name="API_UpdateLedger_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [Arn](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-Arn"></a>
L'Amazon Resource Name (ARN) per il registro.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 1600 caratteri.

 ** [CreationDateTime](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-CreationDateTime"></a>
La data e l'ora, in formato epoch time, in cui è stato creato il libro mastro. (Il formato dell'ora epoch è il numero di secondi trascorsi dalle 00:00 del 1° gennaio 1970 UTC.)  
Tipo: Timestamp

 ** [DeletionProtection](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-DeletionProtection"></a>
Specifica se il libro mastro è protetto dall'eliminazione da parte di un utente qualsiasi. Se non definita al momento della creazione del libro mastro, 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 chiamando l'operazione `UpdateLedger` per impostare questo parametro su `false`.  
Tipo: Booleano

 ** [EncryptionDescription](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-EncryptionDescription"></a>
Informazioni sulla crittografia dei dati inattivi nel registro. Ciò include lo stato corrente, la AWS KMS chiave e il momento in cui la chiave è diventata inaccessibile (in caso di errore).  
Tipo: oggetto [LedgerEncryptionDescription](API_LedgerEncryptionDescription.md)

 ** [Name](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-Name"></a>
Il nome del libro mastro.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$` 

 ** [State](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-State"></a>
Lo stato attuale del libro mastro.  
Tipo: stringa  
Valori validi: `CREATING | ACTIVE | DELETING | DELETED` 

## Errori
<a name="API_UpdateLedger_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterException **   
Uno o più parametri nella richiesta non sono validi.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_UpdateLedger_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/UpdateLedger) 

# UpdateLedgerPermissionsMode
<a name="API_UpdateLedgerPermissionsMode"></a>

Aggiorna la modalità di autorizzazione di un libro mastro.

**Importante**  
Prima di passare alla modalità `STANDARD` autorizzazioni, devi prima creare tutte le politiche IAM e i tag di tabella richiesti per evitare interruzioni per gli utenti. Per ulteriori informazioni, consulta [Migrazione alla modalità di autorizzazione standard](https://docs.aws.amazon.com/qldb/latest/developerguide/ledger-management.basics.html#ledger-mgmt.basics.update-permissions.migrating) nella Amazon *QLDB* Developer Guide.

## Sintassi della richiesta
<a name="API_UpdateLedgerPermissionsMode_RequestSyntax"></a>

```
PATCH /ledgers/name/permissions-mode HTTP/1.1
Content-type: application/json

{
   "PermissionsMode": "string"
}
```

## Parametri della richiesta URI
<a name="API_UpdateLedgerPermissionsMode_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_UpdateLedgerPermissionsMode_RequestSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-request-uri-Name"></a>
Il nome del libro mastro.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

## Corpo della richiesta
<a name="API_UpdateLedgerPermissionsMode_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [PermissionsMode](#API_UpdateLedgerPermissionsMode_RequestSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-request-PermissionsMode"></a>
La modalità di autorizzazione da assegnare al registro. Questo parametro può avere 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.

  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.

  Per impostazione predefinita, questa modalità nega tutte le richieste degli utenti di eseguire qualsiasi comando PartiQL su qualsiasi tabella in questo libro mastro. Per consentire l'esecuzione dei comandi PartiQL, devi creare le policy di autorizzazione IAM per risorse di tabelle e operazioni PartiQL specifiche, oltre all'autorizzazione API `SendCommand` per il libro mastro. Per informazioni, consulta [Getting started with the standard permissions mode](https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started-standard-mode.html) (Nozioni di base sulla modalità di autorizzazione standard) nella *Guida per gli sviluppatori di Amazon QLDB*.
Ti consigliamo di utilizzare la modalità di autorizzazione `STANDARD` per incrementare la sicurezza dei dati nel libro mastro.
Tipo: stringa  
Valori validi: `ALLOW_ALL | STANDARD`   
Campo obbligatorio: sì

## Sintassi della risposta
<a name="API_UpdateLedgerPermissionsMode_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Arn": "string",
   "Name": "string",
   "PermissionsMode": "string"
}
```

## Elementi di risposta
<a name="API_UpdateLedgerPermissionsMode_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [Arn](#API_UpdateLedgerPermissionsMode_ResponseSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-response-Arn"></a>
L'Amazon Resource Name (ARN) per il registro.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 1600 caratteri.

 ** [Name](#API_UpdateLedgerPermissionsMode_ResponseSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-response-Name"></a>
Il nome del libro mastro.  
Tipo: stringa  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$` 

 ** [PermissionsMode](#API_UpdateLedgerPermissionsMode_ResponseSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-response-PermissionsMode"></a>
L'attuale modalità di autorizzazione del registro.  
Tipo: stringa  
Valori validi: `ALLOW_ALL | STANDARD` 

## Errori
<a name="API_UpdateLedgerPermissionsMode_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterException **   
Uno o più parametri nella richiesta non sono validi.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_UpdateLedgerPermissionsMode_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 

# Sessione Amazon QLDB
<a name="API_Operations_Amazon_QLDB_Session"></a>

**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](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

Le seguenti azioni sono supportate dalla sessione Amazon QLDB:
+  [SendCommand](API_QLDB-Session_SendCommand.md) 

# SendCommand
<a name="API_QLDB-Session_SendCommand"></a>

Invia un comando a un registro Amazon QLDB.

**Nota**  
Invece di interagire direttamente con questa API, consigliamo di utilizzare il driver QLDB o la shell QLDB per eseguire transazioni di dati su un registro.  
Se lavori con un AWS SDK, usa il driver QLDB. Il driver fornisce un livello di astrazione di alto livello sopra questa API di dati di *sessione QLDB* e gestisce l'operazione per te. `SendCommand` Per informazioni e un elenco dei linguaggi di programmazione supportati, consulta [Guida introduttiva al driver](https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started-driver.html) nella *Amazon QLDB* Developer Guide.
Se stai lavorando con AWS Command Line Interface (AWS CLI), usa la shell QLDB. La shell è un'interfaccia a riga di comando che utilizza il driver QLDB per interagire con un registro. Per informazioni, consulta [Accedere ad Amazon QLDB usando la shell QLDB](https://docs.aws.amazon.com/qldb/latest/developerguide/data-shell.html).

## Sintassi della richiesta
<a name="API_QLDB-Session_SendCommand_RequestSyntax"></a>

```
{
   "AbortTransaction": { 
   },
   "CommitTransaction": { 
      "CommitDigest": blob,
      "TransactionId": "string"
   },
   "EndSession": { 
   },
   "ExecuteStatement": { 
      "Parameters": [ 
         { 
            "IonBinary": blob,
            "IonText": "string"
         }
      ],
      "Statement": "string",
      "TransactionId": "string"
   },
   "FetchPage": { 
      "NextPageToken": "string",
      "TransactionId": "string"
   },
   "SessionToken": "string",
   "StartSession": { 
      "LedgerName": "string"
   },
   "StartTransaction": { 
   }
}
```

## Parametri della richiesta
<a name="API_QLDB-Session_SendCommand_RequestParameters"></a>

Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

La richiesta accetta i seguenti dati in formato JSON.

 ** [AbortTransaction](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-AbortTransaction"></a>
Comando per interrompere la transazione corrente.  
Tipo: oggetto [AbortTransactionRequest](API_QLDB-Session_AbortTransactionRequest.md)  
Campo obbligatorio: no

 ** [CommitTransaction](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-CommitTransaction"></a>
Comando per confermare la transazione specificata.  
Tipo: oggetto [CommitTransactionRequest](API_QLDB-Session_CommitTransactionRequest.md)  
Campo obbligatorio: no

 ** [EndSession](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-EndSession"></a>
Comando per terminare la sessione corrente.  
Tipo: oggetto [EndSessionRequest](API_QLDB-Session_EndSessionRequest.md)  
Campo obbligatorio: no

 ** [ExecuteStatement](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-ExecuteStatement"></a>
Comando per eseguire un'istruzione nella transazione specificata.  
Tipo: oggetto [ExecuteStatementRequest](API_QLDB-Session_ExecuteStatementRequest.md)  
Campo obbligatorio: no

 ** [FetchPage](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-FetchPage"></a>
Comando per recuperare una pagina.  
Tipo: oggetto [FetchPageRequest](API_QLDB-Session_FetchPageRequest.md)  
Campo obbligatorio: no

 ** [SessionToken](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-SessionToken"></a>
Specifica il token di sessione per il comando corrente. Un token di sessione è costante per tutta la durata della sessione.  
Per ottenere un token di sessione, esegui il `StartSession` comando. Questo `SessionToken` è necessario per ogni comando successivo emesso durante la sessione corrente.  
Tipo: stringa  
Vincoli di lunghezza: lunghezza minima di 4. La lunghezza massima è 1024 caratteri.  
Modello: `^[A-Za-z-0-9+/=]+$`   
Campo obbligatorio: no

 ** [StartSession](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-StartSession"></a>
Comando per iniziare una nuova sessione. Un token di sessione viene ottenuto come parte della risposta.  
Tipo: oggetto [StartSessionRequest](API_QLDB-Session_StartSessionRequest.md)  
Campo obbligatorio: no

 ** [StartTransaction](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-StartTransaction"></a>
Comando per iniziare una nuova transazione.  
Tipo: oggetto [StartTransactionRequest](API_QLDB-Session_StartTransactionRequest.md)  
Campo obbligatorio: no

## Sintassi della risposta
<a name="API_QLDB-Session_SendCommand_ResponseSyntax"></a>

```
{
   "AbortTransaction": { 
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      }
   },
   "CommitTransaction": { 
      "CommitDigest": blob,
      "ConsumedIOs": { 
         "ReadIOs": number,
         "WriteIOs": number
      },
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      },
      "TransactionId": "string"
   },
   "EndSession": { 
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      }
   },
   "ExecuteStatement": { 
      "ConsumedIOs": { 
         "ReadIOs": number,
         "WriteIOs": number
      },
      "FirstPage": { 
         "NextPageToken": "string",
         "Values": [ 
            { 
               "IonBinary": blob,
               "IonText": "string"
            }
         ]
      },
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      }
   },
   "FetchPage": { 
      "ConsumedIOs": { 
         "ReadIOs": number,
         "WriteIOs": number
      },
      "Page": { 
         "NextPageToken": "string",
         "Values": [ 
            { 
               "IonBinary": blob,
               "IonText": "string"
            }
         ]
      },
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      }
   },
   "StartSession": { 
      "SessionToken": "string",
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      }
   },
   "StartTransaction": { 
      "TimingInformation": { 
         "ProcessingTimeMilliseconds": number
      },
      "TransactionId": "string"
   }
}
```

## Elementi di risposta
<a name="API_QLDB-Session_SendCommand_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [AbortTransaction](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-AbortTransaction"></a>
Contiene i dettagli della transazione interrotta.  
Tipo: oggetto [AbortTransactionResult](API_QLDB-Session_AbortTransactionResult.md)

 ** [CommitTransaction](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-CommitTransaction"></a>
Contiene i dettagli della transazione confermata.  
Tipo: oggetto [CommitTransactionResult](API_QLDB-Session_CommitTransactionResult.md)

 ** [EndSession](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-EndSession"></a>
Contiene i dettagli della sessione terminata.  
Tipo: oggetto [EndSessionResult](API_QLDB-Session_EndSessionResult.md)

 ** [ExecuteStatement](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-ExecuteStatement"></a>
Contiene i dettagli dell'istruzione eseguita.  
Tipo: oggetto [ExecuteStatementResult](API_QLDB-Session_ExecuteStatementResult.md)

 ** [FetchPage](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-FetchPage"></a>
Contiene i dettagli della pagina recuperata.  
Tipo: oggetto [FetchPageResult](API_QLDB-Session_FetchPageResult.md)

 ** [StartSession](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-StartSession"></a>
Contiene i dettagli della sessione avviata che include un token di sessione. Questo `SessionToken` è necessario per ogni comando successivo emesso durante la sessione corrente.  
Tipo: oggetto [StartSessionResult](API_QLDB-Session_StartSessionResult.md)

 ** [StartTransaction](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-StartTransaction"></a>
Contiene i dettagli della transazione avviata.  
Tipo: oggetto [StartTransactionResult](API_QLDB-Session_StartTransactionResult.md)

## Errori
<a name="API_QLDB-Session_SendCommand_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** BadRequestException **   
Restituito se la richiesta non è valida o contiene un errore, ad esempio un valore di parametro non valido o un parametro obbligatorio mancante.  
Codice di stato HTTP: 400

 ** CapacityExceededException **   
Restituito quando la richiesta supera la capacità di elaborazione del registro.  
Codice di stato HTTP: 400

 ** InvalidSessionException **   
Restituito se la sessione non esiste più perché è andata in timeout o scaduta.  
Codice di stato HTTP: 400

 ** LimitExceededException **   
Restituito se viene superato un limite di risorse, ad esempio il numero di sessioni attive.  
Codice di stato HTTP: 400

 ** OccConflictException **   
Restituito quando una transazione non può essere scritta nel journal a causa di un errore nella fase di verifica dell'*Optimistic Concurrency Control* (OCC).  
Codice di stato HTTP: 400

 ** RateExceededException **   
Restituito quando la frequenza delle richieste supera il throughput consentito.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_QLDB-Session_SendCommand_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-session-2019-07-11/SendCommand)