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.
GetRevision
Devuelve un objeto de datos de revisión para un identificador de documento y una dirección de bloque específicos. También devuelve una prueba de la revisión especificada para su verificación, si se proporciona DigestTipAddress.
Sintaxis de la solicitud
POST /ledgers/name/revision HTTP/1.1
Content-type: application/json
{
"BlockAddress": {
"IonText": "string"
},
"DigestTipAddress": {
"IonText": "string"
},
"DocumentId": "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. 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 en el bloque de la revisión del documento que se va a verificar. 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
- DocumentId
-
El UUID (representado en texto codificado en Base62) del documento que se va a verificar.
Tipo: cadena
Limitaciones de longitud: longitud fija de 22.
Patrón:
^[A-Za-z-0-9]+$Obligatorio: sí
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"Proof": {
"IonText": "string"
},
"Revision": {
"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.
- Proof
-
El objeto de prueba en formato de Amazon Ion devuelto por una solicitud
GetRevision. Una prueba contiene la lista de valores hash necesarios para volver a calcular el resumen especificado mediante un árbol de Merkle, empezando por la revisión del documento especificada.Tipo: objeto ValueHolder
- Revision
-
El objeto de datos de revisión del documento en formato de Amazon Ion.
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:
