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.

# 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)