

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.

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

**Important**  
Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez [Migrer un registre Amazon QLDB vers Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

Les actions suivantes sont prises en charge par Amazon QLDB :
+  [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) 

Les actions suivantes sont prises en charge par Amazon QLDB Session :
+  [SendCommand](API_QLDB-Session_SendCommand.md) 

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

**Important**  
Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez [Migrer un registre Amazon QLDB vers Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

Les actions suivantes sont prises en charge par Amazon QLDB :
+  [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>

Termine un flux de journal Amazon QLDB donné. Avant qu'un stream puisse être annulé, son statut actuel doit être`ACTIVE`.

Vous ne pouvez pas redémarrer un stream après l'avoir annulé. Les ressources de flux QLDB annulées sont soumises à une période de rétention de 7 jours. Elles sont donc automatiquement supprimées après l'expiration de cette limite.

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

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

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

La demande utilise les paramètres URI suivants.

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

 ** [streamId](#API_CancelJournalKinesisStream_RequestSyntax) **   <a name="qldb-CancelJournalKinesisStream-request-uri-StreamId"></a>
L'UUID (représenté dans le texte codé en Base62) du flux de journal QLDB à annuler.  
Contraintes de longueur : longueur fixe de 22.  
Modèle : `^[A-Za-z-0-9]+$`   
Obligatoire : oui

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

La demande n’a pas de corps de requête.

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

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

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

## Eléments de réponse
<a name="API_CancelJournalKinesisStream_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.

 ** [StreamId](#API_CancelJournalKinesisStream_ResponseSyntax) **   <a name="qldb-CancelJournalKinesisStream-response-StreamId"></a>
L'UUID (texte codé en Base62) du flux de journal QLDB annulé.  
Type : String  
Contraintes de longueur : longueur fixe de 22.  
Modèle : `^[A-Za-z-0-9]+$` 

## Erreurs
<a name="API_CancelJournalKinesisStream_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

 ** ResourcePreconditionNotMetException **   
L'opération a échoué car une condition n'était pas satisfaite à l'avance.  
Code d’état HTTP : 412

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

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

Crée un nouveau registre Compte AWS dans votre région actuelle.

## Syntaxe de la demande
<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" 
   }
}
```

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

La demande n’utilise pas de paramètres URI.

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

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

 ** [DeletionProtection](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-DeletionProtection"></a>
Spécifie si le registre est protégé contre la suppression par un utilisateur. À défaut de définition lors de la création du registre, cette fonctionnalité est activée (`true`) par défaut.  
Si la protection contre la suppression est activée, vous devez commencer par la désactiver avant de pouvoir supprimer le registre. Vous pouvez la désactiver en appelant l'opération `UpdateLedger` pour définir ce paramètre sur `false`.  
Type : booléen  
Obligatoire : non

 ** [KmsKey](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-KmsKey"></a>
La clé in AWS Key Management Service (AWS KMS) à utiliser pour le chiffrement des données au repos dans le registre. Pour plus d'informations, veuillez consulter la rubrique [Chiffrement au repos](https://docs.aws.amazon.com/qldb/latest/developerguide/encryption-at-rest.html) dans le *Guide du développeur Amazon QLDB*.  
Utilisez l'une des options suivantes pour spécifier ce paramètre :  
+  `AWS_OWNED_KMS_KEY`: utilisez une AWS KMS clé détenue et gérée par AWS vous.
+  **Non défini** : par défaut, utilisez une clé KMS AWS détenue.
+  **Une clé KMS symétrique gérée par le client valide** : utilisez la clé KMS de chiffrement symétrique spécifiée dans votre compte que vous créez, possédez et gérez.

  Amazon QLDB ne prend pas en charge les clés asymétriques. Pour plus d'informations, consultez la section [Utilisation de clés symétriques et asymétriques](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) dans le manuel du * AWS Key Management Service développeur*.
Pour spécifier une clé KMS gérée par le client, utilisez son ID de clé, son Amazon Resource Name (ARN), son nom d'alias ou son ARN d'alias. Lorsque vous utilisez un nom d'alias, préfixez-le avec `"alias/"`. Pour spécifier une clé dans un autre Compte AWS, vous devez utiliser l'ARN de la clé ou l'alias ARN.  
Par exemple :  
+ ID de clé : `1234abcd-12ab-34cd-56ef-1234567890ab` 
+ ARN de clé : `arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` 
+ Nom d'alias : `alias/ExampleAlias` 
+ ARN d'alias : `arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias` 
Pour plus d'informations, consultez la section [Identifiants clés (KeyId)](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id) dans le *guide du AWS Key Management Service développeur*.  
Type : String  
Contraintes de longueur : longueur maximale de 1600.  
Obligatoire : non

 ** [Name](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-Name"></a>
Nom du registre que vous souhaitez créer. Le nom doit être unique parmi tous les registres de votre Compte AWS région actuelle.  
Les contraintes de dénomination pour les noms de registre sont définies dans [Quotas dans Amazon QLDB](https://docs.aws.amazon.com/qldb/latest/developerguide/limits.html#limits.naming) du *Amazon QLDB Developer Guide*.  
Type : String  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 32.  
Modèle : `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Obligatoire : oui

 ** [PermissionsMode](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-PermissionsMode"></a>
Mode d'autorisations à attribuer au registre que vous souhaitez créer. 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

 ** [Tags](#API_CreateLedger_RequestSyntax) **   <a name="qldb-CreateLedger-request-Tags"></a>
Les paires clé-valeur à ajouter sous forme de balises au registre que vous souhaitez créer. Les clés de balises sont sensibles à la casse. Les valeurs des balises distinguent les majuscules et minuscules et peuvent être nulles.  
Type : mappage chaîne/chaîne  
Entrées cartographiques : nombre minimum de 0 éléments. Nombre maximum de 200 éléments.  
Contraintes de longueur de clé : longueur minimale de 1. Longueur maximale de 128.  
Contraintes de longueur de valeur : longueur minimale de 0. Longueur maximale de 256.  
Obligatoire : non

## Syntaxe de la réponse
<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"
}
```

## Eléments de réponse
<a name="API_CreateLedger_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_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-Arn"></a>
Le nom de ressource Amazon (ARN) du registre.  
Type : String  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 1600.

 ** [CreationDateTime](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-CreationDateTime"></a>
Date et heure, au format epoch time, auxquelles le registre a été créé. (Le format Epoch est le nombre de secondes écoulées depuis 00h00 le 1er janvier 1970 UTC.)  
Type : Timestamp

 ** [DeletionProtection](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-DeletionProtection"></a>
Spécifie si le registre est protégé contre la suppression par un utilisateur. À défaut de définition lors de la création du registre, cette fonctionnalité est activée (`true`) par défaut.  
Si la protection contre la suppression est activée, vous devez commencer par la désactiver avant de pouvoir supprimer le registre. Vous pouvez la désactiver en appelant l'opération `UpdateLedger` pour définir ce paramètre sur `false`.  
Type : booléen

 ** [KmsKeyArn](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-KmsKeyArn"></a>
L'ARN de la clé KMS gérée par le client que le registre utilise pour le chiffrement au repos. Si ce paramètre n'est pas défini, le registre utilise une clé KMS AWS détenue pour le chiffrement.  
Type : String  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 1600.

 ** [Name](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-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_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-PermissionsMode"></a>
Mode d'autorisations du registre que vous avez créé.  
Type : String  
Valeurs valides : `ALLOW_ALL | STANDARD` 

 ** [State](#API_CreateLedger_ResponseSyntax) **   <a name="qldb-CreateLedger-response-State"></a>
État actuel du registre.  
Type : String  
Valeurs valides : `CREATING | ACTIVE | DELETING | DELETED` 

## Erreurs
<a name="API_CreateLedger_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

 ** LimitExceededException **   
Vous avez atteint la limite du nombre maximum de ressources autorisées.  
Code d’état HTTP : 400

 ** ResourceAlreadyExistsException **   
La ressource spécifiée existe déjà.  
Code d’état HTTP : 409

 ** ResourceInUseException **   
La ressource spécifiée ne peut pas être modifiée pour le moment.  
Code d’état HTTP : 409

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

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

Supprime un registre et l'ensemble de son contenu. Cette action est irréversible.

Si la protection contre la suppression est activée, vous devez commencer par la désactiver avant de pouvoir supprimer le registre. Vous pouvez la désactiver en appelant l'opération `UpdateLedger` pour définir ce paramètre sur `false`.

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

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

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

La demande utilise les paramètres URI suivants.

 ** [name](#API_DeleteLedger_RequestSyntax) **   <a name="qldb-DeleteLedger-request-uri-Name"></a>
Nom du registre que vous souhaitez supprimer.  
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_DeleteLedger_RequestBody"></a>

La demande n’a pas de corps de requête.

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

```
HTTP/1.1 200
```

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

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

## Erreurs
<a name="API_DeleteLedger_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

 ** ResourceInUseException **   
La ressource spécifiée ne peut pas être modifiée pour le moment.  
Code d’état HTTP : 409

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

 ** ResourcePreconditionNotMetException **   
L'opération a échoué car une condition n'était pas satisfaite à l'avance.  
Code d’état HTTP : 412

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

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

Renvoie des informations détaillées sur un flux de journal Amazon QLDB donné. La sortie inclut le nom de ressource Amazon (ARN), le nom du flux, l'état actuel, l'heure de création et les paramètres de la demande de création de flux d'origine.

Cette action ne renvoie aucun flux de journal expiré. Pour plus d'informations, consultez la section [Expiration des flux de terminaux](https://docs.aws.amazon.com/qldb/latest/developerguide/streams.create.html#streams.create.states.expiration) dans le manuel *Amazon QLDB Developer Guide*.

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

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

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

La demande utilise les paramètres URI suivants.

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

 ** [streamId](#API_DescribeJournalKinesisStream_RequestSyntax) **   <a name="qldb-DescribeJournalKinesisStream-request-uri-StreamId"></a>
L'UUID (représenté dans un texte codé en Base62) du flux de journal QLDB à décrire.  
Contraintes de longueur : longueur fixe de 22.  
Modèle : `^[A-Za-z-0-9]+$`   
Obligatoire : oui

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

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<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"
   }
}
```

## Eléments de réponse
<a name="API_DescribeJournalKinesisStream_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.

 ** [Stream](#API_DescribeJournalKinesisStream_ResponseSyntax) **   <a name="qldb-DescribeJournalKinesisStream-response-Stream"></a>
Informations relatives au flux de journal QLDB renvoyé par une requête. `DescribeJournalS3Export`  
Type : objet [JournalKinesisStreamDescription](API_JournalKinesisStreamDescription.md)

## Erreurs
<a name="API_DescribeJournalKinesisStream_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

 ** ResourcePreconditionNotMetException **   
L'opération a échoué car une condition n'était pas satisfaite à l'avance.  
Code d’état HTTP : 412

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

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

Renvoie des informations sur une tâche d'exportation de journal, notamment le nom du registre, l'ID d'exportation, l'heure de création, le statut actuel et les paramètres de la demande de création d'exportation d'origine.

Cette action ne renvoie aucune tâche d'exportation expirée. Pour plus d'informations, consultez [Exporter l'expiration des tâches](https://docs.aws.amazon.com/qldb/latest/developerguide/export-journal.request.html#export-journal.request.expiration) dans le manuel *Amazon QLDB Developer Guide*.

Si la tâche d'exportation avec le paramètre donné `ExportId` n'existe pas, elle est lancée`ResourceNotFoundException`.

Si le registre contenant le donné `Name` n'existe pas, il est lancé. `ResourceNotFoundException`

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

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

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

La demande utilise les paramètres URI suivants.

 ** [exportId](#API_DescribeJournalS3Export_RequestSyntax) **   <a name="qldb-DescribeJournalS3Export-request-uri-ExportId"></a>
L'UUID (représenté dans du texte codé en Base62) de la tâche d'exportation du journal à décrire.  
Contraintes de longueur : longueur fixe de 22.  
Modèle : `^[A-Za-z-0-9]+$`   
Obligatoire : oui

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

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<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"
   }
}
```

## Eléments de réponse
<a name="API_DescribeJournalS3Export_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.

 ** [ExportDescription](#API_DescribeJournalS3Export_ResponseSyntax) **   <a name="qldb-DescribeJournalS3Export-response-ExportDescription"></a>
Informations relatives à la tâche d'exportation du journal renvoyées par une `DescribeJournalS3Export` demande.  
Type : objet [JournalS3ExportDescription](API_JournalS3ExportDescription.md)

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

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

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

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

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

Renvoie des informations sur un registre, notamment son état, son mode d'autorisation, les paramètres de chiffrement au repos et sa date de création.

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

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

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

La demande utilise les paramètres URI suivants.

 ** [name](#API_DescribeLedger_RequestSyntax) **   <a name="qldb-DescribeLedger-request-uri-Name"></a>
Le nom du registre que vous souhaitez décrire.  
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_DescribeLedger_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<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"
}
```

## Eléments de réponse
<a name="API_DescribeLedger_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_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-Arn"></a>
Le nom de ressource Amazon (ARN) du registre.  
Type : String  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 1600.

 ** [CreationDateTime](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-CreationDateTime"></a>
Date et heure, au format epoch time, auxquelles le registre a été créé. (Le format Epoch est le nombre de secondes écoulées depuis 00h00 le 1er janvier 1970 UTC.)  
Type : Timestamp

 ** [DeletionProtection](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-DeletionProtection"></a>
Spécifie si le registre est protégé contre la suppression par un utilisateur. À défaut de définition lors de la création du registre, cette fonctionnalité est activée (`true`) par défaut.  
Si la protection contre la suppression est activée, vous devez commencer par la désactiver avant de pouvoir supprimer le registre. Vous pouvez la désactiver en appelant l'opération `UpdateLedger` pour définir ce paramètre sur `false`.  
Type : booléen

 ** [EncryptionDescription](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-EncryptionDescription"></a>
Informations sur le chiffrement des données au repos dans le registre. Cela inclut l'état actuel, la AWS KMS clé et le moment où la clé est devenue inaccessible (en cas d'erreur). Si ce paramètre n'est pas défini, le registre utilise une clé KMS AWS détenue pour le chiffrement.  
Type : objet [LedgerEncryptionDescription](API_LedgerEncryptionDescription.md)

 ** [Name](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-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_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-PermissionsMode"></a>
Le mode d'autorisations du registre.  
Type : String  
Valeurs valides : `ALLOW_ALL | STANDARD` 

 ** [State](#API_DescribeLedger_ResponseSyntax) **   <a name="qldb-DescribeLedger-response-State"></a>
État actuel du registre.  
Type : String  
Valeurs valides : `CREATING | ACTIVE | DELETING | DELETED` 

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

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

Exporte le contenu d'un journal dans une plage de dates et d'heures depuis un registre vers un compartiment Amazon Simple Storage Service (Amazon S3) spécifié. Une tâche d'exportation de journal peut écrire les objets de données sous forme de texte ou de représentation binaire au format Amazon Ion, ou au format de texte *JSON Lines*.

Si le registre contenant le donné `Name` n'existe pas, il est lancé. `ResourceNotFoundException`

Si le registre contenant le donné `Name` est en `CREATING` état, il est lancé. `ResourcePreconditionNotMetException`

Vous pouvez lancer jusqu'à deux demandes d'exportation de journaux simultanées pour chaque registre. Au-delà de cette limite, les demandes d'exportation de journaux sont émises`LimitExceededException`.

## Syntaxe de la demande
<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"
   }
}
```

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

La demande utilise les paramètres URI suivants.

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

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

 ** [ExclusiveEndTime](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-ExclusiveEndTime"></a>
Date et heure de fin exclusives de la gamme de contenus de journaux à exporter.  
Le paramètre `ExclusiveEndTime` doit être au format date et heure `ISO 8601` et en temps universel coordonné (UTC). Par exemple : `2019-06-13T21:36:34Z`.  
La valeur `ExclusiveEndTime` doit être inférieure ou égale à la date et à l'heure UTC actuelles.  
Type : Timestamp  
Obligatoire : oui

 ** [InclusiveStartTime](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-InclusiveStartTime"></a>
Date et heure de début incluses pour la gamme de contenus du journal à exporter.  
Le paramètre `InclusiveStartTime` doit être au format date et heure `ISO 8601` et en temps universel coordonné (UTC). Par exemple : `2019-06-13T21:36:34Z`.  
Ça `InclusiveStartTime` doit être avant`ExclusiveEndTime`.  
Si vous fournissez un `InclusiveStartTime` qui se trouve avant celui du registre`CreationDateTime`, Amazon QLDB le définit par défaut sur celui du grand livre. `CreationDateTime`  
Type : Timestamp  
Obligatoire : oui

 ** [OutputFormat](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-OutputFormat"></a>
Format de sortie des données de journal exportées. Une tâche d'exportation de journal peut écrire les objets de données sous forme de texte ou de représentation binaire au format [Amazon Ion](https://docs.aws.amazon.com/qldb/latest/developerguide/ion.html), ou au format de texte [JSON Lines](https://jsonlines.org/).  
Par défaut : `ION_TEXT`   
Au format JSON Lines, chaque bloc de journal d'un objet de données exporté est un objet JSON valide délimité par une nouvelle ligne. Vous pouvez utiliser ce format pour intégrer directement les exportations JSON à des outils d'analyse tels qu'Amazon Athena et AWS Glue parce que ces services peuvent analyser automatiquement le JSON délimité par de nouvelles lignes.  
Type : String  
Valeurs valides : `ION_BINARY | ION_TEXT | JSON`   
Obligatoire : non

 ** [RoleArn](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-RoleArn"></a>
Le nom de ressource Amazon (ARN) du rôle IAM qui accorde les autorisations QLDB pour une tâche d'exportation de journal permet d'effectuer les opérations suivantes :  
+ Écrivez des objets dans votre compartiment Amazon S3.
+ (Facultatif) Utilisez votre clé gérée par le client dans AWS Key Management Service (AWS KMS) pour le chiffrement côté serveur de vos données exportées.
Pour transmettre un rôle à QLDB lors d'une demande d'exportation de journal, vous devez disposer des autorisations nécessaires pour effectuer `iam:PassRole` l'action sur la ressource du rôle IAM. Cela est obligatoire pour toutes les demandes d'exportation de journaux.  
Type : String  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 1600.  
Obligatoire : oui

 ** [S3ExportConfiguration](#API_ExportJournalToS3_RequestSyntax) **   <a name="qldb-ExportJournalToS3-request-S3ExportConfiguration"></a>
Les paramètres de configuration de la destination du compartiment Amazon S3 pour votre demande d'exportation.  
Type : objet [S3ExportConfiguration](API_S3ExportConfiguration.md)  
Obligatoire : oui

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

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

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

## Eléments de réponse
<a name="API_ExportJournalToS3_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.

 ** [ExportId](#API_ExportJournalToS3_ResponseSyntax) **   <a name="qldb-ExportJournalToS3-response-ExportId"></a>
L'UUID (représenté dans du texte codé en Base62) que QLDB attribue à chaque tâche d'exportation de journal.  
Pour décrire votre demande d'exportation et vérifier l'état de la tâche, vous pouvez utiliser `ExportId` to call`DescribeJournalS3Export`.  
Type : String  
Contraintes de longueur : longueur fixe de 22.  
Modèle : `^[A-Za-z-0-9]+$` 

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

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

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

 ** ResourcePreconditionNotMetException **   
L'opération a échoué car une condition n'était pas satisfaite à l'avance.  
Code d’état HTTP : 412

## consultez aussi
<a name="API_ExportJournalToS3_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/ExportJournalToS3) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/ExportJournalToS3) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/ExportJournalToS3) 

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

Renvoie un objet de type bloc à une adresse spécifiée dans un journal. Renvoie également une preuve du bloc spécifié pour vérification si elle `DigestTipAddress` est fournie.

Pour plus d'informations sur le contenu des données d'un bloc, consultez le [contenu du journal](https://docs.aws.amazon.com/qldb/latest/developerguide/journal-contents.html) dans le manuel *Amazon QLDB Developer Guide*.

Si le registre spécifié n'existe pas ou est en `DELETING` état, il est lancé. `ResourceNotFoundException`

Si le registre spécifié est en `CREATING` état, il lance`ResourcePreconditionNotMetException`.

Si aucun bloc n'existe avec l'adresse spécifiée, il est lancé`InvalidParameterException`.

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

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

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

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

La demande utilise les paramètres URI suivants.

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

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

 ** [BlockAddress](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-request-BlockAddress"></a>
L'emplacement du bloc que vous souhaitez demander. Une adresse est une structure Amazon Ion qui comporte deux champs : `strandId` et`sequenceNo`.  
Par exemple : `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}`.  
Type : objet [ValueHolder](API_ValueHolder.md)  
Obligatoire : oui

 ** [DigestTipAddress](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-request-DigestTipAddress"></a>
Le dernier emplacement du bloc couvert par le résumé pour lequel une preuve doit être demandée. Une adresse est une structure Amazon Ion qui comporte deux champs : `strandId` et`sequenceNo`.  
Par exemple : `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}`.  
Type : objet [ValueHolder](API_ValueHolder.md)  
Obligatoire : non

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

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

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

## Eléments de réponse
<a name="API_GetBlock_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.

 ** [Block](#API_GetBlock_ResponseSyntax) **   <a name="qldb-GetBlock-response-Block"></a>
L'objet de données de bloc au format Amazon Ion.  
Type : objet [ValueHolder](API_ValueHolder.md)

 ** [Proof](#API_GetBlock_ResponseSyntax) **   <a name="qldb-GetBlock-response-Proof"></a>
L'objet de preuve au format Amazon Ion renvoyé par une `GetBlock` demande. Une preuve contient la liste des valeurs de hachage requises pour recalculer le condensé spécifié à l'aide d'un arbre Merkle, en commençant par le bloc spécifié.  
Type : objet [ValueHolder](API_ValueHolder.md)

## Erreurs
<a name="API_GetBlock_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

 ** ResourcePreconditionNotMetException **   
L'opération a échoué car une condition n'était pas satisfaite à l'avance.  
Code d’état HTTP : 412

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

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

Renvoie le résumé d'un registre au dernier bloc validé du journal. La réponse inclut une valeur de hachage de 256 bits et une adresse de bloc.

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

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

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

La demande utilise les paramètres URI suivants.

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

La demande n’a pas de corps de requête.

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

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

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

## Eléments de réponse
<a name="API_GetDigest_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.

 ** [Digest](#API_GetDigest_ResponseSyntax) **   <a name="qldb-GetDigest-response-Digest"></a>
La valeur de hachage de 256 bits représentant le condensé renvoyé par une demande. `GetDigest`  
Type : objet de données binaires encodées en base64  
Contraintes de longueur : longueur fixe de 32.

 ** [DigestTipAddress](#API_GetDigest_ResponseSyntax) **   <a name="qldb-GetDigest-response-DigestTipAddress"></a>
L'emplacement du dernier bloc couvert par le résumé que vous avez demandé. Une adresse est une structure Amazon Ion qui comporte deux champs : `strandId` et`sequenceNo`.  
Type : objet [ValueHolder](API_ValueHolder.md)

## Erreurs
<a name="API_GetDigest_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

 ** ResourcePreconditionNotMetException **   
L'opération a échoué car une condition n'était pas satisfaite à l'avance.  
Code d’état HTTP : 412

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

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

Renvoie un objet de données de révision pour un ID de document et une adresse de bloc spécifiés. Renvoie également une preuve de la révision spécifiée pour vérification si elle `DigestTipAddress` est fournie.

## Syntaxe de la demande
<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"
}
```

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

La demande utilise les paramètres URI suivants.

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

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

 ** [BlockAddress](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-BlockAddress"></a>
Emplacement du bloc où se trouve la révision du document à vérifier. Une adresse est une structure Amazon Ion qui comporte deux champs : `strandId` et`sequenceNo`.  
Par exemple : `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}`.  
Type : objet [ValueHolder](API_ValueHolder.md)  
Obligatoire : oui

 ** [DigestTipAddress](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-DigestTipAddress"></a>
Le dernier emplacement du bloc couvert par le résumé pour lequel une preuve doit être demandée. Une adresse est une structure Amazon Ion qui comporte deux champs : `strandId` et`sequenceNo`.  
Par exemple : `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}`.  
Type : objet [ValueHolder](API_ValueHolder.md)  
Obligatoire : non

 ** [DocumentId](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-DocumentId"></a>
L'UUID (représenté dans le texte codé en Base62) du document à vérifier.  
Type : String  
Contraintes de longueur : longueur fixe de 22.  
Modèle : `^[A-Za-z-0-9]+$`   
Obligatoire : oui

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

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

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

## Eléments de réponse
<a name="API_GetRevision_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.

 ** [Proof](#API_GetRevision_ResponseSyntax) **   <a name="qldb-GetRevision-response-Proof"></a>
L'objet de preuve au format Amazon Ion renvoyé par une `GetRevision` demande. Une preuve contient la liste des valeurs de hachage nécessaires pour recalculer le condensé spécifié à l'aide d'un arbre Merkle, en commençant par la révision du document spécifiée.  
Type : objet [ValueHolder](API_ValueHolder.md)

 ** [Revision](#API_GetRevision_ResponseSyntax) **   <a name="qldb-GetRevision-response-Revision"></a>
L'objet de données de révision du document au format Amazon Ion.  
Type : objet [ValueHolder](API_ValueHolder.md)

## Erreurs
<a name="API_GetRevision_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

 ** ResourcePreconditionNotMetException **   
L'opération a échoué car une condition n'était pas satisfaite à l'avance.  
Code d’état HTTP : 412

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

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

Renvoie tous les flux de journaux Amazon QLDB pour un registre donné.

Cette action ne renvoie aucun flux de journal expiré. Pour plus d'informations, consultez la section [Expiration des flux de terminaux](https://docs.aws.amazon.com/qldb/latest/developerguide/streams.create.html#streams.create.states.expiration) dans le manuel *Amazon QLDB Developer Guide*.

Cette action renvoie un maximum d'`MaxResults`éléments. Il est paginé afin que vous puissiez récupérer tous les éléments en appelant `ListJournalKinesisStreamsForLedger` plusieurs fois.

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

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

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

La demande utilise les paramètres URI suivants.

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

 ** [MaxResults](#API_ListJournalKinesisStreamsForLedger_RequestSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-request-uri-MaxResults"></a>
Le nombre maximum de résultats à renvoyer dans une seule `ListJournalKinesisStreamsForLedger` requête. (Le nombre réel de résultats renvoyés peut être inférieur.)  
Plage valide : valeur minimum de 1. Valeur maximale fixée à 100.

 ** [NextToken](#API_ListJournalKinesisStreamsForLedger_RequestSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-request-uri-NextToken"></a>
Un jeton de pagination, indiquant que vous souhaitez récupérer la page de résultats suivante. Si vous avez reçu une valeur pour `NextToken` dans la réponse d'un `ListJournalKinesisStreamsForLedger` appel précédent, vous devez utiliser cette valeur comme entrée ici.  
Contraintes de longueur : longueur minimale de 4. Longueur maximum de 1024.  
Modèle : `^[A-Za-z-0-9+/=]+$` 

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

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<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"
      }
   ]
}
```

## Eléments de réponse
<a name="API_ListJournalKinesisStreamsForLedger_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.

 ** [NextToken](#API_ListJournalKinesisStreamsForLedger_ResponseSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-response-NextToken"></a>
+ S'il `NextToken` est vide, la dernière page de résultats a été traitée et il n'y a plus de résultats à récupérer.
+ Si `NextToken` ce *n'est pas* vide, d'autres résultats sont disponibles. Pour récupérer la page de résultats suivante, utilisez la valeur de `NextToken` lors d'un `ListJournalKinesisStreamsForLedger` appel suivant.
Type : String  
Contraintes de longueur : longueur minimale de 4. Longueur maximum de 1024.  
Modèle : `^[A-Za-z-0-9+/=]+$` 

 ** [Streams](#API_ListJournalKinesisStreamsForLedger_ResponseSyntax) **   <a name="qldb-ListJournalKinesisStreamsForLedger-response-Streams"></a>
Les flux de journaux QLDB actuellement associés au registre donné.  
Type : tableau d’objets [JournalKinesisStreamDescription](API_JournalKinesisStreamDescription.md)

## Erreurs
<a name="API_ListJournalKinesisStreamsForLedger_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

 ** ResourcePreconditionNotMetException **   
L'opération a échoué car une condition n'était pas satisfaite à l'avance.  
Code d’état HTTP : 412

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

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

Renvoie toutes les tâches d'exportation de journaux pour tous les livres associés au livre actuel Compte AWS et à la région.

Cette action renvoie un maximum d'`MaxResults`éléments et est paginée afin que vous puissiez récupérer tous les éléments en appelant `ListJournalS3Exports` plusieurs fois.

Cette action ne renvoie aucune tâche d'exportation expirée. Pour plus d'informations, consultez [Exporter l'expiration des tâches](https://docs.aws.amazon.com/qldb/latest/developerguide/export-journal.request.html#export-journal.request.expiration) dans le manuel *Amazon QLDB Developer Guide*.

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

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

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

La demande utilise les paramètres URI suivants.

 ** [MaxResults](#API_ListJournalS3Exports_RequestSyntax) **   <a name="qldb-ListJournalS3Exports-request-uri-MaxResults"></a>
Le nombre maximum de résultats à renvoyer dans une seule `ListJournalS3Exports` requête. (Le nombre réel de résultats renvoyés peut être inférieur.)  
Plage valide : valeur minimum de 1. Valeur maximale fixée à 100.

 ** [NextToken](#API_ListJournalS3Exports_RequestSyntax) **   <a name="qldb-ListJournalS3Exports-request-uri-NextToken"></a>
Un jeton de pagination, indiquant que vous souhaitez récupérer la page de résultats suivante. Si vous avez reçu une valeur pour `NextToken` dans la réponse d'un `ListJournalS3Exports` appel précédent, vous devez utiliser cette valeur comme entrée ici.  
Contraintes de longueur : longueur minimale de 4. Longueur maximum de 1024.  
Modèle : `^[A-Za-z-0-9+/=]+$` 

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

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<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"
}
```

## Eléments de réponse
<a name="API_ListJournalS3Exports_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.

 ** [JournalS3Exports](#API_ListJournalS3Exports_ResponseSyntax) **   <a name="qldb-ListJournalS3Exports-response-JournalS3Exports"></a>
Les tâches d'exportation du journal pour tous les livres associés au livre actuel Compte AWS et à la région.  
Type : tableau d’objets [JournalS3ExportDescription](API_JournalS3ExportDescription.md)

 ** [NextToken](#API_ListJournalS3Exports_ResponseSyntax) **   <a name="qldb-ListJournalS3Exports-response-NextToken"></a>
+ S'il `NextToken` est vide, cela signifie que la dernière page de résultats a été traitée et qu'il n'y a plus de résultats à récupérer.
+ Si `NextToken` ce *n'est pas* vide, cela signifie que d'autres résultats sont disponibles. Pour récupérer la page de résultats suivante, utilisez la valeur de `NextToken` lors d'un `ListJournalS3Exports` appel suivant.
Type : String  
Contraintes de longueur : longueur minimale de 4. Longueur maximum de 1024.  
Modèle : `^[A-Za-z-0-9+/=]+$` 

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

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

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

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

Renvoie toutes les tâches d'exportation de journaux pour un registre spécifié.

Cette action renvoie un maximum d'`MaxResults`éléments et est paginée afin que vous puissiez récupérer tous les éléments en appelant `ListJournalS3ExportsForLedger` plusieurs fois.

Cette action ne renvoie aucune tâche d'exportation expirée. Pour plus d'informations, consultez [Exporter l'expiration des tâches](https://docs.aws.amazon.com/qldb/latest/developerguide/export-journal.request.html#export-journal.request.expiration) dans le manuel *Amazon QLDB Developer Guide*.

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

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

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

La demande utilise les paramètres URI suivants.

 ** [MaxResults](#API_ListJournalS3ExportsForLedger_RequestSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-request-uri-MaxResults"></a>
Le nombre maximum de résultats à renvoyer par `ListJournalS3ExportsForLedger` requête. (Le nombre réel de résultats renvoyés peut être inférieur.)  
Plage valide : valeur minimum de 1. Valeur maximale fixée à 100.

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

 ** [NextToken](#API_ListJournalS3ExportsForLedger_RequestSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-request-uri-NextToken"></a>
Un jeton de pagination, indiquant que vous souhaitez récupérer la page de résultats suivante. Si vous avez reçu une valeur pour `NextToken` dans la réponse d'un `ListJournalS3ExportsForLedger` appel précédent, vous devez utiliser cette valeur comme entrée ici.  
Contraintes de longueur : longueur minimale de 4. Longueur maximum de 1024.  
Modèle : `^[A-Za-z-0-9+/=]+$` 

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

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<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"
}
```

## Eléments de réponse
<a name="API_ListJournalS3ExportsForLedger_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.

 ** [JournalS3Exports](#API_ListJournalS3ExportsForLedger_ResponseSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-response-JournalS3Exports"></a>
Les tâches d'exportation de journaux actuellement associées au registre spécifié.  
Type : tableau d’objets [JournalS3ExportDescription](API_JournalS3ExportDescription.md)

 ** [NextToken](#API_ListJournalS3ExportsForLedger_ResponseSyntax) **   <a name="qldb-ListJournalS3ExportsForLedger-response-NextToken"></a>
+ S'il `NextToken` est vide, cela signifie que la dernière page de résultats a été traitée et qu'il n'y a plus de résultats à récupérer.
+ Si `NextToken` ce *n'est pas* vide, cela signifie que d'autres résultats sont disponibles. Pour récupérer la page de résultats suivante, utilisez la valeur de `NextToken` lors d'un `ListJournalS3ExportsForLedger` appel suivant.
Type : String  
Contraintes de longueur : longueur minimale de 4. Longueur maximum de 1024.  
Modèle : `^[A-Za-z-0-9+/=]+$` 

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

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

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

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

Renvoie tous les registres associés au livre actuel Compte AWS et à la région.

Cette action renvoie un maximum d'`MaxResults`éléments et est paginée afin que vous puissiez récupérer tous les éléments en appelant `ListLedgers` plusieurs fois.

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

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

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

La demande utilise les paramètres URI suivants.

 ** [MaxResults](#API_ListLedgers_RequestSyntax) **   <a name="qldb-ListLedgers-request-uri-MaxResults"></a>
Le nombre maximum de résultats à renvoyer dans une seule `ListLedgers` requête. (Le nombre réel de résultats renvoyés peut être inférieur.)  
Plage valide : valeur minimum de 1. Valeur maximale fixée à 100.

 ** [NextToken](#API_ListLedgers_RequestSyntax) **   <a name="qldb-ListLedgers-request-uri-NextToken"></a>
Un jeton de pagination, indiquant que vous souhaitez récupérer la page de résultats suivante. Si vous avez reçu une valeur pour `NextToken` dans la réponse d'un `ListLedgers` appel précédent, vous devez utiliser cette valeur comme entrée ici.  
Contraintes de longueur : longueur minimale de 4. Longueur maximum de 1024.  
Modèle : `^[A-Za-z-0-9+/=]+$` 

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

La demande n’a pas de corps de requête.

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

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

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

## Eléments de réponse
<a name="API_ListLedgers_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.

 ** [Ledgers](#API_ListLedgers_ResponseSyntax) **   <a name="qldb-ListLedgers-response-Ledgers"></a>
Les registres associés au courant Compte AWS et à la région.  
Type : tableau d’objets [LedgerSummary](API_LedgerSummary.md)

 ** [NextToken](#API_ListLedgers_ResponseSyntax) **   <a name="qldb-ListLedgers-response-NextToken"></a>
Un jeton de pagination, indiquant si d'autres résultats sont disponibles :  
+ S'il `NextToken` est vide, cela signifie que la dernière page de résultats a été traitée et qu'il n'y a plus de résultats à récupérer.
+ Si `NextToken` ce *n'est pas* vide, cela signifie que d'autres résultats sont disponibles. Pour récupérer la page de résultats suivante, utilisez la valeur de `NextToken` lors d'un `ListLedgers` appel suivant.
Type : String  
Contraintes de longueur : longueur minimale de 4. Longueur maximum de 1024.  
Modèle : `^[A-Za-z-0-9+/=]+$` 

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

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

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

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

Renvoie toutes les balises pour une ressource Amazon QLDB spécifiée.

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

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

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

La demande utilise les paramètres URI suivants.

 ** [resourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="qldb-ListTagsForResource-request-uri-ResourceArn"></a>
Nom de ressource Amazon (ARN) pour lequel répertorier les balises. Par exemple :  
 `arn:aws:qldb:us-east-1:123456789012:ledger/exampleLedger`   
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 1600.  
Obligatoire : oui

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

La demande n’a pas de corps de requête.

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

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

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

## Eléments de réponse
<a name="API_ListTagsForResource_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.

 ** [Tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="qldb-ListTagsForResource-response-Tags"></a>
Les balises actuellement associées à la ressource Amazon QLDB spécifiée.  
Type : mappage chaîne/chaîne  
Entrées cartographiques : nombre minimum de 0 éléments. Nombre maximum de 200 éléments.  
Contraintes de longueur de clé : longueur minimale de 1. Longueur maximale de 128.  
Contraintes de longueur de valeur : longueur minimale de 0. Longueur maximale de 256.

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

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

Crée un flux de journal pour un registre Amazon QLDB donné. Le flux capture chaque révision de document validée dans le journal du registre et transmet les données à une ressource Amazon Kinesis Data Streams spécifiée.

## Syntaxe de la demande
<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" 
   }
}
```

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

La demande utilise les paramètres URI suivants.

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

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

 ** [ExclusiveEndTime](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-ExclusiveEndTime"></a>
Date et heure exclusives spécifiant la date à laquelle le flux se termine. Si vous ne définissez pas ce paramètre, le flux s'exécute indéfiniment jusqu'à ce que vous l'annuliez.  
Le paramètre `ExclusiveEndTime` doit être au format date et heure `ISO 8601` et en temps universel coordonné (UTC). Par exemple : `2019-06-13T21:36:34Z`.  
Type : Timestamp  
Obligatoire : non

 ** [InclusiveStartTime](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-InclusiveStartTime"></a>
Date et heure de début incluses à partir de laquelle commence la diffusion des données de journal. Ce paramètre doit être au format date et heure `ISO 8601` et au format temps universel coordonné (UTC). Par exemple : `2019-06-13T21:36:34Z`.  
Le paramètre `InclusiveStartTime` ne peut pas être dans le futur et doit être avant `ExclusiveEndTime`.  
Si vous fournissez un paramètre `InclusiveStartTime` qui se trouve avant le registre `CreationDateTime`, QLDB l'affecte par défaut au paramètre `CreationDateTime` du registre.  
Type : Timestamp  
Obligatoire : oui

 ** [KinesisConfiguration](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-KinesisConfiguration"></a>
Paramètres de configuration de la destination Kinesis Data Streams pour votre demande de flux.  
Type : objet [KinesisConfiguration](API_KinesisConfiguration.md)  
Obligatoire : oui

 ** [RoleArn](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-RoleArn"></a>
Amazon Resource Name (ARN) du rôle IAM qui accorde des autorisations QLDB à un flux de journal pour écrire des enregistrements de données dans une ressource Kinesis Data Streams.  
Pour transmettre un rôle à QLDB lorsque vous demandez un flux de journal, vous devez disposer des autorisations nécessaires pour effectuer l'action `iam:PassRole` sur la ressource de rôle IAM. Cela est obligatoire pour toutes les demandes de flux de journal.  
Type : String  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 1600.  
Obligatoire : oui

 ** [StreamName](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-StreamName"></a>
Nom que vous souhaitez affecter au flux de journal QLDB. Les noms définis par l'utilisateur peuvent aider à identifier et à indiquer le but d'un flux.  
Votre nom de flux doit être unique parmi les autres flux *actifs* pour un registre donné. Les contraintes relatives aux noms de flux sont les mêmes que celles relatives aux noms de registres, telles que définies dans [Quotas dans Amazon QLDB](https://docs.aws.amazon.com/qldb/latest/developerguide/limits.html#limits.naming) dans le *Manuel du développeur Amazon QLDB*.  
Type : String  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 32.  
Modèle : `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Obligatoire : oui

 ** [Tags](#API_StreamJournalToKinesis_RequestSyntax) **   <a name="qldb-StreamJournalToKinesis-request-Tags"></a>
Les paires clé-valeur à ajouter sous forme de balises au flux que vous souhaitez créer. Les clés de balises sont sensibles à la casse. Les valeurs des balises distinguent les majuscules et minuscules et peuvent être nulles.  
Type : mappage chaîne/chaîne  
Entrées cartographiques : nombre minimum de 0 éléments. Nombre maximum de 200 éléments.  
Contraintes de longueur de clé : longueur minimale de 1. Longueur maximale de 128.  
Contraintes de longueur de valeur : longueur minimale de 0. Longueur maximale de 256.  
Obligatoire : non

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

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

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

## Eléments de réponse
<a name="API_StreamJournalToKinesis_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.

 ** [StreamId](#API_StreamJournalToKinesis_ResponseSyntax) **   <a name="qldb-StreamJournalToKinesis-response-StreamId"></a>
L'UUID (représenté dans du texte codé en Base62) que QLDB attribue à chaque flux de journal QLDB.  
Type : String  
Contraintes de longueur : longueur fixe de 22.  
Modèle : `^[A-Za-z-0-9]+$` 

## Erreurs
<a name="API_StreamJournalToKinesis_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

 ** ResourcePreconditionNotMetException **   
L'opération a échoué car une condition n'était pas satisfaite à l'avance.  
Code d’état HTTP : 412

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

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

Ajoute une ou plusieurs balises à une ressource Amazon QLDB spécifiée.

Une ressource peut comporter jusqu'à 50 balises. Si vous essayez de créer plus de 50 balises pour une ressource, votre demande échoue et renvoie une erreur.

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

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

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

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

La demande utilise les paramètres URI suivants.

 ** [resourceArn](#API_TagResource_RequestSyntax) **   <a name="qldb-TagResource-request-uri-ResourceArn"></a>
Le nom de ressource Amazon (ARN) auquel vous souhaitez ajouter les balises. Par exemple :  
 `arn:aws:qldb:us-east-1:123456789012:ledger/exampleLedger`   
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 1600.  
Obligatoire : oui

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

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

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="qldb-TagResource-request-Tags"></a>
Les paires clé-valeur à ajouter sous forme de balises à la ressource QLDB spécifiée. Les clés de balises sont sensibles à la casse. Si vous spécifiez une clé qui existe déjà pour la ressource, votre demande échoue et renvoie une erreur. Les valeurs des balises distinguent les majuscules et minuscules et peuvent être nulles.  
Type : mappage chaîne/chaîne  
Entrées cartographiques : nombre minimum de 0 éléments. Nombre maximum de 200 éléments.  
Contraintes de longueur de clé : longueur minimale de 1. Longueur maximale de 128.  
Contraintes de longueur de valeur : longueur minimale de 0. Longueur maximale de 256.  
Obligatoire : oui

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

```
HTTP/1.1 200
```

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

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

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

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

Supprime une ou plusieurs balises d'une ressource Amazon QLDB spécifiée. Vous pouvez spécifier jusqu'à 50 clés de balise à supprimer.

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

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

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

La demande utilise les paramètres URI suivants.

 ** [resourceArn](#API_UntagResource_RequestSyntax) **   <a name="qldb-UntagResource-request-uri-ResourceArn"></a>
Le nom de ressource Amazon (ARN) à partir duquel les balises doivent être supprimées. Par exemple :  
 `arn:aws:qldb:us-east-1:123456789012:ledger/exampleLedger`   
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 1600.  
Obligatoire : oui

 ** [TagKeys](#API_UntagResource_RequestSyntax) **   <a name="qldb-UntagResource-request-uri-TagKeys"></a>
La liste des clés de balise à supprimer.  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 128.  
Obligatoire : oui

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

La demande n’a pas de corps de requête.

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

```
HTTP/1.1 200
```

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

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

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

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

Met à jour les propriétés d'un registre.

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

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

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

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

La demande utilise les paramètres URI suivants.

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

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

 ** [DeletionProtection](#API_UpdateLedger_RequestSyntax) **   <a name="qldb-UpdateLedger-request-DeletionProtection"></a>
Spécifie si le registre est protégé contre la suppression par un utilisateur. À défaut de définition lors de la création du registre, cette fonctionnalité est activée (`true`) par défaut.  
Si la protection contre la suppression est activée, vous devez commencer par la désactiver avant de pouvoir supprimer le registre. Vous pouvez la désactiver en appelant l'opération `UpdateLedger` pour définir ce paramètre sur `false`.  
Type : booléen  
Obligatoire : non

 ** [KmsKey](#API_UpdateLedger_RequestSyntax) **   <a name="qldb-UpdateLedger-request-KmsKey"></a>
La clé in AWS Key Management Service (AWS KMS) à utiliser pour le chiffrement des données au repos dans le registre. Pour plus d'informations, veuillez consulter la rubrique [Chiffrement au repos](https://docs.aws.amazon.com/qldb/latest/developerguide/encryption-at-rest.html) dans le *Guide du développeur Amazon QLDB*.  
Utilisez l'une des options suivantes pour spécifier ce paramètre :  
+  `AWS_OWNED_KMS_KEY`: utilisez une AWS KMS clé détenue et gérée par AWS vous.
+  **Non défini** : n'apportez aucune modification à la clé KMS du registre.
+  **Une clé KMS symétrique gérée par le client valide** : utilisez la clé KMS de chiffrement symétrique spécifiée dans votre compte que vous créez, possédez et gérez.

  Amazon QLDB ne prend pas en charge les clés asymétriques. Pour plus d'informations, consultez la section [Utilisation de clés symétriques et asymétriques](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) dans le manuel du * AWS Key Management Service développeur*.
Pour spécifier une clé KMS gérée par le client, utilisez son ID de clé, son Amazon Resource Name (ARN), son nom d'alias ou son ARN d'alias. Lorsque vous utilisez un nom d'alias, préfixez-le avec `"alias/"`. Pour spécifier une clé dans un autre Compte AWS, vous devez utiliser l'ARN de la clé ou l'alias ARN.  
Par exemple :  
+ ID de clé : `1234abcd-12ab-34cd-56ef-1234567890ab` 
+ ARN de clé : `arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` 
+ Nom d'alias : `alias/ExampleAlias` 
+ ARN d'alias : `arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias` 
Pour plus d'informations, consultez la section [Identifiants clés (KeyId)](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id) dans le *guide du AWS Key Management Service développeur*.  
Type : String  
Contraintes de longueur : longueur maximale de 1600.  
Obligatoire : non

## Syntaxe de la réponse
<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"
}
```

## Eléments de réponse
<a name="API_UpdateLedger_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_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-Arn"></a>
Le nom de ressource Amazon (ARN) du registre.  
Type : String  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 1600.

 ** [CreationDateTime](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-CreationDateTime"></a>
Date et heure, au format epoch time, auxquelles le registre a été créé. (Le format Epoch est le nombre de secondes écoulées depuis 00h00 le 1er janvier 1970 UTC.)  
Type : Timestamp

 ** [DeletionProtection](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-DeletionProtection"></a>
Spécifie si le registre est protégé contre la suppression par un utilisateur. À défaut de définition lors de la création du registre, cette fonctionnalité est activée (`true`) par défaut.  
Si la protection contre la suppression est activée, vous devez commencer par la désactiver avant de pouvoir supprimer le registre. Vous pouvez la désactiver en appelant l'opération `UpdateLedger` pour définir ce paramètre sur `false`.  
Type : booléen

 ** [EncryptionDescription](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-EncryptionDescription"></a>
Informations sur le chiffrement des données au repos dans le registre. Cela inclut l'état actuel, la AWS KMS clé et le moment où la clé est devenue inaccessible (en cas d'erreur).  
Type : objet [LedgerEncryptionDescription](API_LedgerEncryptionDescription.md)

 ** [Name](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-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-]+$` 

 ** [State](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-State"></a>
État actuel du registre.  
Type : String  
Valeurs valides : `CREATING | ACTIVE | DELETING | DELETED` 

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

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

# Séance Amazon QLDB
<a name="API_Operations_Amazon_QLDB_Session"></a>

**Important**  
Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez [Migrer un registre Amazon QLDB vers Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

Les actions suivantes sont prises en charge par Amazon QLDB Session :
+  [SendCommand](API_QLDB-Session_SendCommand.md) 

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

Envoie une commande à un registre Amazon QLDB.

**Note**  
Au lieu d'interagir directement avec cette API, nous vous recommandons d'utiliser le pilote QLDB ou le shell QLDB pour exécuter des transactions de données sur un registre.  
Si vous travaillez avec un AWS SDK, utilisez le pilote QLDB. Le pilote fournit une couche d'abstraction de haut niveau au-dessus de cette API de données de session *QLDB* et gère `SendCommand` l'opération pour vous. Pour obtenir des informations et une liste des langages de programmation pris en charge, consultez [Getting started with the driver](https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started-driver.html) dans le manuel *Amazon QLDB Developer Guide*.
Si vous travaillez avec le AWS Command Line Interface (AWS CLI), utilisez le shell QLDB. Le shell est une interface de ligne de commande qui utilise le pilote QLDB pour interagir avec un registre. Pour plus d'informations, consultez [Accès à Amazon QLDB à l'aide du shell QLDB](https://docs.aws.amazon.com/qldb/latest/developerguide/data-shell.html).

## Syntaxe de la requête
<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": { 
   }
}
```

## Paramètres de demande
<a name="API_QLDB-Session_SendCommand_RequestParameters"></a>

Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).

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

 ** [AbortTransaction](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-AbortTransaction"></a>
Commande pour annuler la transaction en cours.  
Type : objet [AbortTransactionRequest](API_QLDB-Session_AbortTransactionRequest.md)  
Obligatoire : non

 ** [CommitTransaction](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-CommitTransaction"></a>
Commande permettant de valider la transaction spécifiée.  
Type : objet [CommitTransactionRequest](API_QLDB-Session_CommitTransactionRequest.md)  
Obligatoire : non

 ** [EndSession](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-EndSession"></a>
Commande pour terminer la session en cours.  
Type : objet [EndSessionRequest](API_QLDB-Session_EndSessionRequest.md)  
Obligatoire : non

 ** [ExecuteStatement](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-ExecuteStatement"></a>
Commande permettant d'exécuter une instruction dans la transaction spécifiée.  
Type : objet [ExecuteStatementRequest](API_QLDB-Session_ExecuteStatementRequest.md)  
Obligatoire : non

 ** [FetchPage](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-FetchPage"></a>
Commande pour récupérer une page.  
Type : objet [FetchPageRequest](API_QLDB-Session_FetchPageRequest.md)  
Obligatoire : non

 ** [SessionToken](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-SessionToken"></a>
Spécifie le jeton de session pour la commande en cours. Un jeton de session est constant pendant toute la durée de la session.  
Pour obtenir un jeton de session, exécutez la `StartSession` commande. Cela `SessionToken` est obligatoire pour chaque commande suivante émise au cours de la session en cours.  
Type : String  
Contraintes de longueur : longueur minimale de 4. Longueur maximum de 1024.  
Modèle : `^[A-Za-z-0-9+/=]+$`   
Obligatoire : non

 ** [StartSession](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-StartSession"></a>
Commande pour démarrer une nouvelle session. Un jeton de session est obtenu dans le cadre de la réponse.  
Type : objet [StartSessionRequest](API_QLDB-Session_StartSessionRequest.md)  
Obligatoire : non

 ** [StartTransaction](#API_QLDB-Session_SendCommand_RequestSyntax) **   <a name="qldb-QLDB-Session_SendCommand-request-StartTransaction"></a>
Commande pour démarrer une nouvelle transaction.  
Type : objet [StartTransactionRequest](API_QLDB-Session_StartTransactionRequest.md)  
Obligatoire : non

## Syntaxe de la réponse
<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"
   }
}
```

## Eléments de réponse
<a name="API_QLDB-Session_SendCommand_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.

 ** [AbortTransaction](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-AbortTransaction"></a>
Contient les détails de la transaction abandonnée.  
Type : objet [AbortTransactionResult](API_QLDB-Session_AbortTransactionResult.md)

 ** [CommitTransaction](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-CommitTransaction"></a>
Contient les détails de la transaction validée.  
Type : objet [CommitTransactionResult](API_QLDB-Session_CommitTransactionResult.md)

 ** [EndSession](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-EndSession"></a>
Contient les détails de la session terminée.  
Type : objet [EndSessionResult](API_QLDB-Session_EndSessionResult.md)

 ** [ExecuteStatement](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-ExecuteStatement"></a>
Contient les détails de l'instruction exécutée.  
Type : objet [ExecuteStatementResult](API_QLDB-Session_ExecuteStatementResult.md)

 ** [FetchPage](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-FetchPage"></a>
Contient les détails de la page récupérée.  
Type : objet [FetchPageResult](API_QLDB-Session_FetchPageResult.md)

 ** [StartSession](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-StartSession"></a>
Contient les détails de la session démarrée, y compris un jeton de session. Cela `SessionToken` est obligatoire pour chaque commande suivante émise au cours de la session en cours.  
Type : objet [StartSessionResult](API_QLDB-Session_StartSessionResult.md)

 ** [StartTransaction](#API_QLDB-Session_SendCommand_ResponseSyntax) **   <a name="qldb-QLDB-Session_SendCommand-response-StartTransaction"></a>
Contient les détails de la transaction démarrée.  
Type : objet [StartTransactionResult](API_QLDB-Session_StartTransactionResult.md)

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

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

 ** BadRequestException **   
Renvoyé si la demande est mal formulée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.  
Code d’état HTTP : 400

 ** CapacityExceededException **   
Renvoyé lorsque la demande dépasse la capacité de traitement du registre.  
Code d’état HTTP : 400

 ** InvalidSessionException **   
Renvoyé si la session n’existe plus après avoir expiré.  
Code d’état HTTP : 400

 ** LimitExceededException **   
Renvoie si une limite de ressources telle que le nombre de sessions actives est dépassée.  
Code d’état HTTP : 400

 ** OccConflictException **   
Renvoyé lorsqu'une transaction ne peut pas être écrite dans le journal en raison d'un échec lors de la phase de vérification du *contrôle de simultanéité optimiste* (OCC).  
Code d’état HTTP : 400

 ** RateExceededException **   
Renvoyé lorsque le taux de demandes dépasse le débit autorisé.  
Code d’état HTTP : 400

## consultez aussi
<a name="API_QLDB-Session_SendCommand_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-session-2019-07-11/SendCommand) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/qldb-session-2019-07-11/SendCommand) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-session-2019-07-11/SendCommand) 