列出账户实例快照

返回当前账户拥有的全部 Sandbox 快照,包括活动实例和 TERMINATED / FAILED 终态记录。该接口没有分页或状态过滤,适合快速定位已知实例,但返回非空不表示仍有 资源在运行。清理门禁请调用 GET /v1/sandbox-history?state=ACTIVE,并确认结果中 不包含本次实例。

Authentication

XAPI-Keystring

在 xAPI Console 创建的 API Key。只会发送给 *.xapi.to。

Response

账户全部实例快照(包含终态记录)

idstringformat: "uuid"

实例 UUID;所有查询、执行、文件、端口、审计和清理接口都使用此值。

offeringIdstringformat: "uuid"

实际选中的 offering UUID;即使按 requirements 创建也会返回具体值。

observedStateenum

Gateway 最近确认的供应商实际状态;判断是否可执行、是否已清理应以此字段为准。

totalCoststring

服务端已结算账期的累计实际费用(USD 十进制字符串);不要用本地墙钟时间自行替代。

createdAtdatetime

Gateway 创建实例记录并开始供应的时间。

updatedAtdatetime

实例记录最近一次状态、费用或审计摘要更新的时间。

idempotencyKeystringOptional

创建实例时使用的业务幂等键,可用于历史检索和重复创建核对。

desiredStateenum or nullOptional

最近一次生命周期操作希望达到的目标状态;没有进行中的状态目标时可能为 null。

lifecyclePhaseenumOptional

由 desiredState 与 observedState 推导的用户可读阶段,可区分 SUSPENDING/RESUMING/TERMINATING 过渡过程。

lastConfirmedStateenumOptional

最近一次有供应商或可靠事件证据确认的状态;observedState=UNKNOWN 时可用于故障排查,不能替代最新状态。

stateVersionintegerOptional

每次有效状态变化递增的版本号,用于检测状态是否更新和防止乱序覆盖。

policyobjectOptional

创建时生效的实例生命周期策略。

resourcesobjectOptional

创建时冻结的实际资源快照,用于执行能力和费用核对。

reservedUntildatetime or nullOptional

当前滚动费用预留覆盖到的时间;不是实例保证存活时间,也不是自动终止时间。

terminatedAtdatetime or nullOptional

实例首次确认进入 TERMINATED 的时间;尚未终止时为 null。

offeringobjectOptional

选中 offering 的完整快照;部分列表响应可能省略。

operationslist of objectsOptional

最近的操作审计摘要;完整记录使用 audit?kind=operations 分页读取。

eventslist of objectsOptional

最近的状态事件;完整记录使用 audit?kind=events。

usageSegmentslist of objectsOptional

最近的用量段;终态验收时所有段应有 endsAt 且不处于 OPEN。

billingPeriodslist of objectsOptional

已返回的账期与结算明细;totalCost 应与 SETTLED 账期金额汇总一致。

auditCountsobjectOptional

四类完整审计记录总数。

autoResumebooleanOptionalDeprecated

兼容旧客户端的字段;新客户端使用 policy.resumeOnAccess。

Errors

401
Unauthorized Error