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à. # ExportJournalToS3 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 ``` 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 La richiesta utilizza i seguenti parametri URI. ** [name](#API_ExportJournalToS3_RequestSyntax) ** 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 La richiesta accetta i seguenti dati in formato JSON. ** [ExclusiveEndTime](#API_ExportJournalToS3_RequestSyntax) ** 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) ** 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) ** 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) ** 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) ** 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 ``` HTTP/1.1 200 Content-type: application/json { "ExportId": "string" } ``` ## Elementi di risposta 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) ** 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 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 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)