Documentos de Asset Core

Documentación del motor de estado mundial determinista y referencias de API.

Documentos de Decision Gate

leer Puntos finales

Leer operaciones del daemon (consultas y proyecciones)

Puntos finales

GET /v1/read/health

Resumen: OpenAPI metadatos para el punto de control de salud del daemon de lectura.

ID de operación: read_health_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
x-assetcore-namespaceencabezadoNamespaceIdAlcance del namespace para leer sondas de salud (requerido).

Respuestas

EstadoDescripciónEsquema
200Leer estado de salud del daemonReadHealthResponse
401Solicitud no autorizadaProblemDetails
403Solicitud prohibidaProblemDetails
429Cuota excedidaProblemDetails
500Servicio no disponibleProblemDetails

GET /v1/read/livez

Resumen: OpenAPI metadatos para la sonda de disponibilidad del daemon de lectura.

ID de operación: read_livez_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
x-assetcore-namespaceencabezadoNamespaceIdAlcance del namespace para leer sondas de salud (requerido).

Respuestas

EstadoDescripciónEsquema
200Probar la vitalidad del daemon de lecturaProbeResponse
401Solicitud no autorizadaProblemDetails
403Solicitud prohibidaProblemDetails
429Cuota excedidaProblemDetails
500Servicio no disponibleProblemDetails

GET /v1/read/namespaces/{namespace_id}/classes

Resumen: OpenAPI metadatos para el punto final de listado del registro de clases.

ID de operación: class_list_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
namespace_idpathNamespaceIdIdentificador del espacio de nombres
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia de mundo especificada antes de responder.
cursorquerynostringCursor opcional anclado al último identificador de clase visto.
limitquerynointegerNúmero máximo de entradas a devolver (por defecto 20, limitado a 200).

Respuestas

EstadoDescripciónEsquema
200Listado de registro de clases paginadoClassListResponse
400Parámetros de consulta no válidosProblemDetails
401Solicitud no autorizadaProblemDetails
404Espacio de nombres no encontradoProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespace_id}/classes/{id}

Resumen: OpenAPI metadatos para el endpoint de detalle de clase.

ID de operación: class_detail_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
namespace_idpathNamespaceIdIdentificador del espacio de nombres
idpathExternalIdIdentificador externo de la clase
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia de mundo especificada antes de responder.

Respuestas

EstadoDescripciónEsquema
200Detalle de claseClassDetailResponse
400Identificador de clase no válidoProblemDetails
401Solicitud no autorizadaProblemDetails
404Clase no encontradaProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespace_id}/classes/{id}/shapes

Resumen: OpenAPI metadatos para el endpoint de formas de clase.

ID de operación: class_shapes_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
namespace_idpathNamespaceIdIdentificador del espacio de nombres
idpathExternalIdIdentificador externo de la clase
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia de mundo especificada antes de responder.

Respuestas

EstadoDescripciónEsquema
200Enumeración de formas de claseClassShapesResponse
400Identificador de clase no válidoProblemDetails
401Solicitud no autorizadaProblemDetails
404Clase no encontradaProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespace_id}/classes/stats

Resumen: OpenAPI metadatos para el endpoint de estadísticas de la clase.

ID de operación: class_stats_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
namespace_idpathNamespaceIdIdentificador de espacio de nombres
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia de mundo especificada antes de responder.

Respuestas

EstadoDescripciónEsquema
200Registro de clases y estadísticas de almacenamientoClassStatsResponse
401Solicitud no autorizadaProblemDetails
404Espacio de nombres no encontradoProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespace_id}/commits

Resumen: OpenAPI metadatos para el endpoint del historial de commits.

ID de operación: commits_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
namespace_idpathNamespaceIdIdentificador de espacio de nombres
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia de mundo especificada antes de responder.
limitquerynointegerNúmero máximo de commits a devolver (limitado a 100).
from_world_seqquerynointegerSecuencia de mundo inicial a devolver (por defecto: 0, comenzar desde el principio).

Respuestas

EstadoDescripciónEsquema
200Historial de confirmacionesCommitsResponse
400Parámetros de consulta no válidosProblemDetails
401Solicitud no autorizadaProblemDetails
404Espacio de nombres no encontradoProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespace_id}/containers

Resumen: OpenAPI metadatos para el endpoint de listado de contenedores.

