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.

# Aktionen
<a name="API_Operations"></a>

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Die folgenden Aktionen werden von Amazon QLDB unterstützt:
+  [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) 

Die folgenden Aktionen werden von Amazon QLDB Session unterstützt:
+  [SendCommand](API_QLDB-Session_SendCommand.md) 

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

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Die folgenden Aktionen werden von Amazon QLDB unterstützt:
+  [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>

Beendet einen bestimmten Amazon QLDB-Journal-Stream. Bevor ein Stream abgebrochen werden kann, muss sein aktueller Status „`ACTIVE`“ lauten.

Sie können einen Stream nicht neu starten, nachdem Sie ihn abgebrochen haben. Stornierte QLDB-Stream-Ressourcen unterliegen einer Aufbewahrungsfrist von 7 Tagen, sodass sie nach Ablauf dieses Limits automatisch gelöscht werden.

## Anforderungssyntax
<a name="API_CancelJournalKinesisStream_RequestSyntax"></a>

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

## URI-Anfrageparameter
<a name="API_CancelJournalKinesisStream_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [name](#API_CancelJournalKinesisStream_RequestSyntax) **   <a name="qldb-CancelJournalKinesisStream-request-uri-LedgerName"></a>
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

 ** [streamId](#API_CancelJournalKinesisStream_RequestSyntax) **   <a name="qldb-CancelJournalKinesisStream-request-uri-StreamId"></a>
Die UUID (dargestellt in Base62-codiertem Text) des QLDB-Journal-Streams, der storniert werden soll.  
Längenbeschränkungen: Feste Länge von 22.  
Pattern: `^[A-Za-z-0-9]+$`   
Erforderlich: Ja

## Anforderungstext
<a name="API_CancelJournalKinesisStream_RequestBody"></a>

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<a name="API_CancelJournalKinesisStream_ResponseSyntax"></a>

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

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

## Antwortelemente
<a name="API_CancelJournalKinesisStream_ResponseElements"></a>

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.

 ** [StreamId](#API_CancelJournalKinesisStream_ResponseSyntax) **   <a name="qldb-CancelJournalKinesisStream-response-StreamId"></a>
Die UUID (Base62-codierter Text) des stornierten QLDB-Journal-Streams.  
Typ: Zeichenfolge  
Längenbeschränkungen: Feste Länge von 22.  
Pattern: `^[A-Za-z-0-9]+$` 

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** InvalidParameterException **   
Ein oder mehrere Parameter in der Anfrage sind nicht gültig.  
HTTP Status Code: 400

 ** 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:
<a name="API_CancelJournalKinesisStream_SeeAlso"></a>

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/CancelJournalKinesisStream) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/CancelJournalKinesisStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/CancelJournalKinesisStream) 

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

Erstellt ein neues Hauptbuch in Ihrem AWS-Konto in der aktuellen Region.

## Anforderungssyntax
<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" 
   }
}
```

## URI-Anfrageparameter
<a name="API_CreateLedger_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_CreateLedger_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [DeletionProtection](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-DeletionProtection"></a>
Gibt an, ob der Ledger vor dem Löschen durch einen beliebigen Benutzer geschützt ist. Wenn es während der Ledger-Erstellung nicht definiert wird, ist diese Funktion standardmäßig aktiviert (`true`).  
Wenn der Löschschutz aktiviert ist, müssen Sie ihn zuerst deaktivieren, bevor Sie das Ledger löschen können. Sie können ihn deaktivieren, indem Sie mit dem `UpdateLedger`-Vorgang den Parameter auf `false` einstellen.  
Typ: Boolesch  
Erforderlich: Nein

 ** [KmsKey](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-KmsKey"></a>
Der Schlüssel in AWS Key Management Service (AWS KMS), der für die Verschlüsselung ruhender Daten im Ledger verwendet werden soll. Weitere Informationen finden Sie unter [Verschlüsselung im Ruhezustand](https://docs.aws.amazon.com/qldb/latest/developerguide/encryption-at-rest.html) im *Amazon-QLDB-Entwicklerhandbuch*.  
Verwenden Sie eine der folgenden Optionen, um diesen Parameter anzugeben:  
+  `AWS_OWNED_KMS_KEY`: Verwenden Sie einen AWS KMS Schlüssel, der in Ihrem Namen gehört und von AWS diesem verwaltet wird.
+  **Undefiniert**: Verwenden Sie standardmäßig einen AWS eigenen KMS-Schlüssel.
+  **Ein gültiger, symmetrischer, vom Kunden verwalteter KMS-Schlüssel**: Den angegebenen symmetrischen KMS-Verschlüsselungsschlüssel in Ihrem Konto verwenden, den Sie erstellen, besitzen und verwalten.

  Amazon EBS unterstützt keine asymmetrischen Schlüssel. *Weitere Informationen finden Sie unter [Verwenden von symmetrischen und asymmetrischen Schlüsseln im AWS Key Management Service Entwicklerhandbuch](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html).*
Um einen vom Kunden verwalteten KMS-Schlüssel anzugeben, können Sie seine Schlüssel-ID, den Amazon-Ressourcennamen (ARN), den Aliasnamen oder den Alias-ARN verwenden. Wenn Sie einen Aliasnamen verwenden, stellen Sie ihm `"alias/"` voran. Um einen Schlüssel in einem anderen anzugeben AWS-Konto, müssen Sie den Schlüssel ARN oder den Alias ARN verwenden.  
Zum Beispiel:  
+ Schlüssel-ID: `1234abcd-12ab-34cd-56ef-1234567890ab` 
+ Schüssel-ARN: `arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` 
+ Alias-Name: `alias/ExampleAlias` 
+ Alias-ARN: `arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias` 
Weitere Informationen finden Sie unter [Schlüsselkennungen (KeyId)](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id) im * AWS Key Management Service Entwicklerhandbuch*.  
Typ: Zeichenfolge  
Längenbeschränkungen: Die maximale Länge beträgt 1600.  
Erforderlich: Nein

 ** [Name](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-Name"></a>
Der Name des Ledgers, das Sie erstellen möchten. Der Name muss für alle Ledger AWS-Konto in Ihrer aktuellen Region eindeutig sein.  
Die Beschränkungen für die Namen von Ledgern sind im Abschnitt [Kontingente in Amazon QLDB](https://docs.aws.amazon.com/qldb/latest/developerguide/limits.html#limits.naming) im *Amazon QLDB-Entwicklerhandbuch* definiert.  
Typ: Zeichenfolge  
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

 ** [PermissionsMode](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-PermissionsMode"></a>
Der Berechtigungsmodus, der dem Ledger zugewiesen werden soll, das Sie erstellen möchten. Folgende Parameterwerte sind möglich:  
+  `ALLOW_ALL`: Ein Legacy-Berechtigungsmodus, der die Zugriffskontrolle mit Granularität auf API-Ebene für Ledgers ermöglicht.

  Dieser Modus ermöglicht Benutzern, die `SendCommand`-API-Berechtigung für dieses Ledger zum Ausführen aller PartiQL-Befehle (daher `ALLOW_ALL`) auf beliebigen Tabellen im angegebenen Ledger auszuführen. Dieser Modus ignoriert alle IAM-Berechtigungs-Richtlinien auf Tabellen- oder Befehls-Ebene, die Sie für das Ledger erstellen.
+  `STANDARD`: (*Empfohlen*) Ein Berechtigungsmodus, der Zugriffskontrolle mit feinerer Granularität für Ledger, Tabellen und PartiQL-Befehle ermöglicht.

  Standardmäßig verweigert dieser Modus alle Benutzer-Anforderungen zur Ausführung von PartiQL-Befehlen für Tabellen in diesem Ledger. Damit PartiQL-Befehle ausgeführt werden können, müssen Sie IAM-Berechtigungs-Richtlinien für bestimmte Tabellen-Ressourcen und PartiQL-Aktionen erstellen, zusätzlich zu den `SendCommand` API-Berechtigung für den Ledger. Weitere Informationen finden Sie unter [Erste Schritte mit dem Standard-Berechtigungsmodus](https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started-standard-mode.html) im *Amazon-QLDB-Entwicklerhandbuch*.
Wir empfehlen dringend, den `STANDARD` Berechtigungsmodus, um die Sicherheit Ihrer Ledger-Daten zu maximieren.
Typ: Zeichenfolge  
Zulässige Werte: `ALLOW_ALL | STANDARD`   
Erforderlich: Ja

 ** [Tags](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-Tags"></a>
Die Schlüssel-Wert-Paare, die dem Ledger, das Sie erstellen möchten, als Tags hinzugefügt werden sollen. Bei Tag-Schlüsseln wird zwischen Groß- und Kleinschreibung unterschieden. Bei Tag-Werten wird zwischen Groß- und Kleinschreibung unterschieden und sie können Null sein.  
Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge  
Karteneinträge: Mindestanzahl von 0 Elementen. Die maximale Anzahl beträgt 200 Elemente.  
Schlüssel-Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 128 Zeichen.  
Längenbeschränkungen für Werte: Mindestlänge von 0. Maximale Länge beträgt 256 Zeichen.  
Erforderlich: Nein

## Antwortsyntax
<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"
}
```

