CreateCenBandwidthPackage - - Centro de documentación de Alibaba Cloud

Cree un plan de ancho de banda.

Notas de uso

Especifique las áreas que se conectarán al crear un plan de ancho de banda. Un área contiene una o más regiones de Alibaba Cloud. Al seleccionar las áreas para un plan de ancho de banda, asegúrese de que incluyan las regiones que desea conectar. Para obtener más información sobre las áreas y regiones compatibles, consulte Adquirir un plan de ancho de banda.
Para obtener más información sobre las reglas de facturación, consulte Facturación.
CreateCenBandwidthPackage es una operación asíncrona. Después de enviar la solicitud, el sistema devuelve el ID del plan de ancho de banda, pero la operación continúa ejecutándose en segundo plano. Llame a DescribeCenBandwidthPackages para consultar el estado de un plan de ancho de banda. Si el plan de ancho de banda se encuentra en estado Idle o InUse, significa que se creó correctamente.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateCenBandwidthPackage	La operación que desea ejecutar. Establezca el valor en CreateCenBandwidthPackage.
ClientToken	String	No	02fb3da4-130e-11e9-8e44-001****	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar un token, pero debe asegurarse de que sea único entre distintas solicitudes. El token solo puede contener caracteres ASCII y no debe exceder los 64 caracteres de longitud.
Name	String	No	nametest	El nombre del plan de ancho de banda. El nombre debe tener entre 2 y 128 caracteres de longitud, y puede contener letras, dígitos, guiones bajos (_) y guiones (-). Debe comenzar con una letra y no puede empezar con `http://` ni con `https://`.
Description	String	No	namedesc	La descripción del plan de ancho de banda.
Bandwidth	Integer	Sí	2	El valor máximo de ancho de banda del plan. Unidad: Mbit/s. Valores válidos: de 2 a 10000.
GeographicRegionAId	String	Sí	China	El área donde se despliega la instancia de red. Valores válidos: China: China continental North-America: América del Norte Asia-Pacific: Asia Pacífico Europe: Europa Australia: Australia
GeographicRegionBId	String	Sí	China	El área donde se despliega la otra instancia de red. Valores válidos: China: China continental North-America: América del Norte Asia-Pacific: Asia Pacífico Europe: Europa Australia: Australia
BandwidthPackageChargeType	String	No	PREPAY	El método de facturación del plan de ancho de banda. Valor válido: PREPAY, que indica que el método de facturación es pay-as-you-go.
Period	Integer	No	1	La duración de la suscripción del plan de ancho de banda. Valor predeterminado: 1. Si PricingCycle se establece en Month, establezca Period en un valor de 1 a 3 o 6. Si PricingCycle se establece en Year, establezca Period en un valor de 1 a 3. Nota Este parámetro es obligatorio cuando BandwidthPackageChargeType se establece en PREPAY.
PricingCycle	String	No	Month	El ciclo de facturación del plan de ancho de banda. Valores válidos: Month (predeterminado): facturación mensual. Year: facturación anual.
AutoPay	Boolean	No	false	Especifica si se debe completar automáticamente el pago del plan de ancho de banda. Valores válidos: true: Sí false (predeterminado): no Si establece el parámetro en false, vaya a Billing Management para completar el pago después de llamar a esta operación. La instancia se crea únicamente después de completar el pago.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
CenBandwidthPackageId	String	cenbwp-4c2zaavbvh5fx****	El ID del plan de ancho de banda.
CenBandwidthPackageOrderId	String	20156420004****	El ID del pedido del plan de ancho de banda.
RequestId	String	E4B345CD-2CBA-4881-AF6D-E5D9BAE1CA7B	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/?Action=CreateCenBandwidthPackage
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&Name=nametest
&Description=namedesc
&Bandwidth=2
&GeographicRegionAId=China 
&GeographicRegionBId=China 
&BandwidthPackageChargeType=PREPAY
&Period=1
&PricingCycle=Month
&AutoPay=false
&AutoRenew=false
&Common request parameters

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateCenBandwidthPackageResponse>
    <RequestId>E4B345CD-2CBA-4881-AF6D-E5D9BAE1CA7B</RequestId>
    <CenBandwidthPackageOrderId>20156420004****</CenBandwidthPackageOrderId>
    <CenBandwidthPackageId> cenbwp-4c2zaavbvh5fx****</CenBandwidthPackageId>
</CreateCenBandwidthPackageResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "E4B345CD-2CBA-4881-AF6D-E5D9BAE1CA7B",
  "CenBandwidthPackageOrderId" : "20156420004****",
  "CenBandwidthPackageId" : "cenbwp-4c2zaavbvh5fx****"
}

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
400	UnSupported.ChargeType	The charge type is not supported.	El mensaje de error devuelto porque el método de facturación especificado no es compatible.

Para consultar una lista de códigos de error, visite el Centro de errores de API.