ID de operación: container_list_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
namespace_idpathNamespaceIdIdentificador del espacio de nombres
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia de mundo especificada antes de responder.
ownerquerynostringFiltro de propietario opcional (identificador de propietario externo).
kindquerynostringFiltro de tipo opcional (balance, grid, slots, continuous_line_1d, continuous_grid_2d).
cursorquerynostringCursor opcional anclado al identificador del último contenedor visto.
limitquerynointegerNúmero máximo de entradas a devolver (limitado a [MAX_LIST_LIMIT]).

Respuestas

EstadoDescripciónEsquema
200Listado de contenedoresContainerListResponse
400Parámetros de filtro no válidosProblemDetails
401Solicitud no autorizadaProblemDetails
404Espacio de nombres no encontradoProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespace_id}/containers/{id}

Resumen: OpenAPI metadatos para el punto de acceso de búsqueda de detalles del contenedor.

ID de operación: container_endpoint

Parámetros

NameInRequiredTypeDescription
namespace_idpathyesNamespaceIdIdentificador del espacio de nombres
idpathyesExternalIdIdentificador externo del contenedor
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia de mundo especificada antes de responder.

Respuestas

EstadoDescripciónEsquema
200Instantánea de detalles del contenedorContainerResponse
400Identificador de contenedor no válidoProblemDetails
401Solicitud no autorizadaProblemDetails
404Contenedor no encontradoProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespace_id}/containers/{id}/balances

Resumen: OpenAPI metadatos para el punto final de listado de saldo del contenedor.

ID de operación: container_balances_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
namespace_idpathNamespaceIdIdentificador del espacio de nombres
idpathExternalIdIdentificador externo del contenedor
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia mundial especificada antes de responder.
classquerynostringFiltro opcional sobre el identificador externo de la clase de activo (por ejemplo, "class-1"). Cuando está presente, solo se incluyen los saldos que coinciden con esta clase en la respuesta.
keyquerynostringFiltro opcional sobre la clave de variante ([StackKey]) expresada como una cadena (por ejemplo, "42"). Cuando está presente, solo se incluyen los saldos con esta clave de variante. Si el sistema no utiliza claves de variante para una clase, omita esto.

Respuestas

EstadoDescripciónEsquema
200Saldos de contenedoresBalanceResponse
400Parámetros de consulta no válidosProblemDetails
401Solicitud no autorizadaProblemDetails
404Contenedor no encontradoProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespace_id}/containers/{id}/commits

Resumen: OpenAPI metadatos para el endpoint del historial de commits del contenedor.

ID de operación: container_commits_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
namespace_idpathNamespaceIdIdentificador del espacio de nombres
idpathExternalIdIdentificador externo del contenedor
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia mundial especificada antes de responder.
limitquerynointegerNúmero máximo de commits a devolver (limitado a 100).
from_world_seqquerynointegerSecuencia mundial inicial a devolver (por defecto: 0, comenzar desde el principio).

Respuestas

EstadoDescripciónEsquema
200Historial de confirmaciones del contenedorCommitsResponse
400Parámetros de consulta no válidosProblemDetails
401Solicitud no autorizadaProblemDetails
404Contenedor no encontradoProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespace_id}/containers/{id}/contents

Resumen: OpenAPI metadatos para el endpoint de contenidos del contenedor.

ID de operación: container_contents_endpoint

Parámetros

NameInRequiredTypeDescription
namespace_idpathyesNamespaceIdIdentificador del espacio de nombres
idpathyesExternalIdIdentificador externo del contenedor
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia de mundo especificada antes de responder.

Respuestas

EstadoDescripciónEsquema
200Contenido del contenedorContainerContentsResponse
400Identificador de contenedor no válidoProblemDetails
401Solicitud no autorizadaProblemDetails
404Contenedor no encontradoProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespaceid}/containers/{id}/continuous1d/placements

Resumen: OpenAPI metadatos para el endpoint de colocación continua 1D.

ID de operación: container_continuous_placements_1d_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
namespace_idpathNamespaceIdIdentificador del namespace
idpathExternalIdIdentificador externo del contenedor
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia mundial especificada antes de responder.
min_xquerynointegerLímite mínimo X inclusivo opcional (unidades de punto fijo).
max_xquerynointegerLímite máximo X inclusivo opcional (unidades de punto fijo).

Respuestas

EstadoDescripciónEsquema
200Colocaciones de contenedores 1D continuasContinuous1dPlacementsResponse
400Parámetros de región 1D continua no válidosProblemDetails
401Solicitud no autorizadaProblemDetails
404Contenedor no encontradoProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespaceid}/containers/{id}/continuous2d/placements