## Antwortelemente
<a name="API_CreateLedger_ResponseElements"></a>

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.

 ** [Arn](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-Arn"></a>
Der Amazon-Ressourcenname (ARN) für das Ledger.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 20. Maximale Länge beträgt 1600 Zeichen.

 ** [CreationDateTime](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-CreationDateTime"></a>
Datum und Uhrzeit der Erstellung des Ledgers im Epochenzeitformat. (Das Epochenzeitformat ist die Anzahl der Sekunden, die seit dem 1. Januar 1970 um 00:00:00 Uhr UTC vergangen sind.)  
Typ: Zeitstempel

 ** [DeletionProtection](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-DeletionProtection"></a>
Gibt an, ob der Ledger vor dem Löschen durch einen beliebigen Benutzer geschützt ist. Wenn es während der Ledger-Erstellung nicht definiert wird, ist diese Funktion standardmäßig aktiviert (`true`).  
Wenn der Löschschutz aktiviert ist, müssen Sie ihn zuerst deaktivieren, bevor Sie das Ledger löschen können. Sie können ihn deaktivieren, indem Sie mit dem `UpdateLedger`-Vorgang den Parameter auf `false` einstellen.  
Typ: Boolesch

 ** [KmsKeyArn](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-KmsKeyArn"></a>
Der ARN des vom Kunden verwalteten KMS-Schlüssels, den das Ledger für die Verschlüsselung im Ruhezustand verwendet. Wenn dieser Parameter nicht definiert ist, verwendet das Ledger einen AWS eigenen KMS-Schlüssel für die Verschlüsselung.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 20. Maximale Länge beträgt 1600 Zeichen.

 ** [Name](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-Name"></a>
Der Name des Ledgers.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 32 Zeichen.  
Pattern: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$` 

 ** [PermissionsMode](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-PermissionsMode"></a>
Der Berechtigungsmodus des Ledgers, das Sie erstellt haben.  
Typ: Zeichenfolge  
Zulässige Werte: `ALLOW_ALL | STANDARD` 

 ** [State](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-State"></a>
Der aktuelle Status des Ledgers.  
Typ: Zeichenfolge  
Zulässige Werte: `CREATING | ACTIVE | DELETING | DELETED` 

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** InvalidParameterException **   
Ein oder mehrere Parameter in der Anfrage sind nicht gültig.  
HTTP Status Code: 400

 ** LimitExceededException **   
Sie haben das Limit für die maximal zulässige Anzahl von Ressourcen erreicht.  
HTTP Status Code: 400

 ** ResourceAlreadyExistsException **   
Die angegebene Ressource ist bereits vorhanden.  
HTTP-Statuscode: 409

 ** ResourceInUseException **   
Die angegebene Ressource kann derzeit nicht geändert werden.  
HTTP-Statuscode: 409

## Weitere Informationen finden Sie unter:
<a name="API_CreateLedger_SeeAlso"></a>

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/CreateLedger) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/CreateLedger) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/CreateLedger) 

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

Löscht ein Ledger und seinen gesamten Inhalt. Diese Aktion ist unumkehrbar.

Wenn der Löschschutz aktiviert ist, müssen Sie ihn zuerst deaktivieren, bevor Sie das Ledger löschen können. Sie können ihn deaktivieren, indem Sie mit dem `UpdateLedger`-Vorgang den Parameter auf `false` einstellen.

## Anforderungssyntax
<a name="API_DeleteLedger_RequestSyntax"></a>

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

## URI-Anfrageparameter
<a name="API_DeleteLedger_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [name](#API_DeleteLedger_RequestSyntax) **   <a name="qldb-DeleteLedger-request-uri-Name"></a>
Der Name des Ledgers, das Sie löschen möchten.  
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
<a name="API_DeleteLedger_RequestBody"></a>

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<a name="API_DeleteLedger_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Antwortelemente
<a name="API_DeleteLedger_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** InvalidParameterException **   
Ein oder mehrere Parameter in der Anfrage sind nicht gültig.  
HTTP Status Code: 400

 ** ResourceInUseException **   
Die angegebene Ressource kann derzeit nicht geändert werden.  
HTTP-Statuscode: 409

 ** 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:
<a name="API_DeleteLedger_SeeAlso"></a>

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/DeleteLedger) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/DeleteLedger) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/DeleteLedger) 

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

Gibt detaillierte Informationen zu einem bestimmten Amazon QLDB-Journal-Stream zurück. Die Ausgabe umfasst den Amazon-Ressourcennamen (ARN), den Streamnamen, den aktuellen Status, die Erstellungszeit und die Parameter der ursprünglichen Stream-Erstellungsanforderung.

Diese Aktion gibt keine abgelaufenen Journal-Streams zurück. Weitere Informationen finden Sie unter [Ablauf von Terminal-Streams](https://docs.aws.amazon.com/qldb/latest/developerguide/streams.create.html#streams.create.states.expiration) im *Amazon QLDB Developer Guide*.

## Anforderungssyntax
<a name="API_DescribeJournalKinesisStream_RequestSyntax"></a>

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

## URI-Anfrageparameter
<a name="API_DescribeJournalKinesisStream_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [name](#API_DescribeJournalKinesisStream_RequestSyntax) **   <a name="qldb-DescribeJournalKinesisStream-request-uri-LedgerName"></a>
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

 ** [streamId](#API_DescribeJournalKinesisStream_RequestSyntax) **   <a name="qldb-DescribeJournalKinesisStream-request-uri-StreamId"></a>
Die UUID (dargestellt in Base62-codiertem Text) des zu beschreibenden QLDB-Journal-Streams.  
Längenbeschränkungen: Feste Länge von 22.  
Pattern: `^[A-Za-z-0-9]+$`   
Erforderlich: Ja

## Anforderungstext
<a name="API_DescribeJournalKinesisStream_RequestBody"></a>

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<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"
   }
}
```

## Antwortelemente
<a name="API_DescribeJournalKinesisStream_ResponseElements"></a>

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.

 ** [Stream](#API_DescribeJournalKinesisStream_ResponseSyntax) **   <a name="qldb-DescribeJournalKinesisStream-response-Stream"></a>
Informationen über den QLDB-Journal-Stream, der von einer `DescribeJournalS3Export` Anfrage zurückgegeben wurde.  
Typ: [JournalKinesisStreamDescription](API_JournalKinesisStreamDescription.md) Objekt

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** InvalidParameterException **   
Ein oder mehrere Parameter in der Anfrage sind nicht gültig.  
HTTP Status Code: 400

 ** 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:
<a name="API_DescribeJournalKinesisStream_SeeAlso"></a>

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/DescribeJournalKinesisStream) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/DescribeJournalKinesisStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/DescribeJournalKinesisStream) 

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

Gibt Informationen über einen Journalexportjob zurück, einschließlich des Hauptbuchnamens, der Export-ID, der Erstellungszeit, des aktuellen Status und der Parameter der ursprünglichen Exporterstellungsanforderung.

Diese Aktion gibt keine abgelaufenen Exportaufträge zurück. Weitere Informationen finden Sie unter [Ablauf von Exportaufträgen](https://docs.aws.amazon.com/qldb/latest/developerguide/export-journal.request.html#export-journal.request.expiration) im *Amazon QLDB Developer Guide*.

Wenn der Exportauftrag mit dem angegebenen Wert nicht `ExportId` existiert, wird er ausgelöst. `ResourceNotFoundException`

Wenn das Hauptbuch mit dem angegebenen Objekt nicht `Name` existiert, wird geworfen. `ResourceNotFoundException`

## Anforderungssyntax
<a name="API_DescribeJournalS3Export_RequestSyntax"></a>

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

## URI-Anfrageparameter
<a name="API_DescribeJournalS3Export_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [exportId](#API_DescribeJournalS3Export_RequestSyntax) **   <a name="qldb-DescribeJournalS3Export-request-uri-ExportId"></a>
Die UUID (dargestellt in Base62-codiertem Text) des zu beschreibenden Journal-Exportjobs.  
Längenbeschränkungen: Feste Länge von 22.  
Pattern: `^[A-Za-z-0-9]+$`   
Erforderlich: Ja

 ** [name](#API_DescribeJournalS3Export_RequestSyntax) **   <a name="qldb-DescribeJournalS3Export-request-uri-Name"></a>
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
<a name="API_DescribeJournalS3Export_RequestBody"></a>

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<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"
   }
}
```

## Antwortelemente
<a name="API_DescribeJournalS3Export_ResponseElements"></a>

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.

 ** [ExportDescription](#API_DescribeJournalS3Export_ResponseSyntax) **   <a name="qldb-DescribeJournalS3Export-response-ExportDescription"></a>
Informationen über den Journalexportauftrag, der durch eine `DescribeJournalS3Export` Anfrage zurückgegeben wurde.  
Typ: [JournalS3ExportDescription](API_JournalS3ExportDescription.md) Objekt

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

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

## Weitere Informationen finden Sie unter:
<a name="API_DescribeJournalS3Export_SeeAlso"></a>

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/DescribeJournalS3Export) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/DescribeJournalS3Export) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/DescribeJournalS3Export) 

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

Gibt Informationen über ein Ledger zurück, einschließlich seines Status, seines Berechtigungsmodus, seiner Einstellungen für Verschlüsselung im Ruhezustand und wann es erstellt wurde.

## Anforderungssyntax
<a name="API_DescribeLedger_RequestSyntax"></a>

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

## URI-Anfrageparameter
<a name="API_DescribeLedger_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [name](#API_DescribeLedger_RequestSyntax) **   <a name="qldb-DescribeLedger-request-uri-Name"></a>
Der Name des Ledgers, das Sie beschreiben möchten.  
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
<a name="API_DescribeLedger_RequestBody"></a>

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<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"
}
```

## Antwortelemente
<a name="API_DescribeLedger_ResponseElements"></a>

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.

 ** [Arn](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-Arn"></a>
Der Amazon-Ressourcenname (ARN) für das Ledger.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 20. Maximale Länge beträgt 1600 Zeichen.

 ** [CreationDateTime](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-CreationDateTime"></a>
Das Datum und die Uhrzeit der Erstellung des Ledgers im Epochenzeitformat. (Das Epochenzeitformat ist die Anzahl der Sekunden, die seit dem 1. Januar 1970 um 00:00:00 Uhr UTC vergangen sind.)  
Typ: Zeitstempel

 ** [DeletionProtection](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-DeletionProtection"></a>
Gibt an, ob der Ledger vor dem Löschen durch einen beliebigen Benutzer geschützt ist. Wenn es während der Ledger-Erstellung nicht definiert wird, ist diese Funktion standardmäßig aktiviert (`true`).  
Wenn der Löschschutz aktiviert ist, müssen Sie ihn zuerst deaktivieren, bevor Sie das Ledger löschen können. Sie können ihn deaktivieren, indem Sie mit dem `UpdateLedger`-Vorgang den Parameter auf `false` einstellen.  
Typ: Boolesch

 ** [EncryptionDescription](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-EncryptionDescription"></a>
Informationen zur Verschlüsselung ruhender Daten im Hauptbuch. Dazu gehören der aktuelle Status, der AWS KMS Schlüssel und der Zeitpunkt, an dem auf den Schlüssel nicht mehr zugegriffen werden konnte (im Falle eines Fehlers). Wenn dieser Parameter nicht definiert ist, verwendet das Ledger einen AWS eigenen KMS-Schlüssel für die Verschlüsselung.  
Typ: [LedgerEncryptionDescription](API_LedgerEncryptionDescription.md) Objekt

 ** [Name](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-Name"></a>
Der Name des Ledgers.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 32 Zeichen.  
Pattern: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$` 

 ** [PermissionsMode](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-PermissionsMode"></a>
Der Berechtigungsmodus des Ledgers.  
Typ: Zeichenfolge  
Zulässige Werte: `ALLOW_ALL | STANDARD` 

 ** [State](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-State"></a>
Der aktuelle Status des Ledgers.  
Typ: Zeichenfolge  
Zulässige Werte: `CREATING | ACTIVE | DELETING | DELETED` 

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** InvalidParameterException **   
Ein oder mehrere Parameter in der Anfrage sind nicht gültig.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
Die angegebene Ressource ist nicht vorhanden.  
HTTP Status Code: 404

## Weitere Informationen finden Sie unter:
<a name="API_DescribeLedger_SeeAlso"></a>

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/DescribeLedger) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/DescribeLedger) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/DescribeLedger) 

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

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
<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"
   }
}
```

## URI-Anfrageparameter
<a name="API_ExportJournalToS3_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [name](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-uri-Name"></a>
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
<a name="API_ExportJournalToS3_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [ExclusiveEndTime](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-ExclusiveEndTime"></a>
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) **   <a name="qldb-ExportJournalToS3-request-InclusiveStartTime"></a>
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) **   <a name="qldb-ExportJournalToS3-request-OutputFormat"></a>
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) **   <a name="qldb-ExportJournalToS3-request-RoleArn"></a>
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) **   <a name="qldb-ExportJournalToS3-request-S3ExportConfiguration"></a>
Die Konfigurationseinstellungen des Amazon S3 S3-Bucket-Ziels für Ihre Exportanfrage.  
Typ: [S3ExportConfiguration](API_S3ExportConfiguration.md) Objekt  
Erforderlich: Ja

## Antwortsyntax
<a name="API_ExportJournalToS3_ResponseSyntax"></a>

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

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

## Antwortelemente
<a name="API_ExportJournalToS3_ResponseElements"></a>

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) **   <a name="qldb-ExportJournalToS3-response-ExportId"></a>
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
<a name="API_ExportJournalToS3_Errors"></a>

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

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) 

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

Gibt ein Blockobjekt an einer angegebenen Adresse in einem Journal zurück. Gibt auch einen Nachweis für den angegebenen Block zur Überprüfung zurück, wenn `DigestTipAddress` bereitgestellt wird.

Informationen zu den Dateninhalten in einem Block finden Sie unter [Journalinhalte](https://docs.aws.amazon.com/qldb/latest/developerguide/journal-contents.html) im *Amazon QLDB Developer Guide*.

Wenn das angegebene Ledger nicht existiert oder sich im `DELETING` Status befindet, wird ausgelöst. `ResourceNotFoundException`

Wenn sich das angegebene Ledger im `CREATING` Status befindet, wird ausgelöst. `ResourcePreconditionNotMetException`

Wenn kein Block mit der angegebenen Adresse existiert, wird ausgelöst. `InvalidParameterException`

## Anforderungssyntax
<a name="API_GetBlock_RequestSyntax"></a>

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

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

## URI-Anfrageparameter
<a name="API_GetBlock_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [name](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-request-uri-Name"></a>
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
<a name="API_GetBlock_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [BlockAddress](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-request-BlockAddress"></a>
Die Position des Blocks, den Sie anfordern möchten. Eine Adresse ist eine Amazon Ion-Struktur mit zwei Feldern: `strandId` und`sequenceNo`.  
Beispiel: `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}`.  
Typ: [ValueHolder](API_ValueHolder.md) Objekt  
Erforderlich: Ja

 ** [DigestTipAddress](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-request-DigestTipAddress"></a>
Der letzte Blockstandort, für den die Zusammenfassung gilt und für den ein Nachweis angefordert werden soll. Eine Adresse ist eine Amazon Ion-Struktur mit zwei Feldern: `strandId` und`sequenceNo`.  
Beispiel: `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}`.  
Typ: [ValueHolder](API_ValueHolder.md) Objekt  
Erforderlich: Nein

## Antwortsyntax
<a name="API_GetBlock_ResponseSyntax"></a>

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

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

## Antwortelemente
<a name="API_GetBlock_ResponseElements"></a>

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.

 ** [Block](#API_GetBlock_ResponseSyntax) **   <a name="qldb-GetBlock-response-Block"></a>
Das Blockdatenobjekt im Amazon Ion-Format.  
Typ: [ValueHolder](API_ValueHolder.md) Objekt

 ** [Proof](#API_GetBlock_ResponseSyntax) **   <a name="qldb-GetBlock-response-Proof"></a>
Das durch eine `GetBlock` Anfrage zurückgesendete Beweisobjekt im Amazon Ion-Format. Ein Proof enthält die Liste der Hash-Werte, die für die Neuberechnung des angegebenen Digest mithilfe eines Merkle-Baums erforderlich sind, wobei mit dem angegebenen Block begonnen wird.  
Typ: [ValueHolder](API_ValueHolder.md) Objekt

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** InvalidParameterException **   
Ein oder mehrere Parameter in der Anfrage sind nicht gültig.  
HTTP Status Code: 400

 ** 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:
<a name="API_GetBlock_SeeAlso"></a>

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/GetBlock) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/GetBlock) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/GetBlock) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/GetBlock) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/GetBlock) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/GetBlock) 

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

Gibt den Digest eines Ledgers zum letzten festgeschriebenen Block im Journal zurück. Die Antwort enthält einen 256-Bit-Hashwert und eine Blockadresse.

## Anforderungssyntax
<a name="API_GetDigest_RequestSyntax"></a>

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

## URI-Anfrageparameter
<a name="API_GetDigest_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [name](#API_GetDigest_RequestSyntax) **   <a name="qldb-GetDigest-request-uri-Name"></a>
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
<a name="API_GetDigest_RequestBody"></a>

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<a name="API_GetDigest_ResponseSyntax"></a>

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

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

## Antwortelemente
<a name="API_GetDigest_ResponseElements"></a>

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.

 ** [Digest](#API_GetDigest_ResponseSyntax) **   <a name="qldb-GetDigest-response-Digest"></a>
Der 256-Bit-Hashwert, der den von einer Anfrage zurückgegebenen Digest darstellt. `GetDigest`  
Typ: Base64-kodiertes Binärdatenobjekt  
Längenbeschränkungen: Feste Länge von 32.

 ** [DigestTipAddress](#API_GetDigest_ResponseSyntax) **   <a name="qldb-GetDigest-response-DigestTipAddress"></a>
Die letzte Blockposition, auf die sich der von Ihnen angeforderte Digest bezieht. Eine Adresse ist eine Amazon Ion-Struktur mit zwei Feldern: `strandId` und`sequenceNo`.  
Typ: [ValueHolder](API_ValueHolder.md) Objekt

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** InvalidParameterException **   
Ein oder mehrere Parameter in der Anfrage sind nicht gültig.  
HTTP Status Code: 400

 ** 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:
<a name="API_GetDigest_SeeAlso"></a>

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/GetDigest) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/GetDigest) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/GetDigest) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/GetDigest) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/GetDigest) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/GetDigest) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/GetDigest) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/GetDigest) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/GetDigest) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/GetDigest) 

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

