全部产品
Search

搜索本产品

    云消息队列 RabbitMQ 版：UpdateInstance - 更新实例

    文档中心

    云消息队列 RabbitMQ 版：UpdateInstance - 更新实例

    更新时间：Dec 25, 2025

    更新云消息队列RabbitMQ的实例，升降配规格。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    amqp:UpdateInstance

    update

    *Instance

    acs:amqp:{#regionId}:{#accountId}:/instances/{#instanceId}
    • amqp:InstanceType
    • amqp:SupportEIP
    • amqp:ServerlessChargeType
    		 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    ClientToken

    string

    否

    客户端 Token。

    c2c5d1274axxxxxxxx
    InstanceId

    string

    是

    云消息队列 RabbitMQ 版实例的 ID。

    amqp-cn-jtexxxxx
    ModifyType

    string

    是

    变配类型，取值如下：

    • UPGRADE：升配

    • DOWNGRADE：降配

    UPGRADE
    InstanceType

    string

    否

    实例规格类型， 预付费类型的取值如下：

    • professional：专业版

    • enterprise：企业版

    • vip：铂金版

    后付费实例：无需填写

    professional
    ServerlessChargeType

    string

    否

    后付费（即 Serverless）实例的计费类型，取值如下：

    • onDemand：按量累计

    onDemand
    MaxPrivateTps

    integer

    否

    私网 TPS 流量，单位：次/秒

    1000
    SupportEip

    boolean

    否

    是否支持公网

    false
    MaxEipTps

    integer

    否

    公网 TPS 流量峰值，单位：次/秒

    128
    QueueCapacity

    integer

    否

    配置 Queue 的数量上限

    1000
    MaxConnections

    integer

    否

    最大连接数

    1000
    StorageSize

    integer

    否

    配置消息存储空间

    7
    SupportTracing

    boolean

    否

    是否开通消息轨迹功能

    false
    TracingStorageTime

    integer

    否

    配置消息轨迹的保存时长

    3
    EncryptedInstance

    boolean

    否

    独享实例专属功能。实例是否开通数据存储加密功能。

    • 独享实例 EncryptedInstance、KmsKeyId 属性不能更改（包括变配成非加密；降级成共享加密；降级成共享非加密）；即独享实例使用 UpdateInstance 升/降级配置时，不允许携带 EncryptedInstance、KmsKeyId 参数；

    • EncryptedInstance 的 EncryptedInstance、KmsKeyId 参数，运用场景是，共享实例升级成加密独享实例。

    false
    KmsKeyId

    string

    否

    独享实例专属功能，当 EncryptedInstance 为 true 时需要填写此字段。 数据加密存储使用的 KMS 密钥 ID。 对密钥有以下要求：

    • KMS 密钥实例须要与 RabbitMQ 实例在同一个地域；

    • 不能是服务密钥；

    • 密钥状态必须是开启的；

    • 必须是对称密钥，不能是非对称密钥；

    • 密钥用途必须是加解密；

    • KMS 密钥过期/删除后，数据读写不可用，RabbitMQ 实例异常；

    key-bjj66c2a893vmhawtq5fd
    ProvisionedCapacity

    integer

    否

    预留+弹性实例的预留 TPS 容量。

    2000
    Edition

    string

    否

    Serverless 实例部署架构，取值如下：

    • shared：共享架构，适用预留+弹性（共享）以及按量付费版本。

    • dedicated：独享架构，适用预留+弹性（独享）版本。

    shared

    返回参数

    名称

    类型

    描述

    示例值

    object

    Schema of Response

    RequestId

    string

    公共参数，每个请求的 ID 都是唯一的，可用于排查和定位问题。

    628705FD-03EE-4ABE-BB21-E1672960***
    Code

    integer

    返回码。返回 200 代表成功。

    200
    Message

    string

    返回信息。

    InstanceNotExist
    Data

    any

    返回数据，涵盖 orderId 和 instanceId。例如

    "Data": {
    "instanceId": "amqp-cn-xxxxx",
    "orderId": 22222
  }

    {'instanceId': 'rabbitmq-serverless-cn-lf63qsjlf06', 'orderId': 234170302080010}
    Success

    string

    请求是否成功。

    true
    StatusCode

    string

    状态码。

    200

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "628705FD-03EE-4ABE-BB21-E1672960***",
  "Code": 200,
  "Message": "InstanceNotExist",
  "Data": "{'instanceId': 'rabbitmq-serverless-cn-lf63qsjlf06', 'orderId': 234170302080010}",
  "Success": "true",
  "StatusCode": "200"
}

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    400 INSUFFICIENT_AVAILABLE_QUOTA Your account available limit is less than 0, please recharge before trying to purchase. 您的账户可用额度小于0，请先充值后再尝试购买。
    400 UpDowngradeConfigNoChange The upgrade or downgrade configuration is not changed. 升级或降配的配置未改变，请重新选择
    403 UnauthorizedOperation The request has failed due to unauthorized operation. 该请求未经授权。

    访问错误中心查看更多错误码。

    变更历史

    更多信息，参考变更详情。