获取 ArkClaw 实例详情。

请求参数

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

Action string 必选示例值：GetClawInstance

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

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

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

InstanceId string 必选示例值：ci-yenklf05q8a9xf1s****

ArkClaw 实例 ID。查询实例 ID 的方式请参见 ListClawInstances。

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

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

返回参数

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

Instance object 示例值：--

ArkClaw 实例结构体。

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

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

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

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

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

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

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

ArkClaw 实例描述。

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

ArkClaw 实例 ID。

InstanceName string 示例值：instance-001

ArkClaw 实例名称。

ModelName string 示例值：doubao-seed-2-0-lite-260215

ArkClaw 模型名称。

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

ArkClaw 实例所属空间 ID。

Status string 示例值：Running

ArkClaw 状态。取值：

Creating：创建中。

Running：运行中。

Upgrading：升级中。

Updating：更新中。

Stopping：关机中。

Starting：开机中。

Rebooting：重启中。

Resetting：重新初始化中。

Fixing：修复中。

Stopped：已关机。

Error：异常。

Resizing：变配中。

UserId string 示例值：22e122d8-f804-4a86-999f-ddd1a****

用户 ID。

ModelSource string 示例值：ModelSquare

ArkClaw 模型来源。取值：

CodingPlan：来源于 CodingPlan。

ModelSquare：来源于模型广场。

Customer：来源于用户自定义。

SeatType string 示例值：Starter

ArkClaw 席位类型，取值：

Starter：轻量版。

Standard：标准版。

Premium：高级版。

Ultimate：旗舰版。

BillingType string 示例值：InstancePrePaid

计费方式。取值：

SeatPrePaid：按席位预付费。

InstancePrePaid：按实例预付费。

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

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

EnableHeadless boolean 示例值：false

是否启用 Headless 模式。取值：

true：启用。

false：不启用。

Tags object[] 示例值：--

ArkClaw 实例标签。

Key string 示例值：tag

标签键。

Type string 示例值：custom

标签类型。取值：

custom：自定义标签。

system：系统标签。

Value string 示例值：production

标签值。

AgentPlanSeatIds string[] 示例值：["seat-xxxxxxx"]

该实例归属用户持有的 AgentPlan 方舟坐席 ID 列表，坐席 ID 以seat-为前缀。

说明

当实例按席位计费，且归属用户持有 AgentPlan 坐席时返回该列表，否则返回空数组。

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	MissingParameter.InstanceId	The required parameter InstanceId is not supplied.	参数InstanceId不能为空。
400	MissingParameter.InstanceId	The required parameter InstanceId is not supplied.	参数InstanceId不能为空。
400	MissingParameter.SpaceId	The required parameter SpaceId is not supplied.	参数SpaceId不能为空。
404	InvalidSpace.NotFound	The specified Space does not exist.	指定ArkClaw空间不存在。
404	InvalidInstance.NotFound	The specified Instance does not exist.	指定ArkClaw实例不存在。
429	FlowLimitExceeded	The request was rejected due to flow control.	请求触发限流。
500	InternalError	An internal error has occurred.	内部错误，请重试。如果多次尝试失败，请提交工单。

ArkClaw 企业版