Gibt ein Revisionsdatenobjekt für eine angegebene Dokument-ID und Blockadresse zurück. Gibt auch einen Nachweis der angegebenen Revision zur Überprüfung zurück, falls `DigestTipAddress` bereitgestellt wird.

## Anforderungssyntax
<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"
}
```

## URI-Anfrageparameter
<a name="API_GetRevision_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [name](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-uri-Name"></a>
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
<a name="API_GetRevision_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [BlockAddress](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-BlockAddress"></a>
Die Blockposition der Dokumentrevision, die überprüft werden soll. Eine Adresse ist eine Amazon Ion-Struktur mit zwei Feldern: `strandId` und`sequenceNo`.  
Beispiel: `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}`.  
Typ: [ValueHolder](API_ValueHolder.md) Objekt  
Erforderlich: Ja

 ** [DigestTipAddress](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-DigestTipAddress"></a>
Der letzte Blockstandort, für den die Zusammenfassung gilt und für den ein Nachweis angefordert werden soll. Eine Adresse ist eine Amazon Ion-Struktur mit zwei Feldern: `strandId` und`sequenceNo`.  
Beispiel: `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}`.  
Typ: [ValueHolder](API_ValueHolder.md) Objekt  
Erforderlich: Nein

 ** [DocumentId](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-DocumentId"></a>
Die UUID (dargestellt in Base62-codiertem Text) des zu verifizierenden Dokuments.  
Typ: Zeichenfolge  
Längenbeschränkungen: Feste Länge von 22.  
Pattern: `^[A-Za-z-0-9]+$`   
Erforderlich: Ja

## Antwortsyntax
<a name="API_GetRevision_ResponseSyntax"></a>

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

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

## Antwortelemente
<a name="API_GetRevision_ResponseElements"></a>

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.

 ** [Proof](#API_GetRevision_ResponseSyntax) **   <a name="qldb-GetRevision-response-Proof"></a>
Das durch eine `GetRevision` Anfrage zurückgesendete Beweisobjekt im Amazon Ion-Format. Ein Proof enthält die Liste der Hash-Werte, die erforderlich sind, um den angegebenen Digest anhand eines Merkle-Baums neu zu berechnen, wobei mit der angegebenen Dokumentrevision begonnen wird.  
Typ: [ValueHolder](API_ValueHolder.md) Objekt

 ** [Revision](#API_GetRevision_ResponseSyntax) **   <a name="qldb-GetRevision-response-Revision"></a>
Das Revisionsdatenobjekt des Dokuments im Amazon Ion-Format.  
Typ: [ValueHolder](API_ValueHolder.md) Objekt

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** InvalidParameterException **   
Ein oder mehrere Parameter in der Anfrage sind nicht gültig.  
HTTP Status Code: 400

 ** 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:
<a name="API_GetRevision_SeeAlso"></a>

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/GetRevision) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/GetRevision) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/GetRevision) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/GetRevision) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/GetRevision) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/GetRevision) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/GetRevision) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/GetRevision) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/GetRevision) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/GetRevision) 

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

Gibt alle Amazon QLDB-Journal-Streams für ein bestimmtes Ledger zurück.

Diese Aktion gibt keine abgelaufenen Journal-Streams zurück. Weitere Informationen finden Sie unter [Ablauf von Terminal-Streams](https://docs.aws.amazon.com/qldb/latest/developerguide/streams.create.html#streams.create.states.expiration) im *Amazon QLDB Developer Guide*.

Diese Aktion gibt ein Maximum an Artikeln zurück. `MaxResults` Sie ist paginiert, sodass Sie alle Elemente abrufen können, indem Sie sie `ListJournalKinesisStreamsForLedger` mehrmals aufrufen.

## Anforderungssyntax
<a name="API_ListJournalKinesisStreamsForLedger_RequestSyntax"></a>

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

## URI-Anfrageparameter
<a name="API_ListJournalKinesisStreamsForLedger_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [name](#API_ListJournalKinesisStreamsForLedger_RequestSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-request-uri-LedgerName"></a>
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

 ** [MaxResults](#API_ListJournalKinesisStreamsForLedger_RequestSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-request-uri-MaxResults"></a>
Die maximale Anzahl von Ergebnissen, die in einer einzigen `ListJournalKinesisStreamsForLedger` Anfrage zurückgegeben werden können. (Die tatsächliche Anzahl der zurückgegebenen Ergebnisse ist möglicherweise geringer.)  
Gültiger Bereich: Mindestwert 1. Maximalwert 100.

 ** [NextToken](#API_ListJournalKinesisStreamsForLedger_RequestSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-request-uri-NextToken"></a>
Ein Paginierungstoken, das angibt, dass Sie die nächste Ergebnisseite abrufen möchten. Wenn Sie `NextToken` in der Antwort eines früheren `ListJournalKinesisStreamsForLedger` Anrufs einen Wert für erhalten haben, sollten Sie diesen Wert hier als Eingabe verwenden.  
Längenbeschränkungen: Mindestlänge von 4. Maximale Länge beträgt 1024 Zeichen.  
Pattern: `^[A-Za-z-0-9+/=]+$` 

## Anforderungstext
<a name="API_ListJournalKinesisStreamsForLedger_RequestBody"></a>

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<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"
      }
   ]
}
```

