Docs

Transit Router

Bandwidth Packages

RenewTransitRouterBandwidthPackage - Renewing a TR bandwidth package

Call RenewTransitRouterBandwidthPackage to renew a Subscription Transit Router (TR) bandwidth package.

Debug

API Explorer

You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.

Go to debug

Request parameters

The following only details request parameters specific to this API and key common parameters. For more information, see Common parameters.

Action String required Example: RenewTransitRouterBandwidthPackage

The interface name. The current API name is RenewTransitRouterBandwidthPackage.

Version String required Example: 2020-04-01

The interface version. The current API version is 2020-04-01.

TransitRouterBandwidthPackageId String required Example: tr-bp-qw2u6ur8lhe2t****

The ID of the TR bandwidth package.

PeriodUnit String optional Example: Month

The biliing cycle for the TR bandwidth package. Values:

Month (default): Billing by month.

Year: Billing by year.

Period Integer optional Example: 1

The purchase duration for the TR bandwidth package. Default: 1. Values:

When PeriodUnit is set to "Month", valid values are 1 to 9, 12, 24, and 36.

When PeriodUnit is set to "Year", valid values are 1 to 3.

Response parameters

This API does not have specific response parameters. For more information, see Response structure.

Request example

GET /?Action=RenewTransitRouterBandwidthPackage&Version=2020-04-01&TransitRouterBandwidthPackageId=tr-bp-qw2u6ur8lhe2t**** HTTP/1.1​
Host: transitrouter.cn-beijing.volcengineapi.com​
X-Date: 20250804T035144Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250804/cn-beijing/transitrouter/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​

Response example

{​
    "ResponseMetadata": {​
        "RequestId": "20250804115147119015242230F0E3FD",​
        "Action": "RenewTransitRouterBandwidthPackage",​
        "Version": "2020-04-01",​
        "Service": "transitrouter",​
        "Region": "cn-beijing"​
    },​
    "Result": {}​
}​

Error codes

The following table lists the error codes related to the business logic for this API. For details, see Common error codes.

Status code	Error codes	Error message	Description
400	FailedOperation	Failed to obtain TransitRouter bandwidth package billing information.	Failed to retrieve the billing information of the bandwidth package.
400	InvalidTransitRouterBandwidthPackage.InvalidStatus	The specified TransitRouter bandwidth package is being operated now.	The specified bandwidth package is in a status that cannot respond to this request. Retry later.
400	InvalidTransitRouterBandwidthPackage.PeriodMalformed	The specified Period is invalid.	The specified purchase duration is invalid.
400	InvalidTransitRouterBandwidthPackage.PeriodUnitMalformed	The specified PeriodUnit is invalid.	The specified billing cycle is invalid.
400	InvalidTransitRouterCrossBorderBandwidthPackage.FrozenStatus	The specified request is denied because your account has been frozen for cross-border. Please wait for the Service Provider to unfreeze it.	The cross-border service under your account is suspended. Proceed after the line operator reactivates your service.
400	OrderError	Failed to create an order.	The order placement failed.
400	UnsupportedOperation.PrepaidInstanceRequired	The specified request is denied because the bandwidth package is not a prepaid bandwidth package.	The specified bandwidth package is not a prepaid package. The action is not supported.
400	UnsupportedOperation	The payment failed due to the account balance is not enough for this order.	The order payment failed due to insufficient account balance.
400	UnsupportedOperation	The request on the specified instance is denied due to the account in arrears status.	The action request on this instance is denied because the account is in arrears.
404	InvalidTransitRouterBandwidthPackage.NotFound	The specified bandwidth package id does not exist.	The specified bandwidth package does not exist.

Last updated: 2026.05.28 14:56:13