CreatePortRangeList - Elastic Compute Service - Centre de documentation Alibaba Cloud

Crée une liste de ports. Vous pouvez associer une liste de ports à des ressources, telles que des groupes de sécurité.

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:CreatePortRangeList

create

*PortRangeList

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région de la liste de ports. Vous pouvez appeler l'opération DescribeRegions pour interroger la liste des régions la plus récente.	cn-hangzhou
ClientToken	string	Non	L'identifiant de la région de la liste de ports. Vous pouvez appeler l'opération DescribeRegions pour interroger la liste des régions la plus récente.	cn-hangzhou
MaxEntries	integer	Oui	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer que le jeton est unique parmi les différentes requêtes. Le jeton ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères. Pour plus d'informations, consultez Comment garantir l'idempotence.	123e4567-e89b-12d3-a456-426655440000
PortRangeListName	string	Oui	Le nombre maximal d'entrées dans la liste de ports. Cette valeur ne peut pas être modifiée après la création de la liste de ports. Valeurs valides : 1 à 2000. Remarque Lorsque vous référencez une liste de ports dans une ressource, telle qu'un groupe de sécurité, le nombre maximal d'entrées (et non le nombre réel d'entrées) de la liste de ports est décompté du quota de règles de la ressource. Définissez une valeur appropriée pour MaxEntries.	10
Description	string	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 (-).	PortRangeListNameSample
Entry	array<object>	Non	La description de la liste de ports. La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par http:// ou https://.	Informations de description de la liste de ports
	object	Non	The collection of port list entries.
PortRange	string	Non	The port range. Valid values of N: 0 to 200. The number of entries cannot exceed the maximum number of entries (MaxEntries). The PortRange values in multiple entries cannot be duplicated.	80/80
Description	string	Non	The description of the port range. The description must be 2 to 32 characters in length and cannot start with http:// or https://. Valid values of N: 0 to 200.	Description information of Entry
ResourceGroupId	string	Non	Les entrées de la liste de ports.	rg-aek3b6jzp66****
Tag	array<object>	Non	L'identifiant du groupe de ressources auquel appartient la liste de ports.	rg-aek3b6jzp66****
	object	Non	The tag key-value pair information bound to the port list.
Key	string	Non	The tag key of the port list. This parameter cannot be an empty string. The tag key can be up to 128 characters in length and cannot start with aliyun or acs:. It cannot contain http:// or https://.	key for PortRangeList
Value	string	Non	The tag value of the port list. This parameter cannot be null but can be an empty string. The tag value can be up to 128 characters in length and cannot contain http:// or https://.	value for PortRangeList
		Non	Les balises à ajouter à la liste de ports. Vous pouvez ajouter de 0 à 20 balises à la liste de ports.

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les données renvoyées.
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
PortRangeListId	string	L'identifiant de la liste de ports.	prl-2ze9743****

Exemples

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "PortRangeListId": "prl-2ze9743****"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidParam.Entry	The specified parameter Entry is not valid.	The specified entry parameter is invalid.
400	InvalidOperation.MaxEntriesCountExceed	The specified MaxEntries exceeded the upper limit.	The specified MaxEntries parameter exceeds the maximum limit.
400	InvalidOperation.EntryCountExceedMaxEntries	The number of entries in the port list exceeds MaxEntries.	The number of entries specified exceeds the MaxEntries value of the port list.
400	InvalidParameter.PortRange	The specified parameter PortRange is not valid. It should be two integers less than 65535 in specified format.	Entries in the port list PortRange not in the required format. Two integers less than 65535 should be specified, separated by a slash.
400	InvalidParameter.PortRangeListName	The specified parameter PortRangeListName is not valid.	The specified port list name is invalid.
400	LimitExceed.MaxEntries	The number of entries exceeds the MaxEntries of the specified PortRangeList.	The number of entries in the port list exceeds the MaxEntries value.
400	LimitExceed.Entry	The number of entries added or removed exceeds the limit.	The number of entries to add or remove at a time exceeds the upper limit.
400	InvalidOperation.MaxCountExceed	The number of port range list in the current account has exceeded quota.	The number of port lists under the current account exceeds the limit of the number of port lists under the user account.
400	InvalidParameter.PortRangeDuplicated	The specified PortRange is duplicated.	Duplicate port range specified
400	InvalidDescription.Malformed	The specifid Description is not valid.	The resource description is invalid. The description must be 2 to 256 characters in length and cannot start with http:// or https://.
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.