## Antwortelemente
<a name="API_ListJournalKinesisStreamsForLedger_ResponseElements"></a>

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.

 ** [NextToken](#API_ListJournalKinesisStreamsForLedger_ResponseSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-response-NextToken"></a>
+ Wenn leer `NextToken` ist, wurde die letzte Ergebnisseite verarbeitet und es können keine weiteren Ergebnisse abgerufen werden.
+ Wenn *nicht* leer `NextToken` ist, sind mehr Ergebnisse verfügbar. Um die nächste Ergebnisseite abzurufen, verwenden Sie den Wert von `NextToken` in einem nachfolgenden `ListJournalKinesisStreamsForLedger`-Aufruf.
Typ: Zeichenfolge  
Längenbeschränkungen: Mindestlänge von 4. Maximale Länge beträgt 1024 Zeichen.  
Pattern: `^[A-Za-z-0-9+/=]+$` 

 ** [Streams](#API_ListJournalKinesisStreamsForLedger_ResponseSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-response-Streams"></a>
Die QLDB-Journal-Streams, die derzeit dem angegebenen Ledger zugeordnet sind.  
Typ: Array von [JournalKinesisStreamDescription](API_JournalKinesisStreamDescription.md)-Objekten

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** InvalidParameterException **   
Ein oder mehrere Parameter in der Anfrage sind nicht gültig.  
HTTP Status Code: 400

 ** 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:
<a name="API_ListJournalKinesisStreamsForLedger_SeeAlso"></a>

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/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ListJournalKinesisStreamsForLedger) 

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

Gibt alle Journalexportaufträge für alle Bücher zurück, die dem aktuellen AWS-Konto Buch und der Region zugeordnet sind.

Diese Aktion gibt ein Maximum an `MaxResults` Elementen zurück und ist paginiert, sodass Sie alle Elemente abrufen können, indem Sie sie `ListJournalS3Exports` mehrmals aufrufen.

Diese Aktion gibt keine abgelaufenen Exportaufträge zurück. Weitere Informationen finden Sie unter [Ablauf von Exportaufträgen](https://docs.aws.amazon.com/qldb/latest/developerguide/export-journal.request.html#export-journal.request.expiration) im *Amazon QLDB Developer Guide*.

## Anforderungssyntax
<a name="API_ListJournalS3Exports_RequestSyntax"></a>

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

## URI-Anfrageparameter
<a name="API_ListJournalS3Exports_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [MaxResults](#API_ListJournalS3Exports_RequestSyntax) **   <a name="qldb-ListJournalS3Exports-request-uri-MaxResults"></a>
Die maximale Anzahl von Ergebnissen, die in einer einzigen `ListJournalS3Exports` Anfrage zurückgegeben werden können. (Die tatsächliche Anzahl der zurückgegebenen Ergebnisse ist möglicherweise geringer.)  
Gültiger Bereich: Mindestwert 1. Maximalwert 100.

 ** [NextToken](#API_ListJournalS3Exports_RequestSyntax) **   <a name="qldb-ListJournalS3Exports-request-uri-NextToken"></a>
Ein Paginierungstoken, das angibt, dass Sie die nächste Ergebnisseite abrufen möchten. Wenn Sie `NextToken` in der Antwort eines früheren `ListJournalS3Exports` Anrufs einen Wert für erhalten haben, sollten Sie diesen Wert hier als Eingabe verwenden.  
Längenbeschränkungen: Mindestlänge von 4. Maximale Länge beträgt 1024 Zeichen.  
Pattern: `^[A-Za-z-0-9+/=]+$` 

## Anforderungstext
<a name="API_ListJournalS3Exports_RequestBody"></a>

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<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"
}
```

## Antwortelemente
<a name="API_ListJournalS3Exports_ResponseElements"></a>

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.

 ** [JournalS3Exports](#API_ListJournalS3Exports_ResponseSyntax) **   <a name="qldb-ListJournalS3Exports-response-JournalS3Exports"></a>
Die Journalexportaufträge für alle Bücher, die dem aktuellen Buch AWS-Konto und der Region zugeordnet sind.  
Typ: Array von [JournalS3ExportDescription](API_JournalS3ExportDescription.md)-Objekten

 ** [NextToken](#API_ListJournalS3Exports_ResponseSyntax) **   <a name="qldb-ListJournalS3Exports-response-NextToken"></a>
+ Wenn leer `NextToken` ist, wurde die letzte Ergebnisseite verarbeitet und es können keine weiteren Ergebnisse abgerufen werden.
+ Wenn *nicht* leer `NextToken` ist, sind weitere Ergebnisse verfügbar. Um die nächste Ergebnisseite abzurufen, verwenden Sie den Wert von `NextToken` in einem nachfolgenden `ListJournalS3Exports`-Aufruf.
Typ: Zeichenfolge  
Längenbeschränkungen: Mindestlänge von 4. Maximale Länge beträgt 1024 Zeichen.  
Pattern: `^[A-Za-z-0-9+/=]+$` 

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

## Weitere Informationen finden Sie unter:
<a name="API_ListJournalS3Exports_SeeAlso"></a>

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/ListJournalS3Exports) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ListJournalS3Exports) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ListJournalS3Exports) 

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

Gibt alle Journalexportaufträge für ein bestimmtes Ledger zurück.

Diese Aktion gibt ein Maximum an `MaxResults` Elementen zurück und ist paginiert, sodass Sie alle Elemente abrufen können, indem Sie sie `ListJournalS3ExportsForLedger` mehrmals aufrufen.

Diese Aktion gibt keine abgelaufenen Exportaufträge zurück. Weitere Informationen finden Sie unter [Ablauf von Exportaufträgen](https://docs.aws.amazon.com/qldb/latest/developerguide/export-journal.request.html#export-journal.request.expiration) im *Amazon QLDB Developer Guide*.

## Anforderungssyntax
<a name="API_ListJournalS3ExportsForLedger_RequestSyntax"></a>

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

## URI-Anfrageparameter
<a name="API_ListJournalS3ExportsForLedger_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [MaxResults](#API_ListJournalS3ExportsForLedger_RequestSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-request-uri-MaxResults"></a>
Die maximale Anzahl von Ergebnissen, die in einer einzigen `ListJournalS3ExportsForLedger` Anfrage zurückgegeben werden können. (Die tatsächliche Anzahl der zurückgegebenen Ergebnisse ist möglicherweise geringer.)  
Gültiger Bereich: Mindestwert 1. Maximalwert 100.

 ** [name](#API_ListJournalS3ExportsForLedger_RequestSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-request-uri-Name"></a>
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

 ** [NextToken](#API_ListJournalS3ExportsForLedger_RequestSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-request-uri-NextToken"></a>
Ein Paginierungstoken, das angibt, dass Sie die nächste Ergebnisseite abrufen möchten. Wenn Sie `NextToken` in der Antwort eines früheren `ListJournalS3ExportsForLedger` Anrufs einen Wert für erhalten haben, sollten Sie diesen Wert hier als Eingabe verwenden.  
Längenbeschränkungen: Mindestlänge von 4. Maximale Länge beträgt 1024 Zeichen.  
Pattern: `^[A-Za-z-0-9+/=]+$` 

## Anforderungstext
<a name="API_ListJournalS3ExportsForLedger_RequestBody"></a>

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<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"
}
```

## Antwortelemente
<a name="API_ListJournalS3ExportsForLedger_ResponseElements"></a>

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.

 ** [JournalS3Exports](#API_ListJournalS3ExportsForLedger_ResponseSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-response-JournalS3Exports"></a>
Die Journalexportaufträge, die derzeit dem angegebenen Ledger zugeordnet sind.  
Typ: Array von [JournalS3ExportDescription](API_JournalS3ExportDescription.md)-Objekten

 ** [NextToken](#API_ListJournalS3ExportsForLedger_ResponseSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-response-NextToken"></a>
+ Wenn leer `NextToken` ist, wurde die letzte Ergebnisseite verarbeitet und es können keine weiteren Ergebnisse abgerufen werden.
+ Wenn *nicht* leer `NextToken` ist, sind weitere Ergebnisse verfügbar. Um die nächste Ergebnisseite abzurufen, verwenden Sie den Wert von `NextToken` in einem nachfolgenden `ListJournalS3ExportsForLedger`-Aufruf.
Typ: Zeichenfolge  
Längenbeschränkungen: Mindestlänge von 4. Maximale Länge beträgt 1024 Zeichen.  
Pattern: `^[A-Za-z-0-9+/=]+$` 

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

## Weitere Informationen finden Sie unter:
<a name="API_ListJournalS3ExportsForLedger_SeeAlso"></a>

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/ListJournalS3ExportsForLedger) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ListJournalS3ExportsForLedger) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ListJournalS3ExportsForLedger) 

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

Gibt alle Ledger zurück, die dem aktuellen Konto AWS-Konto und der Region zugeordnet sind.

Diese Aktion gibt ein Maximum an `MaxResults` Elementen zurück und ist paginiert, sodass Sie alle Elemente abrufen können, indem Sie sie `ListLedgers` mehrmals aufrufen.

## Anforderungssyntax
<a name="API_ListLedgers_RequestSyntax"></a>

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

## URI-Anfrageparameter
<a name="API_ListLedgers_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [MaxResults](#API_ListLedgers_RequestSyntax) **   <a name="qldb-ListLedgers-request-uri-MaxResults"></a>
Die maximale Anzahl von Ergebnissen, die in einer einzigen `ListLedgers` Anfrage zurückgegeben werden können. (Die tatsächliche Anzahl der zurückgegebenen Ergebnisse ist möglicherweise geringer.)  
Gültiger Bereich: Mindestwert 1. Maximalwert 100.

 ** [NextToken](#API_ListLedgers_RequestSyntax) **   <a name="qldb-ListLedgers-request-uri-NextToken"></a>
Ein Paginierungstoken, das angibt, dass Sie die nächste Ergebnisseite abrufen möchten. Wenn Sie `NextToken` in der Antwort eines früheren `ListLedgers` Anrufs einen Wert für erhalten haben, sollten Sie diesen Wert hier als Eingabe verwenden.  
Längenbeschränkungen: Mindestlänge von 4. Maximale Länge beträgt 1024 Zeichen.  
Pattern: `^[A-Za-z-0-9+/=]+$` 

## Anforderungstext
<a name="API_ListLedgers_RequestBody"></a>

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<a name="API_ListLedgers_ResponseSyntax"></a>

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

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

## Antwortelemente
<a name="API_ListLedgers_ResponseElements"></a>

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.

 ** [Ledgers](#API_ListLedgers_ResponseSyntax) **   <a name="qldb-ListLedgers-response-Ledgers"></a>
Die Ledger, die dem aktuellen Konto AWS-Konto und der Region zugeordnet sind.  
Typ: Array von [LedgerSummary](API_LedgerSummary.md)-Objekten

 ** [NextToken](#API_ListLedgers_ResponseSyntax) **   <a name="qldb-ListLedgers-response-NextToken"></a>
Ein Paginierungstoken, das angibt, ob weitere Ergebnisse verfügbar sind:  
+ Wenn leer `NextToken` ist, wurde die letzte Ergebnisseite verarbeitet und es können keine weiteren Ergebnisse abgerufen werden.
+ Wenn *nicht* leer `NextToken` ist, sind weitere Ergebnisse verfügbar. Um die nächste Ergebnisseite abzurufen, verwenden Sie den Wert von `NextToken` in einem nachfolgenden `ListLedgers`-Aufruf.
Typ: Zeichenfolge  
Längenbeschränkungen: Mindestlänge von 4. Maximale Länge beträgt 1024 Zeichen.  
Pattern: `^[A-Za-z-0-9+/=]+$` 

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

## Weitere Informationen finden Sie unter:
<a name="API_ListLedgers_SeeAlso"></a>

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/ListLedgers) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ListLedgers) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ListLedgers) 

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

Gibt alle Tags für eine angegebene Amazon QLDB-Ressource zurück.

## Anforderungssyntax
<a name="API_ListTagsForResource_RequestSyntax"></a>

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

## URI-Anfrageparameter
<a name="API_ListTagsForResource_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [resourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="qldb-ListTagsForResource-request-uri-ResourceArn"></a>
Der Amazon-Ressourcenname (ARN), für den die Tags aufgelistet werden sollen. Zum Beispiel:  
 `arn:aws:qldb:us-east-1:123456789012:ledger/exampleLedger`   
Längenbeschränkungen: Minimale Länge von 20. Maximale Länge beträgt 1600 Zeichen.  
Erforderlich: Ja

## Anforderungstext
<a name="API_ListTagsForResource_RequestBody"></a>

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<a name="API_ListTagsForResource_ResponseSyntax"></a>

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

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

## Antwortelemente
<a name="API_ListTagsForResource_ResponseElements"></a>

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.

 ** [Tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="qldb-ListTagsForResource-response-Tags"></a>
Die Tags, die derzeit mit der angegebenen Amazon QLDB-Ressource verknüpft sind.  
Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge  
Karteneinträge: Mindestanzahl von 0 Elementen. Die maximale Anzahl beträgt 200 Elemente.  
Schlüssel-Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 128 Zeichen.  
Längenbeschränkungen für Werte: Mindestlänge von 0. Maximale Länge beträgt 256 Zeichen.

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** InvalidParameterException **   
Ein oder mehrere Parameter in der Anfrage sind nicht gültig.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
Die angegebene Ressource ist nicht vorhanden.  
HTTP Status Code: 404

## Weitere Informationen finden Sie unter:
<a name="API_ListTagsForResource_SeeAlso"></a>

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/ListTagsForResource) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ListTagsForResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ListTagsForResource) 

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

Erstellt einen Journal-Stream für ein bestimmtes Amazon QLDB-Ledger. Der Stream erfasst jede Dokumentversion, die im Journal des Ledgers festgeschrieben wurde, und liefert die Daten an eine angegebene Amazon Kinesis Data Streams-Ressource.

## Anforderungssyntax
<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" 
   }
}
```

## URI-Anfrageparameter
<a name="API_StreamJournalToKinesis_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [name](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-uri-LedgerName"></a>
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
<a name="API_StreamJournalToKinesis_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [ExclusiveEndTime](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-ExclusiveEndTime"></a>
Das exklusive Datum und die Uhrzeit, die angeben, wann der Stream endet. Wenn Sie diesen Parameter nicht definieren, wird der Stream auf unbestimmte Zeit ausgeführt, bis Sie ihn abbrechen.  
`ExclusiveEndTime` muss im `ISO 8601`-Datums- und Uhrzeitformat sowie in UTC (Universal Coordinated Time) vorliegen. Beispiel: `2019-06-13T21:36:34Z`.  
Typ: Zeitstempel  
Erforderlich: Nein

 ** [InclusiveStartTime](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-InclusiveStartTime"></a>
Datums- und Uhrzeitangaben zum Zeitpunkt, ab dem das Streamen von Journaldaten gestartet werden soll. Diese Parameter muss im `ISO 8601`-Datums- und Uhrzeitformat sowie in UTC (Universal Coordinated Time) vorliegen. Beispiel: `2019-06-13T21:36:34Z`.  
`InclusiveStartTime` kann nicht in der Zukunft liegen und muss vor `ExclusiveEndTime` liegen.  
Wenn Sie eine `InclusiveStartTime` angeben, die vor der `CreationDateTime` des Ledgers liegt, wird sie von QLDB standardmäßig auf die `CreationDateTime` des Ledgers festgelegt.  
Typ: Zeitstempel  
Erforderlich: Ja

 ** [KinesisConfiguration](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-KinesisConfiguration"></a>
Die Konfigurationseinstellungen des Ziels für Kinesis Data Streams für Ihre Stream-Anforderung.  
Typ: [KinesisConfiguration](API_KinesisConfiguration.md) Objekt  
Erforderlich: Ja

 ** [RoleArn](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-RoleArn"></a>
Der Amazon-Ressourcenname (ARN) der IAM-Rolle, die QLDB-Berechtigungen für einen Journalstream zum Schreiben von Datensätzen in eine Kinesis Data Streams-Ressource gewährt.  
Um beim Anfordern eines Journalstreams eine Rolle an QLDB zu übergeben, müssen Sie über Berechtigungen zum Ausführen der `iam:PassRole`-Aktion für die IAM-Rollenressource verfügen. Dies ist für alle Journalstream-Anforderungen erforderlich.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 20. Maximale Länge beträgt 1600 Zeichen.  
Erforderlich: Ja

 ** [StreamName](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-StreamName"></a>
Der Name, den Sie dem QLDB-Journal-Stream zuweisen möchten. Benutzerdefinierte Namen können helfen, den Zweck eines Streams zu identifizieren und anzugeben.  
Der Stream-Name muss unter anderen *aktiven* Streams für ein bestimmtes Ledger eindeutig sein. Stream-Namen haben dieselben Benennungsbeschränkungen wie Ledgernamen, wie sie unter [Kontingente in Amazon QLDB](https://docs.aws.amazon.com/qldb/latest/developerguide/limits.html#limits.naming) im *Amazon QLDB-Entwicklerhandbuch * definiert sind.  
Typ: Zeichenfolge  
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

 ** [Tags](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-Tags"></a>
Die Schlüssel-Wert-Paare, die dem Stream, den Sie erstellen möchten, als Tags hinzugefügt werden sollen. Bei Tag-Schlüsseln wird zwischen Groß- und Kleinschreibung unterschieden. Bei Tag-Werten wird zwischen Groß- und Kleinschreibung unterschieden und sie können Null sein.  
Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge  
Karteneinträge: Mindestanzahl von 0 Elementen. Die maximale Anzahl beträgt 200 Elemente.  
Schlüssel-Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 128 Zeichen.  
Längenbeschränkungen für Werte: Mindestlänge von 0. Maximale Länge beträgt 256 Zeichen.  
Erforderlich: Nein

## Antwortsyntax
<a name="API_StreamJournalToKinesis_ResponseSyntax"></a>

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

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

## Antwortelemente
<a name="API_StreamJournalToKinesis_ResponseElements"></a>

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.

 ** [StreamId](#API_StreamJournalToKinesis_ResponseSyntax) **   <a name="qldb-StreamJournalToKinesis-response-StreamId"></a>
Die UUID (dargestellt in Base62-codiertem Text), die QLDB jedem QLDB-Journal-Stream zuweist.  
Typ: Zeichenfolge  
Längenbeschränkungen: Feste Länge von 22.  
Pattern: `^[A-Za-z-0-9]+$` 

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** InvalidParameterException **   
Ein oder mehrere Parameter in der Anfrage sind nicht gültig.  
HTTP Status Code: 400

 ** 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:
<a name="API_StreamJournalToKinesis_SeeAlso"></a>

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/StreamJournalToKinesis) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/StreamJournalToKinesis) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/StreamJournalToKinesis) 

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

Fügt einer angegebenen Amazon QLDB-Ressource ein oder mehrere Tags hinzu.

Eine Ressource kann bis zu 50 Tags haben. Wenn Sie versuchen, mehr als 50 Tags für eine Ressource zu erstellen, schlägt Ihre Anfrage fehl und es wird ein Fehler zurückgegeben.

## Anforderungssyntax
<a name="API_TagResource_RequestSyntax"></a>

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

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

## URI-Anfrageparameter
<a name="API_TagResource_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [resourceArn](#API_TagResource_RequestSyntax) **   <a name="qldb-TagResource-request-uri-ResourceArn"></a>
Der Amazon-Ressourcenname (ARN), zu dem Sie die Tags hinzufügen möchten. Zum Beispiel:  
 `arn:aws:qldb:us-east-1:123456789012:ledger/exampleLedger`   
Längenbeschränkungen: Minimale Länge von 20. Maximale Länge beträgt 1600 Zeichen.  
Erforderlich: Ja

## Anforderungstext
<a name="API_TagResource_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="qldb-TagResource-request-Tags"></a>
Die Schlüssel-Wert-Paare, die der angegebenen QLDB-Ressource als Tags hinzugefügt werden sollen. Bei Tag-Schlüsseln wird zwischen Groß- und Kleinschreibung unterschieden. Wenn Sie einen Schlüssel angeben, der bereits für die Ressource existiert, schlägt Ihre Anfrage fehl und gibt einen Fehler zurück. Bei Tag-Werten wird zwischen Groß- und Kleinschreibung unterschieden und sie können Null sein.  
Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge  
Karteneinträge: Mindestanzahl von 0 Elementen. Die maximale Anzahl beträgt 200 Elemente.  
Schlüssel-Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 128 Zeichen.  
Längenbeschränkungen für Werte: Mindestlänge von 0. Maximale Länge beträgt 256 Zeichen.  
Erforderlich: Ja

## Antwortsyntax
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Antwortelemente
<a name="API_TagResource_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** InvalidParameterException **   
Ein oder mehrere Parameter in der Anfrage sind nicht gültig.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
Die angegebene Ressource ist nicht vorhanden.  
HTTP Status Code: 404

## Weitere Informationen finden Sie unter:
<a name="API_TagResource_SeeAlso"></a>

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/TagResource) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/TagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/TagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/TagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/TagResource) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/TagResource) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/TagResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/TagResource) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/TagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/TagResource) 

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

Entfernt ein oder mehrere Tags aus einer angegebenen Amazon QLDB-Ressource. Sie können bis zu 50 Tag-Schlüssel angeben, die entfernt werden sollen.

## Anforderungssyntax
<a name="API_UntagResource_RequestSyntax"></a>

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

## URI-Anfrageparameter
<a name="API_UntagResource_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [resourceArn](#API_UntagResource_RequestSyntax) **   <a name="qldb-UntagResource-request-uri-ResourceArn"></a>
Der Amazon-Ressourcenname (ARN), aus dem die Tags entfernt werden sollen. Zum Beispiel:  
 `arn:aws:qldb:us-east-1:123456789012:ledger/exampleLedger`   
Längenbeschränkungen: Minimale Länge von 20. Maximale Länge beträgt 1600 Zeichen.  
Erforderlich: Ja

 ** [TagKeys](#API_UntagResource_RequestSyntax) **   <a name="qldb-UntagResource-request-uri-TagKeys"></a>
Die Liste der Tag-Schlüssel, die entfernt werden sollen.  
Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente.  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.  
Erforderlich: Ja

## Anforderungstext
<a name="API_UntagResource_RequestBody"></a>

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<a name="API_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Antwortelemente
<a name="API_UntagResource_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** InvalidParameterException **   
Ein oder mehrere Parameter in der Anfrage sind nicht gültig.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
Die angegebene Ressource ist nicht vorhanden.  
HTTP Status Code: 404

## Weitere Informationen finden Sie unter:
<a name="API_UntagResource_SeeAlso"></a>

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/UntagResource) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/UntagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/UntagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/UntagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/UntagResource) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/UntagResource) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/UntagResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/UntagResource) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/UntagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/UntagResource) 

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

Aktualisiert die Eigenschaften eines Ledgers.

## Anforderungssyntax
<a name="API_UpdateLedger_RequestSyntax"></a>

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

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

## URI-Anfrageparameter
<a name="API_UpdateLedger_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [name](#API_UpdateLedger_RequestSyntax) **   <a name="qldb-UpdateLedger-request-uri-Name"></a>
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
<a name="API_UpdateLedger_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [DeletionProtection](#API_UpdateLedger_RequestSyntax) **   <a name="qldb-UpdateLedger-request-DeletionProtection"></a>
Gibt an, ob der Ledger vor dem Löschen durch einen beliebigen Benutzer geschützt ist. Wenn es während der Ledger-Erstellung nicht definiert wird, ist diese Funktion standardmäßig aktiviert (`true`).  
Wenn der Löschschutz aktiviert ist, müssen Sie ihn zuerst deaktivieren, bevor Sie das Ledger löschen können. Sie können ihn deaktivieren, indem Sie mit dem `UpdateLedger`-Vorgang den Parameter auf `false` einstellen.  
Typ: Boolesch  
Erforderlich: Nein

 ** [KmsKey](#API_UpdateLedger_RequestSyntax) **   <a name="qldb-UpdateLedger-request-KmsKey"></a>
Der Schlüssel in AWS Key Management Service (AWS KMS), der für die Verschlüsselung ruhender Daten im Ledger verwendet werden soll. Weitere Informationen finden Sie unter [Verschlüsselung im Ruhezustand](https://docs.aws.amazon.com/qldb/latest/developerguide/encryption-at-rest.html) im *Amazon-QLDB-Entwicklerhandbuch*.  
Verwenden Sie eine der folgenden Optionen, um diesen Parameter anzugeben:  
+  `AWS_OWNED_KMS_KEY`: Verwenden Sie einen AWS KMS Schlüssel, der in Ihrem Namen gehört und von AWS diesem verwaltet wird.
+  **Undefiniert**: Nehmen Sie keine Änderungen am KMS-Schlüssel des Ledgers vor.
+  **Ein gültiger, symmetrischer, vom Kunden verwalteter KMS-Schlüssel**: Den angegebenen symmetrischen KMS-Verschlüsselungsschlüssel in Ihrem Konto verwenden, den Sie erstellen, besitzen und verwalten.

  Amazon EBS unterstützt keine asymmetrischen Schlüssel. *Weitere Informationen finden Sie unter [Verwenden von symmetrischen und asymmetrischen Schlüsseln](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) im Entwicklerhandbuch. AWS Key Management Service *
Um einen vom Kunden verwalteten KMS-Schlüssel anzugeben, können Sie seine Schlüssel-ID, den Amazon-Ressourcennamen (ARN), den Aliasnamen oder den Alias-ARN verwenden. Wenn Sie einen Aliasnamen verwenden, stellen Sie ihm `"alias/"` voran. Um einen Schlüssel in einem anderen anzugeben AWS-Konto, müssen Sie den Schlüssel ARN oder den Alias ARN verwenden.  
Zum Beispiel:  
+ Schlüssel-ID: `1234abcd-12ab-34cd-56ef-1234567890ab` 
+ Schüssel-ARN: `arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` 
+ Alias-Name: `alias/ExampleAlias` 
+ Alias-ARN: `arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias` 
Weitere Informationen finden Sie unter [Schlüsselkennungen (KeyId)](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id) im * AWS Key Management Service Entwicklerhandbuch*.  
Typ: Zeichenfolge  
Längenbeschränkungen: Die maximale Länge beträgt 1600.  
Erforderlich: Nein

## Antwortsyntax
<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"
}
```

