ListJournalKinesisStreamsForLedger - Base de données Amazon Quantum Ledger (AmazonQLDB)
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

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.

ListJournalKinesisStreamsForLedger

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

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

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

name

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

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

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

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

Syntaxe de la réponse

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

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

  • 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 : chaîne

Contraintes de longueur : longueur minimale de 4. Longueur maximum de 1024.

Modèle : ^[A-Za-z-0-9+/=]+$

Streams

Les flux de journaux QLDB actuellement associés au registre donné.

Type : tableau d’objets JournalKinesisStreamDescription

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

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

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :