Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
ExportJournalToS3
Exportiert Journalinhalte innerhalb eines Datums- und Zeitbereichs aus einem Hauptbuch in einen angegebenen Amazon Simple Storage Service (Amazon S3) -Bucket. Ein Journal-Exportauftrag kann die Datenobjekte entweder in der Text- oder Binärdarstellung des Amazon Ion-Formats oder im JSON Lines-Textformat schreiben.
Wenn das Hauptbuch mit den angegebenen Daten nicht Name
existiert, wird geworfenResourceNotFoundException
.
Wenn sich das Hauptbuch mit dem angegebenen Wert im CREATING
Status Name
befindet, wird geworfen. ResourcePreconditionNotMetException
Sie können bis zu zwei gleichzeitige Journalexportanfragen für jedes Buch initiieren. Bei Überschreitung dieser Grenze werden Journal-Exportanfragen ausgelöst. LimitExceededException
Anforderungssyntax
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
"
}
}
URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
- name
-
Der Name des Ledgers.
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 32 Zeichen.
Pattern:
(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$
Erforderlich: Ja
Anforderungstext
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
- ExclusiveEndTime
-
Das exklusive Enddatum und die Uhrzeit für den Bereich der zu exportierenden Journalinhalte.
ExclusiveEndTime
muss imISO 8601
-Datums- und Uhrzeitformat sowie in UTC (Universal Coordinated Time) vorliegen. Zum Beispiel:2019-06-13T21:36:34Z
.ExclusiveEndTime
muss früher oder gleich dem aktuellen UTC-Datum und der Uhrzeit sein.Typ: Zeitstempel
Erforderlich: Ja
- InclusiveStartTime
-
Das inklusive Startdatum und die Startzeit für den Bereich der zu exportierenden Journalinhalte.
InclusiveStartTime
muss imISO 8601
-Datums- und Uhrzeitformat sowie in UTC (Universal Coordinated Time) vorliegen. Zum Beispiel:2019-06-13T21:36:34Z
.Das
InclusiveStartTime
muss vorher seinExclusiveEndTime
.Wenn Sie ein angeben
InclusiveStartTime
, das vor dem Ledger stehtCreationDateTime
, verwendet Amazon QLDB standardmäßig das des Ledgers.CreationDateTime
Typ: Zeitstempel
Erforderlich: Ja
- OutputFormat
-
Das Ausgabeformat Ihrer exportierten Journaldaten. Ein Journal-Exportauftrag kann die Datenobjekte entweder in der Text- oder Binärdarstellung des Amazon Ion-Formats oder im JSON Lines-Textformat
schreiben. Standard:
ION_TEXT
Im Format JSON Lines ist jeder Journalblock in einem exportierten Datenobjekt ein gültiges JSON-Objekt, das durch eine neue Zeile begrenzt ist. Sie können dieses Format verwenden, um JSON-Exporte direkt in Analysetools wie Amazon Athena zu integrieren, und AWS Glue weil diese Dienste JSON mit Zeilenumbrüchen automatisch analysieren können.
Typ: Zeichenfolge
Zulässige Werte:
ION_BINARY | ION_TEXT | JSON
Erforderlich: Nein
- RoleArn
-
Der Amazon-Ressourcenname (ARN) der IAM-Rolle, die QLDB-Berechtigungen für einen Journal-Exportauftrag erteilt, um Folgendes auszuführen:
-
Schreiben Sie Objekte in Ihren Amazon S3 S3-Bucket.
-
(Optional) Verwenden Sie Ihren vom Kunden verwalteten Schlüssel in AWS Key Management Service (AWS KMS) für die serverseitige Verschlüsselung Ihrer exportierten Daten.
Um bei der Anforderung eines Journalexports eine Rolle an QLDB zu übergeben, müssen Sie über die Berechtigungen verfügen, um die
iam:PassRole
Aktion für die IAM-Rollenressource auszuführen. Dies ist für alle Journalexportanfragen erforderlich.Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 20. Maximale Länge beträgt 1600 Zeichen.
Erforderlich: Ja
-
- S3ExportConfiguration
-
Die Konfigurationseinstellungen des Amazon S3 S3-Bucket-Ziels für Ihre Exportanfrage.
Typ: S3ExportConfiguration Objekt
Erforderlich: Ja
Antwortsyntax
HTTP/1.1 200
Content-type: application/json
{
"ExportId": "string"
}
Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
- ExportId
-
Die UUID (dargestellt in Base62-codiertem Text), die QLDB jedem Journal-Exportjob zuweist.
Um Ihre Exportanfrage zu beschreiben und den Status des Jobs zu überprüfen, können Sie to call verwenden.
ExportId
DescribeJournalS3Export
Typ: Zeichenfolge
Längenbeschränkungen: Feste Länge von 22.
Pattern:
^[A-Za-z-0-9]+$
Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.
- ResourceNotFoundException
-
Die angegebene Ressource ist nicht vorhanden.
HTTP Status Code: 404
- ResourcePreconditionNotMetException
-
Der Vorgang ist fehlgeschlagen, weil eine Bedingung nicht im Voraus erfüllt wurde.
HTTP-Statuscode: 412
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: