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. # UpdateLedger Aktualisiert die Eigenschaften eines Ledgers. ## Anforderungssyntax ``` PATCH /ledgers/name HTTP/1.1 Content-type: application/json { "DeletionProtection": boolean, "KmsKey": "string" } ``` ## URI-Anfrageparameter Die Anforderung verwendet die folgenden URI-Parameter. ** [name](#API_UpdateLedger_RequestSyntax) ** Der Name des Ledgers. Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 32 Zeichen. Pattern: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$` Erforderlich: Ja ## Anforderungstext Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [DeletionProtection](#API_UpdateLedger_RequestSyntax) ** 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) ** 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 ``` 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 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** Der aktuelle Status des Ledgers. Typ: Zeichenfolge Zulässige Werte: `CREATING | ACTIVE | DELETING | DELETED` ## Fehler 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: 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)