DescribeCenBandwidthPackages - - Centre de documentation Alibaba Cloud

Consulte les informations sur les instances de paquets de bande passante en appelant l'opération DescribeCenBandwidthPackages.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

cen:DescribeCenBandwidthPackages

get

*Forfait de bande passante CEN.

acs:cen:*:{#accountId}:cenbandwidthpackage/*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
IncludeReservationData	boolean	Non	Indique si les données de renouvellement doivent être incluses. Valeurs valides : true : inclut les données de renouvellement. false : n'inclut pas les données de renouvellement.	true
PageNumber	integer	Non	Le numéro de page de la liste. Valeur par défaut : 1.	1
PageSize	integer	Non	Le nombre d'entrées par page pour une requête paginée. Valeur maximale : 50. Valeur par défaut : 10.	2
IsOrKey	boolean	Non	La relation logique entre les conditions de filtrage. Valeurs valides : false (par défaut) : les conditions de filtrage ont une relation ET. Un paquet de bande passante doit correspondre à toutes les conditions de filtrage pour être renvoyé. true : les conditions de filtrage ont une relation OU. Un paquet de bande passante correspondant à n'importe quelle condition de filtrage est renvoyé.	false
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	rg-acfnwjeo4tv****
Filter	array<object>	Non	Les informations de filtrage.
	object	Non	Les informations de filtrage.
Key	string	Non	La condition de filtrage. Vous pouvez utiliser des conditions de filtrage pour filtrer les instances de paquets de bande passante à interroger. Les conditions de filtrage suivantes sont prises en charge : CenId : l'identifiant de l'instance Cloud Enterprise Network (CEN). Status : l'état de l'instance de paquet de bande passante. Valeurs valides : Idle : non associé. InUse : associé. CenBandwidthPackageId : l'identifiant du paquet de bande passante. Name : le nom du paquet de bande passante. Vous pouvez spécifier une ou plusieurs conditions de filtrage. La valeur maximale de N est 5.	CenId
Value	array	Non	Les valeurs de filtrage basées sur la Key spécifiée. Vous pouvez spécifier plusieurs valeurs de filtrage pour une seule Key. Les valeurs de filtrage ont une relation OU, ce qui signifie qu'un paquet de bande passante correspondant à l'une des valeurs de filtrage est considéré comme correspondant à la condition de filtrage.	Idle
	string	Non	Les valeurs de filtrage basées sur la Key spécifiée. Vous pouvez spécifier plusieurs valeurs de filtrage pour une seule Key. Les valeurs de filtrage ont une relation OU, ce qui signifie qu'un paquet de bande passante correspondant à l'une des valeurs de filtrage est considéré comme correspondant à la condition de filtrage.	cen-xxjsjfkffkfkfjkf****
Tag	array<object>	Non	La liste des informations de balise. Vous pouvez spécifier jusqu'à 20 balises à la fois.
	object	Non	Les informations de balise. Vous pouvez spécifier jusqu'à 20 balises à la fois.
Key	string	Non	La clé de balise de la ressource. Une fois spécifiée, la clé de balise ne peut pas être une chaîne vide. La clé de balise peut comporter jusqu'à 64 caractères et ne peut pas commencer par aliyun ou acs:. Elle ne peut pas contenir http:// ou https://. Vous pouvez spécifier jusqu'à 20 clés de balise à la fois.	TagKey
Value	string	Non	La valeur de balise de la ressource. La valeur de balise peut être vide ou être une chaîne de jusqu'à 128 caractères. Elle ne peut pas commencer par aliyun ou acs: et ne peut pas contenir http:// ou https://. Chaque clé de balise correspond à une valeur de balise. Vous pouvez spécifier jusqu'à 20 valeurs de balise à la fois.	TagValue

Éléments de réponse

Élément	Type	Description	Exemple
	object
PageSize	integer	Le nombre d'entrées par page.	2
RequestId	string	L'identifiant de la requête.	9D7E2400-2755-4AF5-9B73-12565E4F73A0
PageNumber	integer	Le numéro de page actuel.	1
TotalCount	integer	Le nombre total d'entrées.	2
CenBandwidthPackages	object
CenBandwidthPackage	array<object>	Les détails du paquet de bande passante.
	array<object>
ReservationActiveTime	string	L'heure d'expiration de la mise à niveau temporaire, au format ISO 8601 (YYYY-MM-DDThh:mmZ).	2021-08-30T16:00Z
Status	string	Indique si le paquet de bande passante est associé à une instance CEN. Idle : non associé. InUse : associé.	InUse
CreationTime	string	L'heure de création du paquet de bande passante, au format ISO 8601 (YYYY-MM-DDThh:mmZ).	2021-02-01T11:14Z
ReservationOrderType	string	Le type de renouvellement avec changement de spécification. Valeurs valides : TEMP_UPGRADE : mise à niveau temporaire. UPGRADE : mise à niveau.	UPGRADE
BandwidthPackageChargeType	string	La méthode de facturation du paquet de bande passante.	PREPAY
CenBandwidthPackageId	string	L'identifiant du paquet de bande passante.	cenbwp-4c2zaavbvh5x****
ReservationInternetChargeType	string	La méthode de facturation après le changement de spécification.	PREPAY
GeographicRegionAId	string	L'identifiant de la zone connectée à interroger. Valeurs valides : china : la Chine continentale. asia-pacific : Asie-Pacifique. europe : Europe. north-america : Amérique du Nord.	china
Bandwidth	integer	La bande passante crête du paquet de bande passante.	2
Description	string	La description du paquet de bande passante.	cen
ExpiredTime	string	L'heure d'expiration du paquet de bande passante, au format ISO 8601 (YYYY-MM-DDThh:mmZ).	2021-09-08T16:00Z
ReservationBandwidth	string	La bande passante restaurée après l'expiration de la mise à niveau temporaire.	10
GeographicSpanId	string	L'identifiant de la paire de zones connectées.	north-america_china
GeographicRegionBId	string	L'identifiant de l'autre zone connectée de l'instance de paquet de bande passante. Valeurs valides : china : la Chine continentale. asia-pacific : Asie-Pacifique. europe : Europe. north-america : Amérique du Nord.	north-america
ResourceGroupId	string	L'identifiant du groupe de ressources.	rg-aekzoyr5k36****
IsCrossBorder	boolean	Indique si le paquet de bande passante est un paquet de bande passante transfrontalier. false : le paquet de bande passante n'est pas un paquet de bande passante transfrontalier. true : le paquet de bande passante est un paquet de bande passante transfrontalier.	false
BusinessStatus	string	L'état du paquet de bande passante. Normal : normal. FinancialLocked : verrouillé en raison d'un retard de paiement. SecurityLocked : verrouillé pour des raisons de sécurité.	Normal
Name	string	Le nom du paquet de bande passante.	test
HasReservationData	string	Indique si des données de renouvellement existent. true : des données de renouvellement existent. false : aucune donnée de renouvellement n'existe. Remarque Ce paramètre est défini sur true uniquement lorsque le paramètre IncludeReservationData est défini sur true et qu'il existe des données de commande en attente qui n'ont pas encore pris effet.	false
OrginInterRegionBandwidthLimits	object
OrginInterRegionBandwidthLimit	array<object>	Les détails des régions connectées.
	object
BandwidthLimit	string	La bande passante crête entre les régions connectées.	1
OppositeRegionId	string	L'identifiant de la région homologue.	us-west-1
GeographicSpanId	string	Les régions connectées.	north-america_china
LocalRegionId	string	L'identifiant de la région locale.	cn-hangzhou
Tags	object
Tag	array<object>	Les informations de balise du paquet de bande passante.
	object	La liste des balises.
Key	string	La clé de balise.	TagKey
Value	string	La valeur de balise.	TagValue
CenIds	object
CenId	array	La liste des instances CEN associées au paquet de bande passante.
	string	L'identifiant d'instance de l'instance CEN associée au paquet de bande passante.	cen-xxjsjfkffkfkfjkf****

Exemples

JSON format

{
  "PageSize": 2,
  "RequestId": "9D7E2400-2755-4AF5-9B73-12565E4F73A0",
  "PageNumber": 1,
  "TotalCount": 2,
  "CenBandwidthPackages": {
    "CenBandwidthPackage": [
      {
        "ReservationActiveTime": "2021-08-30T16:00Z",
        "Status": "InUse",
        "CreationTime": "2021-02-01T11:14Z",
        "ReservationOrderType": "UPGRADE",
        "BandwidthPackageChargeType": "PREPAY",
        "CenBandwidthPackageId": "cenbwp-4c2zaavbvh5x****",
        "ReservationInternetChargeType": "PREPAY",
        "GeographicRegionAId": "china",
        "Bandwidth": 2,
        "Description": "cen",
        "ExpiredTime": "2021-09-08T16:00Z",
        "ReservationBandwidth": "10",
        "GeographicSpanId": "north-america_china",
        "GeographicRegionBId": "north-america",
        "ResourceGroupId": "rg-aekzoyr5k36****",
        "IsCrossBorder": false,
        "BusinessStatus": "Normal",
        "Name": "test",
        "HasReservationData": "false",
        "OrginInterRegionBandwidthLimits": {
          "OrginInterRegionBandwidthLimit": [
            {
              "BandwidthLimit": "1",
              "OppositeRegionId": "us-west-1",
              "GeographicSpanId": "north-america_china",
              "LocalRegionId": "cn-hangzhou"
            }
          ]
        },
        "Tags": {
          "Tag": [
            {
              "Key": "TagKey",
              "Value": "TagValue"
            }
          ]
        },
        "CenIds": {
          "CenId": [
            "cen-xxjsjfkffkfkfjkf****"
          ]
        }
      }
    ]
  }
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	IllegalParam.TagValue	The tag values are not valid.	La valeur de balise spécifiée dans la requête est invalide.
400	IllegalParam.TagKey	The tag keys are not valid.	La clé de balise spécifiée dans la requête est invalide.
400	InvalidParameter	Invalid parameter.	Le paramètre n'est pas valide.
400	Unauthorized	The AccessKeyId is unauthorized.	Le compte ne dispose pas des autorisations nécessaires pour effectuer cette opération.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.