Agent Runtime 修改运行中实例

注意：说明：

注意：运行中的实例支持原地调整 timeout 和补充 metadata。如果你需要更换模板、镜像、认证方式、挂载、资源规格、网络访问策略或自动暂停、自动恢复配置，请重新创建实例。

一、适用场景

·修改 timeout 只会影响实例的可用时长，不会改变 CPU、内存、磁盘、网络或挂载配置。

·更新 metadata 只会修改实例附带的键值信息，不会触发实例重建。

·环境变量的修改不在 agr instance update 的参数范围内，请参见 环境变量调整说明。

二、前提条件

·已安装 agr CLI，并已完成云端认证配置。

·已获取目标实例 ID。

·目标实例处于 RUNNING 状态。

·如果实例为 Persistent=true，不支持修改 timeout。

建议先执行以下命令，确认 CLI 可用且当前环境已完成认证：

agr versionagr status -o json –non-interactiveagr instance list –limit 1 -o json –non-interactive

预期结果如下：

·agr version 能返回 CLI 版本和 commit 信息。

·agr status -o json –non-interactive 返回 Status: succeeded。如果当前环境已完成云端认证，Data.Auth.SecretId.Present 和 Data.Auth.SecretKey.Present 都应为 true；否则请先完成 CLI 认证配置。

·agr instance list –limit 1 -o json –non-interactive 返回 Status: succeeded。如果当前账号下已有实例，返回体中的 Data.Items 会包含实例摘要。

三、查询实例当前状态

执行以下命令，确认实例处于运行中，并记录当前超时时间和 metadata：

agr instance get <instance-id> -o json –non-interactive

返回结果中确认以下关键字段：

·顶层 Status 为 succeeded。

·Data.InstanceId 与目标实例 ID 一致。

·Data.Status 为 RUNNING。

·Data.ToolId、Data.ToolName、Data.TimeoutSeconds、Data.ExpiresAt 和 Data.UpdateTime 等字段可正常返回。

示例输出：

{ "SchemaVersion": "agr.v1", "Command": "instance.get", "Status": "succeeded", "Data": { "InstanceId": "ins-7f3c2d1a9b6e4c5f", "Status": "RUNNING", "ToolId": "sdt-demo1234", "ToolName": "python-runner", "TimeoutSeconds": 1800, "ExpiresAt": "2026-05-23T15:30:00+08:00", "Metadata": { "owner": "alice", "purpose": "debug" }, "UpdateTime": "2026-05-23T15:00:12+08:00" }, "Failure": null, "Warnings": []}

四、修改实例超时时间

执行以下命令，调整运行中实例的 timeout：

agr instance update <instance-id> –timeout 30m -o json

使用 timeout 时请注意以下约束：

更新后，再次执行查询命令确认结果：

agr instance get <instance-id> -o json –non-interactive

确认以下字段已更新：

·Data.Status 仍为 RUNNING。

·Data.TimeoutSeconds 已更新为新的超时时长。

·对非 Persistent 实例，Data.ExpiresAt 晚于修改前的值。

如果新的 timeout 不符合预期，请再次写入期望值：

agr instance update <instance-id> –timeout 10m -o json

五、更新实例 metadata

如果你需要补充实例标签或业务备注，可以执行以下命令：

agr instance update <instance-id> \\ –metadata '[{"Name":"owner","Value":"alice"},{"Name":"purpose","Value":"debug"}]' \\ -o json

更新后，再次执行查询命令确认结果：

agr instance get <instance-id> -o json –non-interactive

确认以下字段已更新：

·Data.Status 仍为 RUNNING。

·Data.Metadata.owner 和 Data.Metadata.purpose 已显示为新值。

·Data.UpdateTime 晚于修改前的值。

如果你写入了错误的键值，请整理出目标实例需要保留的完整 metadata 列表后再次提交。agr instance update –metadata 会用本次请求中的 metadata 全量替换实例当前的 metadata。

六、环境变量调整说明

agr instance update 仅支持修改 timeout 和 metadata，不提供环境变量更新参数。

如果你的业务依赖环境变量变更，建议在创建实例时完成环境变量配置。如需修改已运行实例的环境变量，请通过对应兼容入口处理，并结合实例详情查询确认配置是否生效。具体入口、鉴权方式和请求格式请以相关兼容接口文档或平台正式发布说明为准。

七、相关操作

·启动 Sandbox Instance

·查询 Sandbox Instance

·停止与超时