Scales up a Message Queue for Apache Kafka instance that uses the subscription billing method.

Before you call this operation, make sure that you have understood the billing items and pricing of a Message Queue for Apache Kafka instance that uses the subscription billing method. For more information, see Billing.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes UpgradePrePayOrder

The operation that you want to perform. Set the value to

UpgradePrePayOrder.

DiskSize Integer Yes 900

The disk size of the instance.

  • The disk size that you specify must be greater than or equal to the current disk size of the instance.
  • For more information about the valid values, see Billing.
InstanceId String Yes alikafka_post-cn-mp919o4v****

The ID of the instance.

RegionId String Yes cn-hangzhou

The ID of the region in which the instance is deployed.

TopicQuota Integer Yes 50

The topic quota of the instance.

  • The topic quota that you specify must be greater than or equal to the current topic quota of the instance.
  • The default value of the TopicQuota parameter varies based on the IoMaxSpec value. If the number of topics that you consume exceeds the default value, you are charged for additional fees.
  • For more information about the valid values, see Billing.
IoMax Integer No 40

The maximum business traffic. We recommend that you do not specify this parameter.

  • The maximum business traffic that you specify must be greater than or equal to the current maximum business traffic of the instance.
  • You must specify at least one of the IoMax and IoMaxSpec parameters. If you specify IoMax and IoMaxSpec at the same time, the IoMaxSpec value prevails. We recommend that you specify only the IoMaxSpec parameter.
  • For more information about the valid values, see Billing.
SpecType String No professional

The edition of the instance. Valid values:

  • normal: Standard Edition (High Write)
  • professional: Professional Edition (High Write)
  • professionalForHighRead: Professional Edition (High Read)

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

EipModel Boolean No true

Specifies whether to enable Internet access for the instance. Valid values:

  • true: enables Internet access.
  • false: disables Internet access.
EipMax Integer No 3

The public bandwidth of the instance.

  • The public bandwidth that you specify must be greater than or equal to the current public bandwidth of the instance.
  • For more information about the valid values, see Billing.
Note
  • If EipModel is set to true, set EipMax to a value that is greater than 0.
  • If EipModel is set to false, set EipMax to 0.
IoMaxSpec String No alikafka.hw.2xlarge

The traffic specification of the instance. We recommend that you specify this parameter.

  • The traffic specification that you specify must be greater than or equal to the current traffic specification of the instance.
  • You must specify at least one of the IoMax and IoMaxSpec parameters. If you specify IoMax and IoMaxSpec at the same time, the IoMaxSpec value prevails. We recommend that you specify only the IoMaxSpec parameter.
  • For more information about the valid values, see Billing.

Response parameters

Parameter Type Example Description
Code Integer 200

The HTTP status code. The HTTP status code 200 indicates that the request is successful.

Message String operation success.

The returned message.

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

The ID of the request.

Success Boolean true

Indicates whether the request is successful.

Examples

Sample requests

http(s)://alikafka.cn-hangzhou.aliyuncs.com/?Action=UpgradePrePayOrder
&RegionId=cn-hangzhou
&TopicQuota=50
&DiskSize=900
&InstanceId=alikafka_post-cn-mp919o4v****
&IoMax=40
&SpecType=professional
&EipModel=true
&EipMax=300
&IoMaxSpec=alikafka.hw.2xlarge
&<Common request parameters>

Sample success responses

XML format

<UpgradePrePayOrderResponse>
      <RequestId>ABA4A7FD-E10F-45C7-9774-A5236015***</RequestId>
      <Message>operation success.</Message>    
      <Success>true</Success>
      <Code>200</Code>
</UpgradePrePayOrderResponse>

JSON format

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

Error codes

For a list of error codes, visit the API Error Center.