消息队列 Kafka版
消息队列 Kafka版
消息队列 Kafka版
文档指南
请输入
用户指南
实例管理
Kafka Agent
API 参考
V2（2022-05-01）
OpenAPIV2
网络管理
Topic 管理
Group 管理
SASL 用户管理
白名单管理
附录
V1（2018-01-01）
实例管理
Topic 管理
Group 管理
SDK 参考
Apache Kafka SDK
Java 客户端 SDK
Go 客户端 SDK
Python 客户端 SDK
Volcengine SDK
Volcengine Python SDK
Volcengine Java SDK
最佳实践
- 文档首页
消息队列 Kafka版API 参考V2（2022-05-01）OpenAPIV2ModifyInstanceAttributes - 修改实例基本信息
复制全文
下载 pdfModifyInstanceAttributes - 修改实例基本信息
文档反馈
问问助手调用 ModifyInstanceAttributes 接口修改对应实例名称、描述等实例信息。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：ModifyInstanceAttributes
要执行的操作，取值：ModifyInstanceAttributes。
Version string 必选 示例值：2022-05-01
API的版本，取值：2022-05-01。
InstanceName string 可选 示例值：myinstance
实例名称。
InstanceDescription string 可选 示例值：New instance
实例描述。
InstanceId string 必选 示例值：kafka-cnngqkfgdudt****
实例 ID。
返回参数
请求示例
POST /?Action=ModifyInstanceAttributes&Version=2022-05-01 HTTP/1.1
Content-Type: application/json
Host: kafka.volcengineapi.com
X-Date: 20210328T100802Z
Authorization: HMAC-SHA256 Credential=AK********/20210328/cn-beijing/Kafka/request, SignedHeaders=x-date, Signature=********
{
"InstanceId": "kafka-cnng5ysg5vv9****",
"InstanceName": "DTS-all",
"InstanceDescription": "DTS-all"
}
返回示例
{
"ResponseMetadata": {
"RequestId": "202302271847143C6FF96F30A58C7F0FE4",
"Action": "ModifyInstanceAttributes",
"Version": "2022-05-01",
"Service": "Kafka",
"Region": "cn-beijing"
},
"Result": null
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
状态码 | 错误码 | 错误信息 | 说明 |
400 | InvalidParameter | The specified parameter is not valid. | 参数值无效。 |
403 | OperationDenied.AccountNotAuthorized | You are not authorized to perform this operation. | 您不具备相关权限 ，请授权或切换账号后重试。 |
403 | OperationDenied.InvalidInstanceStatus | The operation is not valid for the current status of the instance. | 当前实例状态不允许执行该操作。 |
404 | InvalidInstanceId.NotFound | The specified Instance ID does not exist. | 实例不存在。 |
500 | InternalError | The request failed due to some unknown error, exception or failure. | 内部错误，请稍后重试。 |
最近更新时间：2025.08.08 17:47:27
这个页面对您有帮助吗？
有用
有用
无用
无用