## Antwortelemente
<a name="API_UpdateLedger_ResponseElements"></a>

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.

 ** [Arn](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-Arn"></a>
Der Amazon-Ressourcenname (ARN) für das Ledger.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 20. Maximale Länge beträgt 1600 Zeichen.

 ** [CreationDateTime](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-CreationDateTime"></a>
Das Datum und die Uhrzeit der Erstellung des Ledgers im Epochenzeitformat. (Das Epochenzeitformat ist die Anzahl der Sekunden, die seit dem 1. Januar 1970 um 00:00:00 Uhr UTC vergangen sind.)  
Typ: Zeitstempel

 ** [DeletionProtection](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-DeletionProtection"></a>
Gibt an, ob der Ledger vor dem Löschen durch einen beliebigen Benutzer geschützt ist. Wenn es während der Ledger-Erstellung nicht definiert wird, ist diese Funktion standardmäßig aktiviert (`true`).  
Wenn der Löschschutz aktiviert ist, müssen Sie ihn zuerst deaktivieren, bevor Sie das Ledger löschen können. Sie können ihn deaktivieren, indem Sie mit dem `UpdateLedger`-Vorgang den Parameter auf `false` einstellen.  
Typ: Boolesch

 ** [EncryptionDescription](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-EncryptionDescription"></a>
Informationen zur Verschlüsselung ruhender Daten im Hauptbuch. Dazu gehören der aktuelle Status, der AWS KMS Schlüssel und der Zeitpunkt, an dem auf den Schlüssel nicht mehr zugegriffen werden konnte (im Falle eines Fehlers).  
Typ: [LedgerEncryptionDescription](API_LedgerEncryptionDescription.md) Objekt

 ** [Name](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-Name"></a>
Der Name des Ledgers.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 32 Zeichen.  
Pattern: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$` 

 ** [State](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-State"></a>
Der aktuelle Status des Ledgers.  
Typ: Zeichenfolge  
Zulässige Werte: `CREATING | ACTIVE | DELETING | DELETED` 

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** InvalidParameterException **   
Ein oder mehrere Parameter in der Anfrage sind nicht gültig.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
Die angegebene Ressource ist nicht vorhanden.  
HTTP Status Code: 404

## Weitere Informationen finden Sie unter:
<a name="API_UpdateLedger_SeeAlso"></a>

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/UpdateLedger) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/UpdateLedger) 

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

Aktualisiert den Berechtigungsmodus eines Ledgers.

**Wichtig**  
Bevor Sie in den `STANDARD` Berechtigungsmodus wechseln, müssen Sie zunächst alle erforderlichen IAM-Richtlinien und Tabellen-Tags erstellen, um Störungen für Ihre Benutzer zu vermeiden. Weitere Informationen finden Sie unter [Migration zum Standardberechtigungsmodus](https://docs.aws.amazon.com/qldb/latest/developerguide/ledger-management.basics.html#ledger-mgmt.basics.update-permissions.migrating) im *Amazon QLDB* Developer Guide.

## Anforderungssyntax
<a name="API_UpdateLedgerPermissionsMode_RequestSyntax"></a>

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

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

## URI-Anfrageparameter
<a name="API_UpdateLedgerPermissionsMode_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [name](#API_UpdateLedgerPermissionsMode_RequestSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-request-uri-Name"></a>
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
<a name="API_UpdateLedgerPermissionsMode_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [PermissionsMode](#API_UpdateLedgerPermissionsMode_RequestSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-request-PermissionsMode"></a>
Der Berechtigungsmodus, der dem Ledger zugewiesen werden soll. Folgende Parameterwerte sind möglich:  
+  `ALLOW_ALL`: Ein Legacy-Berechtigungsmodus, der die Zugriffskontrolle mit Granularität auf API-Ebene für Ledgers ermöglicht.

  Dieser Modus ermöglicht Benutzern, die `SendCommand`-API-Berechtigung für dieses Ledger zum Ausführen aller PartiQL-Befehle (daher `ALLOW_ALL`) auf beliebigen Tabellen im angegebenen Ledger auszuführen. Dieser Modus ignoriert alle IAM-Berechtigungs-Richtlinien auf Tabellen- oder Befehls-Ebene, die Sie für das Ledger erstellen.
+  `STANDARD`: (*Empfohlen*) Ein Berechtigungsmodus, der Zugriffskontrolle mit feinerer Granularität für Ledger, Tabellen und PartiQL-Befehle ermöglicht.

  Standardmäßig verweigert dieser Modus alle Benutzer-Anforderungen zur Ausführung von PartiQL-Befehlen für Tabellen in diesem Ledger. Damit PartiQL-Befehle ausgeführt werden können, müssen Sie IAM-Berechtigungs-Richtlinien für bestimmte Tabellen-Ressourcen und PartiQL-Aktionen erstellen, zusätzlich zu den `SendCommand` API-Berechtigung für den Ledger. Weitere Informationen finden Sie unter [Erste Schritte mit dem Standard-Berechtigungsmodus](https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started-standard-mode.html) im *Amazon-QLDB-Entwicklerhandbuch*.
Wir empfehlen dringend, den `STANDARD` Berechtigungsmodus, um die Sicherheit Ihrer Ledger-Daten zu maximieren.
Typ: Zeichenfolge  
Zulässige Werte: `ALLOW_ALL | STANDARD`   
Erforderlich: Ja

## Antwortsyntax
<a name="API_UpdateLedgerPermissionsMode_ResponseSyntax"></a>

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

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

## Antwortelemente
<a name="API_UpdateLedgerPermissionsMode_ResponseElements"></a>

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.

 ** [Arn](#API_UpdateLedgerPermissionsMode_ResponseSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-response-Arn"></a>
Der Amazon-Ressourcenname (ARN) für das Ledger.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 20. Maximale Länge beträgt 1600 Zeichen.

 ** [Name](#API_UpdateLedgerPermissionsMode_ResponseSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-response-Name"></a>
Der Name des Ledgers.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 32 Zeichen.  
Pattern: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$` 

 ** [PermissionsMode](#API_UpdateLedgerPermissionsMode_ResponseSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-response-PermissionsMode"></a>
Der aktuelle Berechtigungsmodus des Ledgers.  
Typ: Zeichenfolge  
Zulässige Werte: `ALLOW_ALL | STANDARD` 

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** InvalidParameterException **   
Ein oder mehrere Parameter in der Anfrage sind nicht gültig.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
Die angegebene Ressource ist nicht vorhanden.  
HTTP Status Code: 404

## Weitere Informationen finden Sie unter:
<a name="API_UpdateLedgerPermissionsMode_SeeAlso"></a>

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/UpdateLedgerPermissionsMode) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 

# Amazon QLDB-Sitzung
<a name="API_Operations_Amazon_QLDB_Session"></a>

**Wichtig**  
Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter [Migrieren eines Amazon QLDB-Ledgers zu Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Die folgenden Aktionen werden von Amazon QLDB Session unterstützt:
+  [SendCommand](API_QLDB-Session_SendCommand.md) 

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

Sendet einen Befehl an ein Amazon QLDB-Ledger.

**Anmerkung**  
Anstatt direkt mit dieser API zu interagieren, empfehlen wir, den QLDB-Treiber oder die QLDB-Shell zu verwenden, um Datentransaktionen in einem Ledger auszuführen.  
Wenn Sie mit einem AWS SDK arbeiten, verwenden Sie den QLDB-Treiber. Der Treiber bietet eine abstrakte Ebene über dieser *QLDB-Sitzungsdaten-API* und verwaltet den `SendCommand` Vorgang für Sie. Informationen und eine Liste der unterstützten Programmiersprachen finden Sie unter [Erste Schritte mit dem Treiber](https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started-driver.html) im *Amazon QLDB Developer Guide*.
Wenn Sie mit AWS Command Line Interface (AWS CLI) arbeiten, verwenden Sie die QLDB-Shell. Die Shell ist eine Befehlszeilenschnittstelle, die den QLDB-Treiber verwendet, um mit einem Ledger zu interagieren. Weitere Informationen finden Sie unter [Zugreifen auf Amazon QLDB mithilfe der QLDB-Shell](https://docs.aws.amazon.com/qldb/latest/developerguide/data-shell.html).

## Anforderungssyntax
<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": { 
   }
}
```

## Anforderungsparameter
<a name="API_QLDB-Session_SendCommand_RequestParameters"></a>

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [AbortTransaction](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-AbortTransaction"></a>
Befehl zum Abbrechen der aktuellen Transaktion.  
Typ: [AbortTransactionRequest](API_QLDB-Session_AbortTransactionRequest.md) Objekt  
Erforderlich: Nein

 ** [CommitTransaction](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-CommitTransaction"></a>
Befehl zum Festschreiben der angegebenen Transaktion.  
Typ: [CommitTransactionRequest](API_QLDB-Session_CommitTransactionRequest.md) Objekt  
Erforderlich: Nein

 ** [EndSession](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-EndSession"></a>
Befehl zum Beenden der aktuellen Sitzung.  
Typ: [EndSessionRequest](API_QLDB-Session_EndSessionRequest.md) Objekt  
Erforderlich: Nein

 ** [ExecuteStatement](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-ExecuteStatement"></a>
Befehl zum Ausführen einer Anweisung in der angegebenen Transaktion.  
Typ: [ExecuteStatementRequest](API_QLDB-Session_ExecuteStatementRequest.md) Objekt  
Erforderlich: Nein

 ** [FetchPage](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-FetchPage"></a>
Befehl zum Abrufen einer Seite.  
Typ: [FetchPageRequest](API_QLDB-Session_FetchPageRequest.md) Objekt  
Erforderlich: Nein

 ** [SessionToken](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-SessionToken"></a>
Gibt das Sitzungstoken für den aktuellen Befehl an. Ein Sitzungstoken ist während der gesamten Dauer der Sitzung konstant.  
Führen Sie den `StartSession` Befehl aus, um ein Sitzungstoken zu erhalten. Dies `SessionToken` ist für jeden nachfolgenden Befehl erforderlich, der während der aktuellen Sitzung ausgegeben wird.  
Typ: Zeichenfolge  
Längenbeschränkungen: Mindestlänge von 4. Maximale Länge beträgt 1024 Zeichen.  
Pattern: `^[A-Za-z-0-9+/=]+$`   
Erforderlich: Nein

 ** [StartSession](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-StartSession"></a>
Befehl zum Starten einer neuen Sitzung. Ein Sitzungstoken wird als Teil der Antwort abgerufen.  
Typ: [StartSessionRequest](API_QLDB-Session_StartSessionRequest.md) Objekt  
Erforderlich: Nein

 ** [StartTransaction](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-StartTransaction"></a>
Befehl zum Starten einer neuen Transaktion.  
Typ: [StartTransactionRequest](API_QLDB-Session_StartTransactionRequest.md) Objekt  
Erforderlich: Nein

## Antwortsyntax
<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"
   }
}
```

## Antwortelemente
<a name="API_QLDB-Session_SendCommand_ResponseElements"></a>

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.

 ** [AbortTransaction](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-AbortTransaction"></a>
Enthält die Details der abgebrochenen Transaktion.  
Typ: [AbortTransactionResult](API_QLDB-Session_AbortTransactionResult.md) Objekt

 ** [CommitTransaction](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-CommitTransaction"></a>
Enthält die Details der festgeschriebenen Transaktion.  
Typ: [CommitTransactionResult](API_QLDB-Session_CommitTransactionResult.md) Objekt

 ** [EndSession](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-EndSession"></a>
Enthält die Details der beendeten Sitzung.  
Typ: [EndSessionResult](API_QLDB-Session_EndSessionResult.md) Objekt

 ** [ExecuteStatement](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-ExecuteStatement"></a>
Enthält die Details der ausgeführten Anweisung.  
Typ: [ExecuteStatementResult](API_QLDB-Session_ExecuteStatementResult.md) Objekt

 ** [FetchPage](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-FetchPage"></a>
Enthält die Details der abgerufenen Seite.  
Typ: [FetchPageResult](API_QLDB-Session_FetchPageResult.md) Objekt

 ** [StartSession](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-StartSession"></a>
Enthält die Details der gestarteten Sitzung, die ein Sitzungstoken enthält. Dies `SessionToken` ist für jeden nachfolgenden Befehl erforderlich, der während der aktuellen Sitzung ausgegeben wird.  
Typ: [StartSessionResult](API_QLDB-Session_StartSessionResult.md) Objekt

 ** [StartTransaction](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-StartTransaction"></a>
Enthält die Details der gestarteten Transaktion.  
Typ: [StartTransactionResult](API_QLDB-Session_StartTransactionResult.md) Objekt

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** BadRequestException **   
Wird zurückgegeben, wenn die Anfrage fehlerhaft ist oder einen Fehler enthält, z. B. einen ungültigen Parameterwert oder einen fehlenden erforderlichen Parameter.  
HTTP Status Code: 400

 ** CapacityExceededException **   
Wird zurückgegeben, wenn die Anfrage die Verarbeitungskapazität des Ledgers überschreitet.  
HTTP Status Code: 400

 ** InvalidSessionException **   
Wird zurückgegeben, wenn die Sitzung nicht mehr existiert, weil das Zeitlimit überschritten wurde oder sie abgelaufen ist.  
HTTP Status Code: 400

 ** LimitExceededException **   
Wird zurückgegeben, wenn ein Ressourcenlimit, z. B. die Anzahl der aktiven Sitzungen, überschritten wird.  
HTTP Status Code: 400

 ** OccConflictException **   
Wird zurückgegeben, wenn eine Transaktion aufgrund eines Fehlers in der Überprüfungsphase von *Optimistic Concurrency Control* (OCC) nicht in das Journal geschrieben werden kann.  
HTTP Status Code: 400

 ** RateExceededException **   
Wird zurückgegeben, wenn die Anzahl der Anfragen den zulässigen Durchsatz überschreitet.  
HTTP Status Code: 400

## Weitere Informationen finden Sie unter:
<a name="API_QLDB-Session_SendCommand_SeeAlso"></a>

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-session-2019-07-11/SendCommand) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-session-2019-07-11/SendCommand)