移动静态实例到分组
覆盖原分组；groupId=0 移回未分组。实例和目标组必须全部属于当前账户，任一无效整批拒绝并回滚。仅变更本地分组，不修改上游代理资源。
只只HTTP技术团队维护更新于 2026年10月6日
接口与认证
PUT
/openapi/v1/static/instances/group覆盖原分组；groupId=0 移回未分组。实例和目标组必须全部属于当前账户，任一无效整批拒绝并回滚。仅变更本地分组，不修改上游代理资源。
使用 HTTPS 和账户 API 令牌。响应包含 Cache-Control: no-store 和 X-Request-Id。
示例为合成数据与占位凭据，仅说明结构。接口合同不代表目标环境已开放，开放状态以控制台为准。
下载 OpenAPI · 导入 Apifox / Postman请求参数
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
api_key | string | 是 | Query · 唯一非空 | 账户 API 令牌，在受控服务端保存；示例使用占位符。 |
请求示例 · application/json
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
instanceIds | integer[] | 是 | 最少项 1；最多项 100 | 本人实例 ID 数组，每次 1–100 项；任一实例无效则整批拒绝。 |
groupId | integer | 是 | 最小 0 | 必填目标分组 ID：0 移回未分组；正整数必须属于当前账户。 |
请求示例
curl --request PUT \
"https://api.zzhttp.com/openapi/v1/static/instances/group?api_key=${STATIC_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"instanceIds":[101],"groupId":12}'成功响应
成功
响应不包含代理密码，凭据仅由专用接口返回。
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
code | integer | 是 | 固定 200 | 统一数字业务码：HTTP 与业务码成功均为 200；异步受理不代表交付完成。 |
message | string | 是 | — | 服务端结果说明。 |
requestId | string | 是 | — | 本次请求的追踪 ID，用于排障，不是业务幂等编号。 |
data | object | 是 | — | 本接口业务数据。 |
data.updatedCount | integer | 是 | 最小 0 | 实际更新的去重实例数量。 |
{
"code": 200,
"message": "成功",
"requestId": "00000000-0000-4000-8000-000000000001",
"data": {
"updatedCount": 1
}
}错误与重试
读取请求遇到 429 按 Retry-After 等待；500/503 可有限重试。分组创建结果不明时先查询分组列表；移动同一目标可安全重试。
错误码、HTTP 状态、错误响应字段及恢复方式统一见错误码与处理建议。
这篇内容解决了你的问题吗？
反馈只用于改进公开文档，不会提交账号或请求信息。