estat_escenari
Obteniu una instantània de lectura només i un resum segur sense canviar l’estat.
Notes clau
- S’utilitza per a enquestes o estat de la interfície d’usuari; no avalua portes.
- Els resums segurs ometen els valors d’evidència i poden incloure pistes de reintents.
- Retorna els IDs de paquet emesos per ajudar a rastrejar les divulgacions.
Inputs
- request (required): Càrrega útil de la sol·licitud d’estat.
- scenario_id (required): Identificador de l’escenari.
Input Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"request": {
"additionalProperties": false,
"description": "Status request payload.",
"properties": {
"correlation_id": {
"oneOf": [
{
"type": "null"
},
{
"description": "Correlation identifier.",
"type": "string"
}
]
},
"namespace_id": {
"description": "Namespace identifier.",
"minimum": 1,
"type": "integer"
},
"requested_at": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "unix_millis"
},
"value": {
"type": "integer"
}
},
"required": [
"kind",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "logical"
},
"value": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"kind",
"value"
],
"type": "object"
}
]
},
"run_id": {
"description": "Run identifier.",
"type": "string"
},
"tenant_id": {
"description": "Tenant identifier.",
"minimum": 1,
"type": "integer"
}
},
"required": [
"tenant_id",
"namespace_id",
"run_id",
"requested_at"
],
"type": "object"
},
"scenario_id": {
"description": "Scenario identifier.",
"type": "string"
}
},
"required": [
"scenario_id",
"request"
],
"type": "object"
}
Sortides
- current_stage_id (required): Identificador de l’etapa actual.
- issued_packet_ids (required): Tipus: array.
last_decision(requerit): Una de les 2 variants d’esquema.- namespace_id (opcional): Identificador de l’espai de noms.
- run_id (requerit): Identificador de la execució.
safe_summary(requerit): Una de les 2 variants d’esquema.- scenario_id (required): Identificador de l’escenari.
- status (requerit): Tipus: string.
Esquema de sortida
{
"additionalProperties": false,
"properties": {
"current_stage_id": {
"description": "Current stage identifier.",
"type": "string"
},
"issued_packet_ids": {
"items": {
"description": "Packet identifier.",
"type": "string"
},
"type": "array"
},
"last_decision": {
"oneOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"properties": {
"correlation_id": {
"oneOf": [
{
"type": "null"
},
{
"description": "Correlation identifier.",
"type": "string"
}
]
},
"decided_at": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "unix_millis"
},
"value": {
"type": "integer"
}
},
"required": [
"kind",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "logical"
},
"value": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"kind",
"value"
],
"type": "object"
}
]
},
"decision_id": {
"description": "Decision identifier.",
"type": "string"
},
"outcome": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "start"
},
"stage_id": {
"description": "Initial stage identifier.",
"type": "string"
}
},
"required": [
"kind",
"stage_id"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "complete"
},
"stage_id": {
"description": "Terminal stage identifier.",
"type": "string"
}
},
"required": [
"kind",
"stage_id"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"from_stage": {
"description": "Previous stage identifier.",
"type": "string"
},
"kind": {
"const": "advance"
},
"timeout": {
"type": "boolean"
},
"to_stage": {
"description": "Next stage identifier.",
"type": "string"
}
},
"required": [
"kind",
"from_stage",
"to_stage",
"timeout"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "hold"
},
"summary": {
"additionalProperties": false,
"properties": {
"policy_tags": {
"description": "Policy tags applied to the summary.",
"items": {
"type": "string"
},
"type": "array"
},
"retry_hint": {
"oneOf": [
{
"type": "null"
},
{
"description": "Optional retry hint.",
"type": "string"
}
]
},
"status": {
"description": "Summary status.",
"type": "string"
},
"unmet_gates": {
"items": {
"description": "Gate identifier.",
"type": "string"
},
"type": "array"
}
},
"required": [
"status",
"unmet_gates",
"retry_hint",
"policy_tags"
],
"type": "object"
}
},
"required": [
"kind",
"summary"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "fail"
},
"reason": {
"description": "Failure reason.",
"type": "string"
}
},
"required": [
"kind",
"reason"
],
"type": "object"
}
]
},
"seq": {
"minimum": 0,
"type": "integer"
},
"stage_id": {
"description": "Stage identifier.",
"type": "string"
},
"trigger_id": {
"description": "Trigger identifier.",
"type": "string"
}
},
"required": [
"decision_id",
"seq",
"trigger_id",
"stage_id",
"decided_at",
"outcome",
"correlation_id"
],
"type": "object"
}
]
},
"namespace_id": {
"description": "Namespace identifier.",
"minimum": 1,
"type": "integer"
},
"run_id": {
"description": "Run identifier.",
"type": "string"
},
"safe_summary": {
"oneOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"properties": {
"policy_tags": {
"description": "Policy tags applied to the summary.",
"items": {
"type": "string"
},
"type": "array"
},
"retry_hint": {
"oneOf": [
{
"type": "null"
},
{
"description": "Optional retry hint.",
"type": "string"
}
]
},
"status": {
"description": "Summary status.",
"type": "string"
},
"unmet_gates": {
"items": {
"description": "Gate identifier.",
"type": "string"
},
"type": "array"
}
},
"required": [
"status",
"unmet_gates",
"retry_hint",
"policy_tags"
],
"type": "object"
}
]
},
"scenario_id": {
"description": "Scenario identifier.",
"type": "string"
},
"status": {
"enum": [
"active",
"completed",
"failed"
],
"type": "string"
}
},
"required": [
"run_id",
"scenario_id",
"current_stage_id",
"status",
"last_decision",
"issued_packet_ids",
"safe_summary"
],
"type": "object"
}
Exemples
Estat de l’execució de la consulta sense avançar l’execució.
Input:
{
"request": {
"correlation_id": null,
"namespace_id": 1,
"requested_at": {
"kind": "unix_millis",
"value": 1710000000000
},
"run_id": "run-0001",
"tenant_id": 1
},
"scenario_id": "example-scenario"
}
Output:
{
"current_stage_id": "main",
"issued_packet_ids": [],
"last_decision": null,
"run_id": "run-0001",
"safe_summary": null,
"scenario_id": "example-scenario",
"status": "active"
}