全部產品
Search

搜尋本產品

    ApsaraMQ for RabbitMQ：UpdateInstance - 更新執行個體

    文件中心

    ApsaraMQ for RabbitMQ：UpdateInstance - 更新執行個體

    更新時間：Nov 11, 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 金鑰識別碼。 對密鑰有以下要求：

    • 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 InstanceUpgradeOrDownGradeTopicMigrating Data migration is in progress for an instance upgrade/downgrade. Please wait for completion.
    403 UnauthorizedOperation The request has failed due to unauthorized operation. 該請求未經授權。

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。