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.
GetBlock
Devuelve un objeto de bloque en una dirección específica de un diario. También devuelve una prueba del bloque especificado para su verificación, si DigestTipAddress se proporciona.
Para obtener información sobre el contenido de datos de un bloque, consulte el contenido del diario en la Guía para desarrolladores de Amazon QLDB.
Si el libro mayor especificado no existe o está en estado DELETING, devuelve ResourceNotFoundException.
Si el libro mayor especificado está en estado CREATING, devuelve ResourcePreconditionNotMetException.
Si no existe ningún bloque con la dirección especificada, devuelve InvalidParameterException.
Sintaxis de la solicitud
POST /ledgers/name/block HTTP/1.1
Content-type: application/json
{
"BlockAddress": {
"IonText": "string"
},
"DigestTipAddress": {
"IonText": "string"
}
}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í
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- BlockAddress
-
La ubicación del bloque que quiere solicitar. La dirección es una estructura de Amazon Ion que consta de dos campos:
strandIdysequenceNo.Por ejemplo:
{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}.Tipo: objeto ValueHolder
Obligatorio: sí
- DigestTipAddress
-
La última ubicación de bloque incluida en el resumen para la que se solicita una prueba. La dirección es una estructura de Amazon Ion que consta de dos campos:
strandIdysequenceNo.Por ejemplo:
{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}.Tipo: objeto ValueHolder
Obligatorio: no
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"Block": {
"IonText": "string"
},
"Proof": {
"IonText": "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.
- Block
-
El objeto de datos de bloque en formato de Amazon Ion.
Tipo: objeto ValueHolder
- Proof
-
El objeto de prueba en formato de Amazon Ion devuelto por una solicitud
GetBlock. Una prueba contiene la lista de valores hash necesarios para volver a calcular el resumen especificado mediante un árbol de Merkle, empezando por el bloque especificado.Tipo: objeto ValueHolder
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:
