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 geworfen`ResourceNotFoundException`. 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](#API_ExportJournalToS3_RequestSyntax) ** 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](#API_ExportJournalToS3_RequestSyntax) ** Das exklusive Enddatum und die Uhrzeit für den Bereich der zu exportierenden Journalinhalte. `ExclusiveEndTime` muss im `ISO 8601`-Datums- und Uhrzeitformat sowie in UTC (Universal Coordinated Time) vorliegen. 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](#API_ExportJournalToS3_RequestSyntax) ** Das inklusive Startdatum und die Startzeit für den Bereich der zu exportierenden Journalinhalte. `InclusiveStartTime` muss im `ISO 8601`-Datums- und Uhrzeitformat sowie in UTC (Universal Coordinated Time) vorliegen. Beispiel: `2019-06-13T21:36:34Z`. Das `InclusiveStartTime` muss vorher sein`ExclusiveEndTime`. Wenn Sie ein angeben`InclusiveStartTime`, das vor dem Ledger steht`CreationDateTime`, verwendet Amazon QLDB standardmäßig das des Ledgers. `CreationDateTime` Typ: Zeitstempel Erforderlich: Ja ** [OutputFormat](#API_ExportJournalToS3_RequestSyntax) ** Das Ausgabeformat Ihrer exportierten Journaldaten. Ein Journal-Exportauftrag kann die Datenobjekte entweder in der Text- oder Binärdarstellung des [Amazon Ion-Formats](https://docs.aws.amazon.com/qldb/latest/developerguide/ion.html) oder im [JSON Lines-Textformat](https://jsonlines.org/) 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](#API_ExportJournalToS3_RequestSyntax) ** 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](#API_ExportJournalToS3_RequestSyntax) ** Die Konfigurationseinstellungen des Amazon S3 S3-Bucket-Ziels für Ihre Exportanfrage. Typ: [S3ExportConfiguration](API_S3ExportConfiguration.md) 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](#API_ExportJournalToS3_ResponseSyntax) ** 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 anrufen. `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](CommonErrors.md). ** 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 einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS -Befehlszeilenschnittstelle](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/ExportJournalToS3) + [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ExportJournalToS3) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ExportJournalToS3) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ExportJournalToS3) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ExportJournalToS3) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ExportJournalToS3) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ExportJournalToS3) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ExportJournalToS3) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ExportJournalToS3) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ExportJournalToS3)