Resumen: OpenAPI metadatos para el endpoint de colocación continua en 2D.

ID de operación: container_continuous_placements_2d_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
namespace_idpathNamespaceIdIdentificador del namespace
idpathExternalIdIdentificador externo del contenedor
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia mundial especificada antes de responder.
min_xquerynointegerLímite mínimo X opcional inclusivo (unidades de punto fijo).
min_yquerynointegerLímite mínimo Y opcional inclusivo (unidades de punto fijo).
max_xquerynointegerLímite máximo X opcional inclusivo (unidades de punto fijo).
max_yquerynointegerLímite máximo Y opcional inclusivo (unidades de punto fijo).

Respuestas

EstadoDescripciónEsquema
200Colocaciones continuas de contenedores 2DContinuous2dPlacementsResponse
400Parámetros de región 2D continua no válidosProblemDetails
401Solicitud no autorizadaProblemDetails
404Contenedor no encontradoProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespace_id}/containers/{id}/grid/cells

Resumen: OpenAPI metadatos para el endpoint de colocación en la cuadrícula.

ID de operación: container_grid_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
namespace_idpathNamespaceIdIdentificador del espacio de nombres
idpathExternalIdIdentificador externo del contenedor
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia mundial especificada antes de responder.
xquerynointegerCoordenada X basada en 0 (columna).
yquerynointegerCoordenada Y basada en 0 (fila).
widthquerynointegerAncho de la región (celdas).
heightquerynointegerAltura de la región (celdas).

Respuestas

EstadoDescripciónEsquema
200Ubicaciones de cuadrícula de contenedoresGridPlacementResponse
400Parámetros de región de cuadrícula no válidosProblemDetails
401Solicitud no autorizadaProblemDetails
404Contenedor no encontradoProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespace_id}/containers/{id}/grid/free

Resumen: OpenAPI metadatos para el punto final de búsqueda en la región libre de la cuadrícula.

ID de operación: container_grid_free_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
namespace_idpathNamespaceIdIdentificador del namespace
idpathExternalIdIdentificador externo del contenedor
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia de mundo especificada antes de responder.
widthquerynointegerAncho de forma deseado (celdas).
heightquerynointegerAltura de forma deseada (celdas).

Respuestas

EstadoDescripciónEsquema
200Búsqueda de región libre de cuadrículaGridFreeResponse
400Parámetros de forma de cuadrícula no válidosProblemDetails
401Solicitud no autorizadaProblemDetails
404Contenedor no encontradoProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespace_id}/containers/{id}/slots

Resumen: OpenAPI metadatos para el endpoint de ocupación de slots.

ID de operación: container_slots_endpoint

Parámetros

NameInRequiredTypeDescription
namespace_idpathyesNamespaceIdIdentificador del espacio de nombres
idpathyesExternalIdIdentificador externo del contenedor
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia de mundo especificada antes de responder.

Respuestas

EstadoDescripciónEsquema
200Ocupación del contenedor de ranurasSlotResponse
400Identificador de contenedor no válidoProblemDetails
401Solicitud no autorizadaProblemDetails
404Contenedor no encontradoProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespace_id}/freshness

Resumen: OpenAPI metadatos para el endpoint de frescura de proyección.

ID de operación: freshness_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
namespace_idpathNamespaceIdIdentificador de espacio de nombres
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia de mundo especificada antes de responder.

Respuestas

EstadoDescripciónEsquema
200Metadatos de frescura de proyecciónFreshnessResponse
401Solicitud no autorizadaProblemDetails
404Espacio de nombres no encontradoProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Proyección no disponibleProblemDetails

GET /v1/read/namespaces/{namespace_id}/instances

Resumen: OpenAPI metadatos para el punto final de listado de instancias.

ID de operación: instance_list_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
namespace_idpathNamespaceIdIdentificador de espacio de nombres
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia de mundo especificada antes de responder.
classquerynostringFiltro de clase opcional (identificador externo).
variant_keyquerynostringFiltro de clave de variante opcional.
ownerquerynostringFiltro de propietario opcional (identificador de propietario externo).
cursorquerynostringCursor opcional anclado al identificador de la última instancia vista.
limitquerynointegerNúmero máximo de entradas a devolver (limitado a [MAX_LIST_LIMIT]).

Respuestas

