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. 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
NextTokenen la respuesta de una llamada anterior aListJournalKinesisStreamsForLedger, 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
NextTokenestá vacío, se ha procesado la última página de resultados y no hay más resultados que recuperar. -
Si
NextTokenno está vacío, hay más resultados disponibles. Para recuperar la siguiente página de resultados, use el valor deNextTokenen una llamada posterior aListJournalKinesisStreamsForLedger.
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 idiomas específicos AWS SDKs, consulta lo siguiente:
