一、前提条件
·已具备可执行 agr 命令的环境。
·已获取目标弹性部署的 ID，下文使用 ${DEPLOYMENT_ID} 表示。
·已确定目标弹性部署所在地域，下文使用 ${AGR_REGION} 表示。
·执行修改或删除前，请确认目标弹性部署的当前状态。
二、查询单个弹性部署
1. 执行以下命令查询单个弹性部署：
agr deployment get "${DEPLOYMENT_ID}" –region "${AGR_REGION}"
2. 如需结构化输出，可追加 -o json：
agr deployment get "${DEPLOYMENT_ID}" \\ –region "${AGR_REGION}" \\ -o json
三、列出弹性部署并过滤
1. 执行以下命令列出当前地域的弹性部署：
agr deployment list –region "${AGR_REGION}"
2. 如需按条件过滤，使用 –filters：
agr deployment list \\ –region "${AGR_REGION}" \\ –filters '[ { "Name": "tool-id", "Values": [ "sdt-a1b2c3d4" ] }, { "Name": "status", "Values": [ "ACTIVE" ] } ]'
3. –filters 支持的过滤项如下表所示。
| 过滤项 | 说明 |
| deployment-id | 按弹性部署 ID 过滤 |
| deployment-name | 按弹性部署名称过滤 |
| deployment-name-like | 按弹性部署名称模糊匹配过滤 |
| tool-id | 按沙箱工具 ID 过滤 |
| status | 按状态过滤，支持 ACTIVE、DELETING、DELETE_FAILED |
| tag-key | 按标签键过滤 |
| tag-value | 按标签值过滤 |
| tag:<key> | 按指定标签键的值过滤 |
多个过滤项之间为 AND 关系，同一过滤项内的多个 Values 为 OR 关系。实例数、请求量、并发、错误和延迟属于监控数据，不包含在查询结果中。
四、替换扩缩容与生命周期配置
1. 执行以下命令：
agr deployment update "${DEPLOYMENT_ID}" \\ –region "${AGR_REGION}" \\ –scaling-configuration '{ "MinInstanceCount": 1, "MaxInstanceCount": 20, "MaxInstanceRequestConcurrency": 100 }' \\ –lifecycle-configuration '{ "IdleTimeoutSeconds": 600, "IdleAction": "STOP" }'
2. 扩缩容配置和生命周期配置中，每个提供的对象都会完整替换对应配置。
五、更新标签
1. 使用非空数组全量替换标签：
agr deployment update "${DEPLOYMENT_ID}" \\ –region "${AGR_REGION}" \\ –tags '[ { "Key": "env", "Value": "production" } ]'
2. 使用空数组清空全部标签：
agr deployment update "${DEPLOYMENT_ID}" \\ –region "${AGR_REGION}" \\ –tags '[]'
3. –tags 的取值语义如下表所示。
| 取值 | 行为 |
| 省略 | 标签保持不变 |
| [] | 清空全部标签 |
| 非空数组 | 全量替换为数组中的标签 |
DeploymentName、ToolId、AffinityConfiguration 不可修改。修改命令返回成功仅表示配置已保存，运行态会异步收敛。
六、删除弹性部署
注意：警告：
注意：弹性部署删除后不可恢复，且会处理所有受管沙箱实例，请在确认不再需要后执行。
七、发起删除
1. 执行默认删除命令，命令在服务端接受请求后返回：
agr deployment delete "${DEPLOYMENT_ID}" –region "${AGR_REGION}"
2. 如需等待资源真正消失，可追加 –wait：
agr deployment delete "${DEPLOYMENT_ID}" \\ –region "${AGR_REGION}" \\ –wait
3. –wait 会轮询直到资源消失；删除失败时返回 StatusReason。
八、删除行为说明
·进入 DELETING 状态后，弹性部署会拒绝新请求并停止签发 Token。
·首次执行删除只表示删除流程已可靠开始，不代表删除已经完成。
·在 DELETING 状态下，非并发的重复删除会幂等成功。
·DELETE_FAILED 不会自动重试，需要再次执行删除命令。
·删除会处理所有受管沙箱实例，并固定使用进入 DELETING 状态时的 IdleAction。
| IdleAction | 删除时的处理 |
| STOP | 释放沙箱实例。 |
| PAUSE | 保留已暂停的沙箱实例，用户可通过标准沙箱实例 API 管理。 |
软删除完成后，弹性部署会从查询结果和列表中消失，名称同时释放。删除不可恢复，同名重建会获得新的 ID。
九、结果验证
·查询成功：get 返回目标弹性部署的信息；list 返回符合条件的弹性部署列表。
·修改成功：命令返回成功，表示配置已保存；运行态异步收敛后，可通过 get 查看最新配置。
·删除成功：默认命令返回表示服务端已接受请求；使用 –wait 时，命令返回表示资源已消失，若为 DELETE_FAILED 会返回 StatusReason，需再次删除。
十、相关操作
·查询单个弹性部署：执行 agr deployment get "${DEPLOYMENT_ID}" –region "${AGR_REGION}"。
·按条件查询弹性部署：执行 agr deployment list –region "${AGR_REGION}"，过滤项参见 列出弹性部署并过滤。