APIKeyInfo
API密钥简略信息
被如下接口引用：DescribeAPIKeyList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 否 | API密钥名称 示例值：LocalDev |
| KeyId | String | 否 | API密钥ID 示例值：ark-3edcft6y |
| Status | String | 否 | 密钥状态。可以为API_KEY_STATUS_ACTIVE，或API_KEY_STATUS_INACTIVE 示例值：API_KEY_STATUS_ACTIVE |
| MaskedKey | String | 否 | 隐藏部分字符的API密钥，方便用户辨认 示例值：ark_g9****ztdA |
| CreatedAt | String | 否 | API密钥创建时间 示例值：2025-09-12T09:00:03.094Z |
Filter
过滤列表规则
被如下接口引用：DescribeSandboxInstanceList, DescribeSandboxToolList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 否 | 属性名称, 若存在多个Filter时，Filter间的关系为逻辑与（AND）关系。 示例值：FILTER_KEY_NAME |
| Values | Array of String | 否 | 属性值, 若同一个Filter存在多个Values，同一Filter下Values间的关系为逻辑或（OR）关系。 示例值：["LocalDev"] |
NetworkConfiguration
沙箱网络配置
被如下接口引用：CreateSandboxTool, DescribeSandboxToolList, UpdateSandboxTool。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| NetworkMode | String | 是 | 网络模式（当前支持 PUBLIC） 示例值：PUBLIC |
SandboxInstance
沙箱实例结构体
被如下接口引用：DescribeSandboxInstanceList, StartSandboxInstance。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| InstanceId | String | 是 | 沙箱实例唯一标识符 示例值：sdi-xyz789abc123 |
| ToolId | String | 是 | 所属沙箱工具 ID 示例值：sdt-def456ghi789 |
| ToolName | String | 是 | 所属沙箱工具名称 示例值：code-interpreter-v1 |
| Status | String | 是 | 实例状态：STARTING（启动中）、RUNNING（运行中）、STOPPING（停止中）、STOPPED（已停止）、STOP_FAILED（停止失败）、FAILED（失败状态） 示例值：RUNNING |
| TimeoutSeconds | Integer | 否 | 超时时间（秒），null 表示无超时设置 示例值：600 |
| ExpiresAt | String | 否 | 过期时间（ISO 8601 格式），null 表示无过期时间 示例值：2024-01-01T10:30:00Z |
| StopReason | String | 否 | 停止原因：manual（手动）、timeout（超时）、error（错误）、system（系统），仅在状态为 STOPPED、STOP_FAILED 或 FAILED 时有值。当 provider 停止失败时，状态为 STOP_FAILED，原因为 error 示例值：timeout |
| CreateTime | String | 否 | 创建时间（ISO 8601 格式） 示例值：2024-01-01T10:00:00Z |
| UpdateTime | String | 否 | 更新时间（ISO 8601 格式） 示例值：2024-01-01T10:10:00Z |
SandboxTool
沙箱工具结构体
被如下接口引用：DescribeSandboxToolList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ToolId | String | 是 | 沙箱工具唯一标识符 示例值：sdt-ee4ywozw |
| ToolName | String | 否 | 沙箱工具名称，长度 1-50 字符，支持中英文、数字、下划线。同一 AppId 下沙箱工具名称必须唯一 示例值：browser-sandbox |
| ToolType | String | 否 | 沙箱工具类型，取值：browser（浏览器工具）、code-interpreter（代码解释器工具）、computer（计算机控制工具）、mobile（移动设备工具） 示例值：browser |
| Status | String | 否 | 沙箱工具状态，取值：CREATING（创建中）、ACTIVE（可用）、DELETING（删除中）、FAILED（失败） 示例值：ACTIVE |
| Description | String | 否 | 沙箱工具描述信息，最大长度 200 字符 示例值：浏览器沙箱环境 |
| DefaultTimeoutSeconds | Integer | 否 | 默认超时时间，支持格式：5m、300s、1h 等，不指定则使用系统默认值（5 分钟）。最大 24 小时 示例值：600 |
| NetworkConfiguration | NetworkConfiguration | 否 | 网络配置 |
| Tags | Array of Tag | 否 | 标签规格，包含资源标签绑定关系。用于为沙箱工具绑定标签，支持多种资源类型的标签绑定 |
| CreateTime | String | 否 | 沙箱工具创建时间，格式：ISO8601 示例值：2024-01-15T10:30:00Z |
| UpdateTime | String | 否 | 沙箱工具更新时间，格式：ISO8601 示例值：2024-01-15T10:30:00Z |
Tag
标签
被如下接口引用：CreateSandboxTool, DescribeSandboxToolList, UpdateSandboxTool。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Key | String | 否 | 标签键 示例值：business |
| Value | String | 否 | 标签值 示例值：biz1 |
