Method: projects.locations.endpoints.queryData

Consulta la red para obtener información almacenada en el libro de registros, como cuentas y transacciones.

El acceso a ciertos campos sensibles, como los saldos de las cuentas, puede restringirse según la identidad del remitente que se deriva de la firma en la solicitud. Si el remitente no tiene permiso, los campos sensibles se ocultarán en la respuesta y se informarán en el campo redactedFields.

Solicitud HTTP


POST https://universalledger.googleapis.com/v1/{endpoint=projects/*/locations/*/endpoints/*}:queryData

Las URL usan la sintaxis de transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
endpoint

string

Obligatorio. Es el extremo para entregar la solicitud. Formato: projects/{project}/locations/{location}/endpoints/{endpoint} La ubicación es una región.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "serializedSignedQueryRequest": string
}
Campos
serializedSignedQueryRequest

string (bytes format)

Obligatorio. Es un SignedQueryRequest serializado en protobuf para consultar la red de Universal Ledger.

Es una cadena codificada en Base64.

Cuerpo de la respuesta

Es el mensaje de respuesta para endpoints.queryData.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "redactedFields": [
    {
      object (RedactedField)
    }
  ],

  // Union field kind can be only one of the following:
  "account": {
    object (Account)
  },
  "transactionState": {
    object (TransactionState)
  }
  // End of list of possible types for union field kind.
}
Campos
redactedFields[]

object (RedactedField)

Indica qué campos se ocultaron en la respuesta debido a restricciones de permisos.
Campo de unión kind. Es el resultado específico de la búsqueda. kind puede ser solo uno de los parámetros siguientes:
account

object (Account)

Es la información de la cuenta, si la búsqueda fue para una cuenta.
transactionState

object (TransactionState)

Es el estado de una transacción, si la búsqueda fue por una transacción.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.

TransactionState

Es el estado de una transacción.

Representación JSON 
{
  "transactionAttempts": [
    {
      object (TransactionAttempt)
    }
  ]
}
Campos
transactionAttempts[]

object (TransactionAttempt)

Una entrada por cada envío conocido de la transacción al validador que controla la solicitud.

RedactedField

Es información sobre un campo censurado en la respuesta.

Representación JSON 
{
  "redactedPath": string,
  "reason": string,
  "reasonCode": enum (Code)
}
Campos
redactedPath

string (FieldMask format)

Solo salida. Son las rutas de acceso de campo completamente calificadas que se ocultaron en la carga útil.

Esta es una lista separada por comas de los nombres de campos completamente calificados. Ejemplo: "user.displayName,photo".
reason

string

Solo salida. Es una explicación legible del motivo por el que se censuraron los campos.
reasonCode

enum (Code)

Solo salida. Es un código legible por máquinas que indica el motivo por el que se censuraron los campos.

Código

Son los códigos de error canónicos para las APIs de gRPC.

A veces, es posible que se apliquen varios códigos de error. Los servicios deben devolver el código de error más específico que corresponda. Por ejemplo, se prefiere OUT_OF_RANGE por sobre FAILED_PRECONDITION, si se aplican ambos códigos. Del mismo modo, se prefiere NOT_FOUND o ALREADY_EXISTS por sobre FAILED_PRECONDITION.

Enums
OK

No es un error; se muestra si la operación tuvo éxito.

Asignación HTTP: 200 OK
CANCELLED

La operación se canceló (en general, la cancela el emisor).

Asignación HTTP: 499 Solicitud cerrada por el cliente
UNKNOWN

Error desconocido. Por ejemplo, este error puede mostrarse cuando un valor Status recibido de otro espacio de direcciones pertenece a un espacio de error desconocido en este espacio de direcciones. Además, los errores que las APIs generan y que no muestran suficiente información pueden convertirse en este error.

Asignación HTTP: 500 Error interno del servidor
INVALID_ARGUMENT

El cliente especificó un argumento no válido. Ten en cuenta que esto difiere de FAILED_PRECONDITION. INVALID_ARGUMENT indica los argumentos que son problemáticos sin importar el estado del sistema (p. ej., un nombre de archivo con formato incorrecto).

Asignación HTTP: 400 Solicitud incorrecta
DEADLINE_EXCEEDED

El plazo venció antes de que la operación se pudiera completar. En el caso de las operaciones que cambian el estado del sistema, es probable que se muestre este error incluso si la operación se completó con éxito. Por ejemplo, una respuesta correcta desde un servidor podría haberse demorado lo suficiente como para que el plazo venciera.

Asignación HTTP: 504 Tiempo de espera de la puerta de enlace
NOT_FOUND

No se encontró alguna entidad solicitada (p. ej., un archivo o un directorio).

