ListJournalKinesisStreamsForLedger - Amazon Quantum Ledger Database (Amazon QLDB)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

ListJournalKinesisStreamsForLedger

Crea una secuencia de diario de Amazon QLDB para un libro mayor determinado.

Esta acción no devuelve ninguna secuencia del diario caducada. Para obtener más información, consulte caducidad de secuencias de terminal en la Guía para desarrolladores de Amazon QLDB.

Esta acción devuelve un máximo de objetos MaxResults. Está paginada para que pueda recuperar todos los elementos llamando a ListJournalKinesisStreamsForLedger varias veces.

Sintaxis de la solicitud

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

Parámetros de solicitud del URI

La solicitud utiliza los siguientes parámetros URI.

name

El nombre de contabilidad.

Limitaciones de longitud: longitud mínima de 1 carácter. La longitud máxima es de 32 caracteres.

Patrón: (?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$

Obligatorio: sí

MaxResults

El número máximo de resultados que se devuelven en una única solicitud ListJournalKinesisStreamsForLedger. (Es posible que el número real de resultados devueltos sea inferior).

Rango válido: valor mínimo de 1. Valor máximo de 100.

NextToken

Un token de paginación que indica que desea recuperar la siguiente página de resultados. Si recibió un valor para NextToken en la respuesta de una llamada anterior a ListJournalKinesisStreamsForLedger, debe usar ese valor como entrada aquí.

Limitaciones de longitud: longitud mínima de 4. La longitud máxima es de 1024 caracteres.

Patrón: ^[A-Za-z-0-9+/=]+$

Cuerpo de la solicitud

La solicitud no tiene un cuerpo de la solicitud.

Sintaxis de la respuesta

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" } ] }

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

NextToken
  • Si NextToken está vacío, se ha procesado la última página de resultados y no hay más resultados que recuperar.

  • Si NextToken no está vacío, hay más resultados disponibles. Para recuperar la siguiente página de resultados, use el valor de NextToken en una llamada posterior a ListJournalKinesisStreamsForLedger.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 4. La longitud máxima es de 1024 caracteres.

Patrón: ^[A-Za-z-0-9+/=]+$

Streams

Las secuencias del diario de QLDB que están asociadas actualmente al libro mayor determinado.

Tipo: matriz de objetos JournalKinesisStreamDescription

Errores

Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.

InvalidParameterException

Uno o más parámetros de la solicitud no son válidos.

Código de estado HTTP: 400

ResourceNotFoundException

El recurso especificado no existe.

Código de estado HTTP: 404

ResourcePreconditionNotMetException

La operación ha fallado porque no se ha cumplido una condición previa.

Código de estado HTTP: 412

Véase también

Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente: