# 修改静态实例凭据

批量随机或指定账密，读取逐项执行结果。

所有路径均使用[统一 API 令牌认证](/developers/authentication/static-hmac)。响应封装、业务编号和通用错误处理见[静态 API 概览](/developers/api/static-supply)。接口合同不代表目标环境已开放或完成真实供应商验收。

## 请求

`POST /openapi/v1/static/instances/update-credentials`

随机模式示例：

```json
{"clientOperationNo":"platform-password-001","instanceIds":[123],"randomize":true}
```

指定模式使用 `randomize: false`，另传 `username`、`password`。两种模式不可混用。实例 ID 为 1–100 个正整数，业务号为 1–64 位字母、数字、`_`、`.`、`-`。

## 返回

HTTP 200 返回 `data.operationId`、`status` 和 `items[]`。请求内最多以 25 秒预算执行，HTTP 200 **不代表所有实例均成功**；逐项状态确认后再读取新凭据。改密不发送结果通知。

## 错误与重试

同实例有未完成操作或同号异参返回 `10705`。超时、500/503 或结果暂不可确认时，按原 `clientOperationNo` 查询或原参数重试，勿新建随机改密号。未提交上游且安全终止的项会显示 `CREDENTIAL_UPDATE_NOT_SUBMITTED`，只可为这些失败项创建新业务号。

html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}