首页 ApsaraMQ for Kafka ApsaraMQ for Confluent Developer Reference API operations Instances UpgradePrePayOrder - Upgrade a subscription instance

UpgradePrePayOrder - Upgrade a subscription instance

更新时间: 2026-05-15 19:28:27

This operation upgrades the configuration of a subscription instance.

API

Before you call this operation, ensure that you understand the billing methods and pricing of subscription instances. For more information, see the billing overview.

Debugging

You can call this operation in OpenAPI Explorer to simplify testing. OpenAPI Explorer automatically calculates the signature and generates sample code for different SDKs after a successful call.

Authorization information

The following table lists the authorization information for this API operation. You can add this information to the Action element of a RAM policy statement to grant a RAM user or RAM role the permissions to call this API operation.

  • Operation: The API operation.

  • Access level: The operation's access level. Valid values: Write, Read, and List.

  • Resource type: The resource type for which you can grant permissions. The following provides more details:

    • Required resource types are highlighted.

    • For operations that do not support resource-level authorization, all resources is displayed.

  • Condition key: The condition keys that are defined by the cloud service.

  • Associated operation: Other operations that must be performed for this operation to succeed. To successfully call this operation, you must have the permissions to perform the associated operations.

Actions

Access level

Resource type

Condition key

Associated operation

alikafka:UpgradePrePayOrder

Write

all resources

*

  • alikafka:DeployModule

None

Request parameters

Parameter

Type

Required

Description

Example

InstanceId

string

Yes

The instance ID.

alikafka_post-cn-mp919o4v****

DiskSize

integer

Yes

The disk size.

  • The specified disk size must be greater than or equal to the current disk size of the instance.

  • For valid value ranges, see billing overview.

900

RegionId

string

Yes

The region ID.

cn-hangzhou

IoMax

integer

No

The maximum traffic. We recommend using the IoMaxSpec parameter instead.

  • The specified maximum traffic must be greater than or equal to the current maximum traffic of the instance.

  • You must specify either the IoMax or IoMaxSpec parameter. If you specify both parameters, the value of the IoMaxSpec parameter takes precedence. We recommend that you specify only the IoMaxSpec parameter.

  • For valid value ranges, see billing overview.

40

SpecType

string

No

The instance edition.

Valid values for ApsaraMQ for Kafka instances:

  • normal: Standard Edition (High Write)

  • professional: Professional Edition (High Write)

  • professionalForHighRead: Professional Edition (High Read)

Valid values for ApsaraMQ for Confluent instances:

  • professional: Professional Edition

  • enterprise: Enterprise Edition

You cannot downgrade an instance from Professional Edition to Standard Edition. For more information about these instance editions, see the billing overview.

professional

PartitionNum

integer

No

The partition count. This parameter is recommended over TopicQuota.

  • You must specify either the PartitionNum or TopicQuota parameter. We recommend that you specify only the PartitionNum parameter.

  • If you specify both the PartitionNum and TopicQuota parameters, the system verifies whether their values are equivalent based on the legacy topic-based sales model. If the values are not equivalent, the request fails. If the values are equivalent, the purchase is made based on the value of the PartitionNum parameter.

  • For valid value ranges, see billing overview.

50

TopicQuota

integer

No

The number of topics. We recommend using the PartitionNum parameter instead.

  • You must specify either the PartitionNum or TopicQuota parameter. We recommend that you specify only the PartitionNum parameter.

  • If you specify both the PartitionNum and TopicQuota parameters, the system verifies whether their values are equivalent based on the legacy topic-based sales model. If the values are not equivalent, the request fails. If the values are equivalent, the purchase is made based on the value of the PartitionNum parameter.

  • The default value varies based on the traffic specification. You are charged an additional fee if the specified value exceeds the default value.

  • For valid value ranges, see billing overview.

50

EipModel

boolean

No

Specifies whether to enable internet access. Valid values:

  • true: enables internet access.

  • false: disables internet access.

true

EipMax

integer

No

The internet traffic.

  • The specified internet traffic must be greater than or equal to the current internet traffic of the instance.

  • For valid value ranges, see billing overview.

Note
  • If EipModel is set to true, the value of EipMax must be greater than 0.

  • If EipModel is set to false, the value of EipMax must be 0.

3

IoMaxSpec

string

No

The traffic specification. This parameter is recommended.

  • The specified traffic specification must be greater than or equal to the current traffic specification of the instance.

  • You must specify either the IoMax or IoMaxSpec parameter. If you specify both parameters, the value of the IoMaxSpec parameter takes precedence. We recommend that you specify only the IoMaxSpec parameter.

  • For valid value ranges, see billing overview.

alikafka.hw.2xlarge

ConfluentConfig

object

No

The configurations of the Confluent components.

KafkaCU

integer

No

The number of Kafka broker CPU cores.

4

KafkaStorage

integer

No

The disk size of the Kafka broker in GB.

800

KafkaReplica

integer

No

The number of replicas for the Kafka broker.

3

ZooKeeperCU

integer

No

The number of ZooKeeper node CPU cores.

2

ZooKeeperStorage

integer

No

The disk size of the ZooKeeper node in GB.

100

ZooKeeperReplica

integer

No

The number of replicas for the ZooKeeper node.

3

ControlCenterCU

integer

No

The number of Control Center node CPU cores.

4

ControlCenterStorage

integer

No

The disk size of the Control Center node in GB.

300

ControlCenterReplica

integer

No

The number of replicas for the Control Center node.

1

SchemaRegistryCU

integer

No

The number of Schema Registry node CPU cores.

1

SchemaRegistryReplica

integer

No

The number of replicas for the Schema Registry node.

2

ConnectCU

integer

No

The number of Connect node CPU cores.

4

ConnectReplica

integer

No

The number of replicas for the Connect node.

2

KsqlCU

integer

No

The number of ksqlDB node CPU cores.

4

KsqlStorage

integer

No

The disk size of the ksqlDB node in GB.

100

KsqlReplica

integer

No

The number of replicas for the ksqlDB node.

2

KafkaRestProxyCU

integer

No

The number of Kafka REST proxy node CPU cores.

4

KafkaRestProxyReplica

integer

No

The number of replicas for the Kafka REST proxy node.

2

PaidType

integer

No

The billing method. Valid values:

  • 0: subscription

  • 4: subscription for ApsaraMQ for Confluent

4

Response parameters

Parameter

Type

Description

Example

object

Code

integer

The response code. A value of 200 indicates that the request was successful.

200

Message

string

The response message.

operation success.

RequestId

string

The request ID.

ABA4A7FD-E10F-45C7-9774-A5236015***

Success

boolean

Indicates whether the request was successful.

true

Examples

Sample success response

JSON format

{
  "Code": 200,
  "Message": "operation success.",
  "RequestId": "ABA4A7FD-E10F-45C7-9774-A5236015***",
  "Success": true,
  "OrderId": ""
}

Error codes

For a list of common errors, see Common error codes.

Change history

Date

Change

Actions

2024-08-22

API description and error codes updated.

View change details

2024-08-02

Error codes and response structure updated.

View change details

2024-04-16

Error codes updated.

View change details

2024-04-11

Error codes updated.

View change details

2024-03-20

Error codes updated.

View change details

2024-02-27

Error codes and request parameters updated.

View change details

2022-08-31

Error codes updated.

View change details

上一篇: GetAllInstanceIdList 下一篇: Tags
阿里云首页 云消息队列 Kafka 版 相关技术圈