Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Met à jour le mode d'autorisations d'un registre.

**Important**  
Avant de passer en mode `STANDARD` autorisations, vous devez d'abord créer toutes les politiques IAM et les balises de table requises afin de ne pas perturber la vie de vos utilisateurs. Pour en savoir plus, consultez la section [Migration vers le mode d'autorisations standard](https://docs.aws.amazon.com/qldb/latest/developerguide/ledger-management.basics.html#ledger-mgmt.basics.update-permissions.migrating) dans le manuel *Amazon QLDB Developer* Guide.

## Syntaxe de la demande
<a name="API_UpdateLedgerPermissionsMode_RequestSyntax"></a>

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

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

## Paramètres de demande URI
<a name="API_UpdateLedgerPermissionsMode_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [name](#API_UpdateLedgerPermissionsMode_RequestSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-request-uri-Name"></a>
Nom du registre.  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 32.  
Modèle : `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Obligatoire : oui

## Corps de la demande
<a name="API_UpdateLedgerPermissionsMode_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [PermissionsMode](#API_UpdateLedgerPermissionsMode_RequestSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-request-PermissionsMode"></a>
Mode d'autorisations à attribuer au registre. Ce paramètre peut avoir une des valeurs suivantes :  
+  `ALLOW_ALL` : un mode d'autorisations hérité qui permet le contrôle d'accès avec une granularité au niveau de l'API pour les registres.

  Ce mode permet aux utilisateurs qui possèdent l'autorisation d'API `SendCommand` pour ce registre d'exécuter toutes les commandes PartiQL (par conséquent, `ALLOW_ALL`) sur toutes les tables du registre spécifié. Ce mode ignore les politiques d'autorisations IAM au niveau de la table ou de la commande que vous créez pour le registre.
+  `STANDARD` : (*Recommandé*) un mode d'autorisations qui permet le contrôle d'accès avec une granularité plus fine pour les registres, les tables et les commandes PartiQL.

  Par défaut, ce mode refuse toutes les demandes utilisateur d'exécuter des commandes PartiQL sur les tables de ce registre. Pour autoriser l'exécution des commandes PartiQL, vous devez créer des politiques d'autorisations IAM pour des ressources de table spécifiques et des actions PartiQL, en plus de l'autorisation d'API `SendCommand` pour le registre. Pour plus d'informations, veuillez consulter la rubrique [Premiers pas avec le mode d'autorisations standard](https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started-standard-mode.html) dans le *Guide du développeur Amazon QLDB*.
Nous vous recommandons vivement d'utiliser le mode d'autorisations `STANDARD` pour optimiser la sécurité des données de votre registre.
Type : String  
Valeurs valides : `ALLOW_ALL | STANDARD`   
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_UpdateLedgerPermissionsMode_ResponseSyntax"></a>

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

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

## Eléments de réponse
<a name="API_UpdateLedgerPermissionsMode_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [Arn](#API_UpdateLedgerPermissionsMode_ResponseSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-response-Arn"></a>
Le nom de ressource Amazon (ARN) du registre.  
Type : String  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 1600.

 ** [Name](#API_UpdateLedgerPermissionsMode_ResponseSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-response-Name"></a>
Nom du registre.  
Type : String  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 32.  
Modèle : `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$` 

 ** [PermissionsMode](#API_UpdateLedgerPermissionsMode_ResponseSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-response-PermissionsMode"></a>
Le mode d'autorisations actuel du registre.  
Type : String  
Valeurs valides : `ALLOW_ALL | STANDARD` 

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

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).

 ** InvalidParameterException **   
Un ou plusieurs paramètres de la demande ne sont pas valides.  
Code d’état HTTP : 400

 ** ResourceNotFoundException **   
La ressource spécifiée n’existe pas.  
Code d’état HTTP : 404

## consultez aussi
<a name="API_UpdateLedgerPermissionsMode_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/UpdateLedgerPermissionsMode)