查询实例历史

分页查询活动或历史实例,用于清理门禁、成本核对和故障排查。

Authentication

XAPI-Keystring

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

Query parameters

stateenumOptionalDefaults to ALL

状态范围。ALL=全部;ACTIVE=尚未终止的实例;HISTORY=TERMINATED/FAILED; 其余值只返回对应 observedState。

searchstringOptional<=160 characters

按实例 ID、幂等键、offering 名称或供应商名称进行文本检索。

providerstringOptional<=160 characters

按供应商名称或服务标识过滤历史记录。

fromdatetimeOptional

创建时间下界,ISO 8601 日期时间,包含边界。

todatetimeOptional

创建时间上界,ISO 8601 日期时间,包含边界。

pageintegerOptional>=1Defaults to 1

从 1 开始的页码。

pageSizeintegerOptional1-100Defaults to 100

每页记录数,范围 1–100。

Response

历史分页结果

itemslist of objects

当前页实例记录,结构与 Sandbox 详情相同,但部分嵌套审计字段可能省略或裁剪。

totalinteger

符合当前筛选条件的实例总数,不只是当前页数量。

pageinteger

当前页码,从 1 开始。

pageSizeinteger

本次请求采用的每页最大记录数。

totalPagesinteger

按 total 和 pageSize 计算的总页数。

stateCountsmap from strings to integers

同一过滤条件下按 observedState 汇总的实例数量,用于检查 ACTIVE/终态分布。