ExportJournalToS3 - Database Amazon Quantum Ledger (Amazon QLDB)
Sintassi della richiestaParametri della richiesta URICorpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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

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

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.

ExclusiveEndTimeDeve essere inferiore o uguale alla data e all'ora UTC correnti.

Tipo: Timestamp

Campo obbligatorio: sì

InclusiveStartTime

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.

InclusiveStartTimeDeve essere primaExclusiveEndTime.

Se fornisci un codice InclusiveStartTime che precede il registroCreationDateTime, Amazon QLDB lo imposta come predefinito sul libro mastro. CreationDateTime

Tipo: Timestamp

Campo obbligatorio: sì

OutputFormat

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 o nel formato di testo JSON Lines.

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

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

Le impostazioni di configurazione della destinazione del bucket Amazon S3 per la tua richiesta di esportazione.

Tipo: oggetto S3ExportConfiguration

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

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.

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 uno degli AWS SDK specifici della lingua, consulta quanto segue: