通过自定义筛选条件批量查询 ArkClaw 实例详情。

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：ListClawInstances

要执行的操作，取值：ListClawInstances。

Version string 必选示例值：2026-05-01

API的版本，取值：2026-05-01。

InstanceIds.N string[] 可选示例值：InstanceIds.1=ci-yemjf738cgwr0****&InstanceIds.2=ci-yem8ac2vi8hxvx****

ArkClaw 实例 ID 列表。

参数 - N：表示实例 ID 的序号，取值范围：1～100。

多个实例 ID 之间用&分隔。

传入的无效 ID 将被忽略。

MaxResults integer 可选示例值：20

分页查询时设置的每页行数。

最小值：1。

最大值：100。

默认值：20。

若传入非法 MaxResults 值，会被自动调整为默认值。

NextToken string 可选示例值：Y2kteWVqMXJreTVma3F0YzM4e******

分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次 API 调用返回的 NextToken 参数值。

Recycled boolean 可选示例值：false

是否返回回收站列表，取值：

true：返回。

false（默认）：不返回。

SeatTypes.N string[] 可选示例值：SeatTypes.1=Starter&SeatTypes.2=Starter

ArkClaw 席位类型。

参数 - N：表示席位的序号，取值范围：1～4。

取值：

Starter：轻量版。

Standard：标准版。

Premium：高级版。

Ultimate：旗舰版。

SpaceId string 必选示例值：csi-yehw6ow1kwa5g0****

ArkClaw 实例所属空间 ID。可以在 ArkClaw 控制台“空间概览”页面的“基本信息”获取。

Status string 可选示例值：Running

ArkClaw 状态。取值：

Creating：创建中。

Running：运行中。

Upgrading：升级中。

Updating：更新中。

Stopping：关机中。

Starting：开机中。

Rebooting：重启中。

Resetting：重新初始化中。

Fixing：修复中。

Stopped：已关机。

Error：异常。

Resizing：变配中。

TagFilters.N.Key string[] 可选示例值：TagFilters.1.Key=k1&TagFilters.2.Key=k2

根据标签查询资源时指定的标签键。

N：表示标签序号，取值范围 1～10。

多个标签键之间用&分隔。

标签键不允许重复。

传入的无效标签键将被忽略。

TagFilters.N.Values.N string[] 可选示例值：TagFilters.1.Values.1=v1&TagFilters.1.Values.2=v2

根据标签查询资源时指定的标签值。

第一个 N 表示标签键序号，取值范围 1～10。

第二个 N 表示标签值序号，取值范围 1～3。

多个标签值之间用&分隔。

BillingType string 可选示例值：InstancePrePaid

计费方式。取值：

SeatPrePaid（默认）：席位预付费。

InstancePrePaid：实例预付费。

UserIds.N string[] 可选示例值：UserIds.1=baadc2dc-****&UserIds.2=9fc5ff57-****

用户 ID 列表。

参数 - N：表示用户 ID 的序号，取值范围：1～100。

多个用户 ID 之间用&分隔。

传入的无效 ID 将被忽略。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

Instances object[] 示例值：--

ArkClaw 实例列表。

UpdatedAt string 示例值：2026-01-01T11:02:08+08:00

ArkClaw 实例更新时间，时间格式为：RFC 3339。

ExpiredAt string 示例值：2026-04-21T10:00:00Z

实例计费到期时间，时间格式为：RFC 3339。

RecycledAt string 示例值：2026-01-01T11:02:08+08:00

ArkClaw 实例回收时间，时间格式为：RFC 3339。

SeatType string 示例值：Starter

ArkClaw 席位类型。

SpaceId string 示例值：csi-yei8347ta8xmf5****

ArkClaw 实例所属空间ID。

Status string 示例值：Running

ArkClaw 实例的状态。

InstanceName string 示例值：instance-001

ArkClaw 实例名称。

EnableHeadless boolean 示例值：false

是否启用 Headless 模式，取值：

true：启用。

false：不启用。

InstanceId string 示例值：ci-yemj8hrdvkwr0****

ArkClaw 实例的 ID。

UserId string 示例值：baadc2dc-****

用户ID。

Tags object[] 示例值："Tags": [ { "Key": "test", "Value": "1", "Type": "custom" } ],

ArkClaw 实例标签。

Key string 示例值：test

标签键。

Type string 示例值：custom

标签类型。

Value string 示例值：1

标签值。

BillingType string 示例值：InstancePrePaid

计费方式。取值：

SeatPrePaid：按席位预付费。

InstancePrePaid：按实例预付费。

CreatedAt string 示例值：2026-01-01T11:02:08+08:00

ArkClaw 实例的创建时间，时间格式为：RFC 3339。

Departments object[] 示例值：--

ArkClaw 实例所属用户的部门列表。

Name string 示例值：Frontend

部门名称。

NamePath string 示例值：/Engineering/Frontend

部门名称路径。

Path string 示例值：/root/fdeeba37-51e7-****/2479e108-1a5c-4311-****

部门 ID 路径，表示该部门在部门树中的层级位置（由各级部门 ID 拼接，包含 root）。

Uid string 示例值：2479e108-1a5c-4311-****

部门唯一标识 UID。

Description string 示例值：Claw for the Frontend department.

ArkClaw 实例描述。

NextToken string 示例值：KK70rgmr****

本次调用返回的查询凭证值，返回为空表示该页为末页。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	MissingParameter.SpaceId	The required parameter SpaceId is not supplied.	参数SpaceId不能为空。
400	InvalidUserId.Malformed	The specified UserId is malformed.	参数UserId不合法。
400	LimitExceeded.MaximumUserIds	The number of UserIds exceeds the maximum allowed limit.	UserIds 的数量超过了允许的最大限制。
400	LimitExceeded.MaximumInstanceIds	The number of specified InstanceIds exceeds the maximum limit.	InstanceIds数量超过最大限制。
400	InvalidSeatType.Malformed	The specified SeatType is malformed.	制定的 spec 无效。
400	InvalidStatus.Malformed	The specified Status is malformed.	指定的实例状态不合法。
400	LimitExceeded.MaxMaxResults	MaxResults exceeds the maximum limit.	MaxResults超过最大限制。
400	InvalidBillingType.Malformed	The specified BillingType is malformed. Valid values: SeatPrePaid, InstancePrePaid.	计费类型不合法，有效值：SeatPrePaid、InstancePrePaid。
400	LimitExceeded.MaximumTagFilterKeys	The number of tag filter keys exceeds the maximum limit.	标签键数量过多。
400	LimitExceeded.MaximumTagFilterValues	The number of tag filter values exceeds the maximum limit.	标签值数量过多。
404	InvalidSpace.NotFound	The specified Space does not exist.	指定ArkClaw空间不存在。
404	InvalidSpace.NotFound	The specified Space does not exist.	指定ArkClaw空间不存在。
409	InvalidTagFilterKey.Conflict	The specified TagFilterKey already exists.	指定的过滤标签键已存在。
429	FlowLimitExceeded	The request was rejected due to flow control.	请求触发限流。
500	InternalError	An internal error has occurred.	内部错误，请重试。如果多次尝试失败，请提交工单。

ArkClaw 企业版