DescribePortRangeLists - Elastic Compute Service - Centre de documentation Alibaba Cloud

Consulte les listes de ports.

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.

ecs:DescribePortRangeLists

list

*PortRangeList

acs:ecs:{#regionId}:{#accountId}:portrangelist/*

PortRangeList

acs:ecs:{#regionId}:{#accountId}:portrangelist/{#portRangeListId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région. Vous pouvez appeler l'opération DescribeRegions pour obtenir la liste des régions la plus récente.	cn-hangzhou
NextToken	string	Non	L'identifiant de la région. Vous pouvez appeler l'opération DescribeRegions pour obtenir la liste des régions la plus récente.	cn-hangzhou
MaxResults	integer	Non	Le jeton de pagination utilisé dans la requête pour récupérer une nouvelle page de résultats. Vous n'avez pas besoin de spécifier ce paramètre pour la première requête. Vous devez spécifier le jeton obtenu lors de la requête précédente comme valeur de NextToken.	727d41872117f2816343eeb432fbc5bfd21dc824589d2a4be0b5e8707e68181f
PortRangeListName	string	Non	Le nombre maximal d'entrées par page. Valeur maximale : 100 Valeur par défaut : 10.	10
PortRangeListId	array	Non	Le nom de la liste de ports. Le nom doit comporter entre 2 et 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par http://, https://, com.aliyun ou com.alibabacloud. Le nom peut contenir des lettres, des chiffres, des deux-points (:), des traits de soulignement (_), des points (.) et des traits d'union (-).	ExempleNomListePlagesPorts
	string	Non	The ID of the port range list.	prl-2ze9743****
ResourceGroupId	string	Non	L'identifiant de la liste de ports. Valeurs valides de N : 0 à 100.	rg-bp67acfmxazb4p****
Tag	array<object>	Non	L'identifiant du groupe de ressources. Si vous spécifiez ce paramètre pour interroger des ressources, jusqu'à 1 000 ressources appartenant au groupe de ressources spécifié peuvent être renvoyées dans la réponse. Vous pouvez appeler l'opération ListResourceGroups pour obtenir la liste des groupes de ressources la plus récente. Remarque Le groupe de ressources par défaut n'est pas pris en charge.	rg-bp67acfmxazb4p****
	object	Non	The tag key-value pair information bound to the port range list.
Key	string	Non	The tag key of the instance. Valid values of N: 1 to 20. If you use a single tag to filter resources, the resource count with this tag cannot exceed 1000. If you use multiple tags to filter resources, the resource count of resources that have all specified tags attached cannot exceed 1000. If the resource count exceeds 1000, call ListTagResources to query resources.	key for PortRangeList
Value	string	Non	The tag value.	value for PortRangeList
		Non	Les balises ajoutées à la liste de ports.

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
NextToken	string	Un jeton de pagination. Si la valeur renvoyée est vide, aucune donnée supplémentaire n'est renvoyée.	AAAAAdDWBF2
RequestId	string	L'identifiant de la requête.	6040AD98-11C3-5F78-9346-FCA8E9D8960F
PortRangeLists	array<object>	Les détails des listes de ports.
	array<object>	Les détails de la liste de ports.
PortRangeListId	string	L'identifiant de la liste de ports.	prl-2ze9743****
PortRangeListName	string	Le nom de la liste de ports.	ExempleNomListePlagesPorts
MaxEntries	integer	Le nombre maximal d'entrées dans la liste de ports.	20
AssociationCount	integer	Le nombre de ressources associées.	1
Description	string	La description de la liste de ports.	Ceci est une description
CreationTime	string	L'heure de création de la liste de ports.	2024-12-04T07:11Z
ResourceGroupId	string	L'identifiant du groupe de ressources auquel attribuer la liste de ports.	rg-2zeg82g****
Tags	array<object>	Les balises de la liste de ports.
	object	La balise de la liste de ports.
TagKey	string	The tag key of the port range list.	TestKey
TagValue	string	The tag value of the port range list.	TestValue

Exemples

JSON format

{
  "NextToken": "AAAAAdDWBF2",
  "RequestId": "6040AD98-11C3-5F78-9346-FCA8E9D8960F",
  "PortRangeLists": [
    {
      "PortRangeListId": "prl-2ze9743****",
      "PortRangeListName": "PortRangeListNameSample",
      "MaxEntries": 20,
      "AssociationCount": 1,
      "Description": "This is description.",
      "CreationTime": "2024-12-04T07:11Z",
      "ResourceGroupId": "rg-2zeg82g****",
      "Tags": [
        {
          "TagKey": "TestKey",
          "TagValue": "TestValue"
        }
      ]
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	LimitExceed.PortRangeListId	The specified number of PortRangeListId exceeds the limit.	The number of port list IDs specified exceeds the limit.
400	InvalidParameter	The specified parameter is not valid.	A specified parameter is invalid.
404	InvalidRegionId.NotFound	The specified parameter RegionId is not valid.	The specified RegionId parameter does not exist. Check whether the service is available in the specified region.

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

Notes de version

Consultez Notes de version pour la liste complète.