Nota para los desarrolladores de servidores: Si se niega una solicitud a una clase completa de usuarios, como el lanzamiento gradual de funciones o una lista de entidades permitidas no documentada, se puede usar NOT_FOUND. Si se niega una solicitud a algunos usuarios de una clase, como el control de acceso basado en usuarios, se debe usar PERMISSION_DENIED.

Asignación HTTP: 404 No encontrado
ALREADY_EXISTS

La entidad que un cliente intentó crear (p. ej., un archivo o un directorio) ya existe.

Asignación HTTP: 409 Conflicto
PERMISSION_DENIED

El emisor no tiene permiso para ejecutar la operación especificada. No se debe usar PERMISSION_DENIED en los rechazos por agotamiento de algún recurso (en su lugar, se debe usar RESOURCE_EXHAUSTED). No se debe usar PERMISSION_DENIED si no se puede identificar al emisor (en su lugar, se debe usar UNAUTHENTICATED). Este código de error no sugiere que la solicitud sea válida ni que la entidad solicitada exista o satisfaga otras condiciones previas.

Asignación HTTP: 403 Prohibido
UNAUTHENTICATED

La solicitud no tiene credenciales de autenticación válidas para la operación.

Asignación HTTP: 401 No autorizado
RESOURCE_EXHAUSTED

Algunos recursos se agotaron, quizás una cuota por usuario, o tal vez se agotó el espacio de todo el sistema de archivos.

Asignación HTTP: 429 Demasiadas solicitudes
FAILED_PRECONDITION

La operación se rechazó debido a que el sistema no se encuentra en un estado necesario para la ejecución de la operación. Por ejemplo, el directorio que se borrará no está vacío o se aplicará una operación rmdir a un archivo que no es de directorio, entre otros.

Los implementadores de servicios pueden usar los siguientes lineamientos para optar por FAILED_PRECONDITION, ABORTED o UNAVAILABLE: (a) Usa UNAVAILABLE si el cliente puede reintentar solo la llamada con errores. (b) Usa ABORTED si el cliente debe reintentar en un nivel superior. Por ejemplo, cuando falla una prueba y un conjunto especificados por el cliente, lo que indica que este deberá reiniciar una secuencia de lectura, modificación y escritura. (c) Usa FAILED_PRECONDITION si el cliente no debe reintentar hasta que el estado del sistema se corrija de forma explícita. Por ejemplo, si un “rmdir” falla porque el directorio no está vacío, se debe mostrar FAILED_PRECONDITION, ya que el cliente no debe reintentar, a menos que se borren los archivos del directorio.

Asignación HTTP: 400 Solicitud incorrecta
ABORTED

La operación se anuló. Esto suele ocurrir debido a un problema de simultaneidad, como una falla en la verificación del secuenciador o la anulación de la transacción.

Consulta los lineamientos anteriores para optar por FAILED_PRECONDITION, ABORTED o UNAVAILABLE.

Asignación HTTP: 409 Conflicto
OUT_OF_RANGE

Se intentó realizar la operación fuera del rango válido. P. ej., buscar o leer el final del archivo.

A diferencia de INVALID_ARGUMENT, este error indica un problema que se puede solucionar si el estado del sistema cambia. Por ejemplo, un sistema de archivos de 32 bits generará INVALID_ARGUMENT si se le pide que lea en un desplazamiento que no esté en el rango [0,2^32-1], pero generará OUT_OF_RANGE si se le solicita que lea desde un desplazamiento superior al tamaño del archivo actual.

Hay una leve superposición entre FAILED_PRECONDITION y OUT_OF_RANGE. Recomendamos usar OUT_OF_RANGE (el error más específico) cuando sea necesario, de modo que los emisores que iteran por medio de un espacio puedan buscar de forma sencilla un error OUT_OF_RANGE y, de esta manera, detectar cuando finalicen.

Asignación HTTP: 400 Solicitud incorrecta
UNIMPLEMENTED

La operación no se implementó, no se admite o no está habilitada en este servicio.

Asignación HTTP: 501 No implementado
INTERNAL

Errores internos. Esto significa que algunos invariantes que el sistema subyacente espera están dañados. Este código de error está reservado para errores graves.

Asignación HTTP: 500 Error interno del servidor
UNAVAILABLE

El servicio no está disponible por el momento. Lo más probable es que esta sea una condición transitoria y que se pueda corregir volviendo a aplicar una retirada. Ten en cuenta que no siempre es seguro reintentar operaciones que no son idempotentes.

Consulta los lineamientos anteriores para optar por FAILED_PRECONDITION, ABORTED o UNAVAILABLE.

Asignación HTTP: 503 Servicio no disponible
DATA_LOSS

Daño o pérdida de datos irrecuperable.

Asignación HTTP: 500 Error interno del servidor