CreateCenBandwidthPackage - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Vous devez spécifier les zones à connecter lors de la création d'un forfait de bande passante. Une zone contient une ou plusieurs régions Alibaba Cloud. Lorsque vous sélectionnez des zones pour un forfait de bande passante, assurez-vous qu'elles incluent les régions que vous souhaitez connecter. Pour plus d'informations sur les zones et régions prises en charge, consultez Acheter un forfait de bande passante.
Pour plus d'informations sur les règles de facturation, consultez Facturation.
CreateCenBandwidthPackage est une opération asynchrone. Après l'envoi d'une requête, le système renvoie l'ID du forfait de bande passante, mais l'opération s'exécute toujours en arrière-plan. Vous pouvez appeler DescribeCenBandwidthPackages pour interroger l'état d'un forfait de bande passante. Si un forfait de bande passante se trouve dans l'état Idle ou InUse, cela signifie qu'il a été créé.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour votre commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateCenBandwidthPackage	L'opération que vous souhaitez effectuer. Définissez la valeur sur CreateCenBandwidthPackage.
ClientToken	String	No	02fb3da4-130e-11e9-8e44-001****	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer un jeton, mais vous devez vous assurer qu'il est unique parmi différentes requêtes. Le jeton ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères.
Name	String	No	nametest	Le nom du forfait de bande passante. Le nom doit comporter entre 2 et 128 caractères et peut contenir des lettres, des chiffres, des traits de soulignement (_) et des traits d'union (-). Le nom doit commencer par une lettre et ne peut pas commencer par `http://` ou `https://`.
Description	String	No	namedesc	La description du forfait de bande passante.
Bandwidth	Integer	Yes	2	La valeur maximale de la bande passante du forfait. Unité : Mbit/s. Valeurs valides : 2 à 10000.
GeographicRegionAId	String	Yes	China	La zone où l'instance réseau est déployée. Valeurs valides : China : Chine continentale North-America : Amérique du Nord Asia-Pacific : Asie-Pacifique Europe : Europe Australia : Australie
GeographicRegionBId	String	Yes	China	La zone où l'autre instance réseau est déployée. Valeurs valides : China : Chine continentale North-America : Amérique du Nord Asia-Pacific : Asie-Pacifique Europe : Europe Australia : Australie
BandwidthPackageChargeType	String	No	PREPAY	La méthode de facturation du forfait de bande passante. Valeur valide : PREPAY, qui indique que la méthode de facturation est le paiement à l'utilisation.
Period	Integer	No	1	La durée d'abonnement du forfait de bande passante. Valeur par défaut : 1. Si PricingCycle est défini sur Month, définissez Period sur une valeur comprise entre 1 et 3 ou 6. Si PricingCycle est défini sur Year, définissez Period sur une valeur comprise entre 1 et 3. Remarque Ce paramètre est requis lorsque BandwidthPackageChargeType est défini sur PREPAY.
PricingCycle	String	No	Month	Le cycle de facturation du forfait de bande passante. Valeurs valides : Month (par défaut) : facturation mensuelle. Year : facturation annuelle.
AutoPay	Boolean	No	false	Indique si le paiement du forfait de bande passante doit être effectué automatiquement. Valeurs valides : true : oui false (par défaut) : non Si vous définissez le paramètre sur false, accédez à Billing Management pour effectuer le paiement après avoir appelé cette opération. L'instance n'est créée qu'après le paiement.

Paramètres de réponse

Parameter	Type	Example	Description
CenBandwidthPackageId	String	cenbwp-4c2zaavbvh5fx****	L'ID du forfait de bande passante.
CenBandwidthPackageOrderId	String	20156420004****	L'ID de la commande pour le forfait de bande passante.
RequestId	String	E4B345CD-2CBA-4881-AF6D-E5D9BAE1CA7B	L'ID de la requête.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

XML format

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>

JSON format

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

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

Codes d'erreur

HttpCode	Error code	Error message	Description
400	UnSupported.ChargeType	The charge type is not supported.	Le message d'erreur renvoyé car la méthode de facturation spécifiée n'est pas prise en charge.

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs de l'API.