EstadoDescripciónEsquema
200Listado de instanciasInstanceListResponse
400Parámetros de consulta no válidosProblemDetails
401Solicitud no autorizadaProblemDetails
404Espacio de nombres no encontradoProblemDetails
425La proyección no ha alcanzado la secuencia de mundo solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespace_id}/instances/{id}

Resumen: OpenAPI metadatos para el endpoint de detalle de instancia.

ID de operación: instance_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
namespace_idrutaNamespaceIdIdentificador de espacio de nombres
idrutaExternalIdIdentificador externo de la instancia
x-assetcore-min-world-seqencabezadonoenteroRequiere proyección para alcanzar la secuencia de mundo especificada antes de responder.

Respuestas

EstadoDescripciónEsquema
200Detalle de la instanciaInstanceResponse
400Identificador de instancia no válidoProblemDetails
401Solicitud no autorizadaProblemDetails
404Instancia no encontradaProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespace_id}/owners/{id}/summary

Resumen: OpenAPI metadatos para el punto final de resumen del propietario.

ID de operación: owner_summary_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
namespace_idpathNamespaceIdIdentificador de espacio de nombres
idpathExternalIdIdentificador externo del propietario
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia mundial especificada antes de responder.

Respuestas

EstadoDescripciónEsquema
200Resumen del propietarioOwnerSummaryResponse
400Identificador de propietario no válidoProblemDetails
401Solicitud no autorizadaProblemDetails
404Propietario no encontradoProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespace_id}/replay

Resumen: OpenAPI metadatos para el punto final de repetición.

ID de operación: replay_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
namespace_idpathNamespaceIdIdentificador del espacio de nombres
x-assetcore-min-world-seqheadernointegerRequiere proyección para alcanzar la secuencia de mundo especificada antes de responder.
from_world_seqquerynointegerSecuencia de mundo desde la cual reproducir (inclusive).
limitquerynointegerNúmero máximo de lotes a devolver (limitado a 100).

Respuestas

EstadoDescripciónEsquema
200Repetir lotesReplayResponse
400Parámetros de consulta no válidosProblemDetails
401Solicitud no autorizadaProblemDetails
404Espacio de nombres no encontradoProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails

GET /v1/read/namespaces/{namespace_id}/stream

Resumen: OpenAPI metadatos para el punto final de flujo de lectura.

ID de operación: read_stream_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
namespace_idpathNamespaceIdIdentificador del espacio de nombres
x-assetcore-min-world-seqheadernoenteroRequiere proyección para alcanzar la secuencia de mundo especificada antes de responder.
Last-Event-IdheadernoenteroCursor de reanudación SSE; el flujo se reanuda en last_event_id + 1.
from_world_seqquerynoenteroSecuencia de mundo opcional para comenzar a transmitir (inclusive).
limitquerynoenteroNúmero máximo opcional de lotes a emitir antes de cerrar el flujo.

Respuestas

EstadoDescripciónEsquema
200Flujo de lotes de confirmaciones (SSE)StreamEntry
400Parámetros de consulta no válidosProblemDetails
401Solicitud no autorizadaProblemDetails
404Espacio de nombres no encontradoProblemDetails
425La proyección no ha alcanzado la secuencia mundial solicitadaProblemDetails
429Cuota excedidaProblemDetails
500Error interno del servidorProblemDetails
503Flujo no disponibleProblemDetails

GET /v1/read/readyz

Resumen: OpenAPI metadatos para la sonda de disponibilidad del daemon de lectura.

ID de operación: read_readyz_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
x-assetcore-namespaceencabezadoNamespaceIdAlcance del namespace para leer sondas de salud (requerido).

Respuestas

EstadoDescripciónEsquema
200Lectura de la sonda de disponibilidad del daemonReadReadyzResponse
401Solicitud no autorizadaProblemDetails
403Solicitud prohibidaProblemDetails
429Cuota excedidaProblemDetails
500Servicio no disponibleProblemDetails
503Lector no listoReadReadyzResponse

GET /v1/read/startupz

Resumen: OpenAPI metadatos para la prueba de inicio del daemon de lectura.

ID de operación: read_startupz_endpoint

Parámetros

NombreEnRequeridoTipoDescripción
x-assetcore-namespaceencabezadoNamespaceIdAlcance del namespace para leer sondas de salud (requerido).

Respuestas

EstadoDescripciónEsquema
200Lectura de la prueba de inicio del daemonProbeResponse
401Solicitud no autorizadaProblemDetails
403Solicitud prohibidaProblemDetails
429Cuota excedidaProblemDetails
500Servicio no disponibleProblemDetails