CreatePrefixList - Elastic Compute Service - Centre de documentation Alibaba Cloud

Crée une liste de préfixes.

Description de l'opération

Remarques sur l'utilisation

Une liste de préfixes est un ensemble de préfixes réseau (blocs CIDR) et peut être référencée pour configurer des règles réseau pour d'autres ressources. Pour plus d'informations, consultez Vue d'ensemble.
Lorsque vous créez une liste de préfixes, prenez note des éléments suivants :
- Vous devez spécifier une famille d'adresses IP (IPv4 ou IPv6) pour la liste de préfixes, et vous ne pouvez pas modifier la famille d'adresses IP après la création de la liste de préfixes. Vous ne pouvez pas combiner des blocs CIDR IPv4 et IPv6 dans une seule liste de préfixes.
- Vous devez spécifier le nombre maximal d'entrées que la liste de préfixes peut contenir. Vous ne pouvez pas modifier le nombre maximal d'entrées après la création de la liste de préfixes.
- Vous pouvez spécifier des entrées pour la liste de préfixes. Chaque entrée se compose d'un bloc CIDR et de la description du bloc CIDR. Le nombre total d'entrées ne peut pas dépasser le nombre maximal d'entrées que vous avez spécifié.
Pour plus d'informations sur les limites des listes de préfixes et des autres ressources, consultez Limites.
Vous pouvez créer des utilisateurs Resource Access Management (RAM) et leur accorder des autorisations minimales. Cela élimine le besoin de partager la paire AccessKey de votre compte Alibaba Cloud avec d'autres utilisateurs et réduit les risques de sécurité pour vos entreprises. Pour plus d'informations sur la manière d'accorder des autorisations sur les listes de préfixes aux utilisateurs RAM, consultez Accorder des autorisations sur les listes de préfixes à un utilisateur RAM.

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

create

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région dans laquelle créer la liste de préfixes.	cn-chengdu
RegionId	string	Oui	L'identifiant de la région dans laquelle créer la liste de préfixes.	cn-chengdu
MaxEntries	integer	Oui	Le nombre maximal d'entrées que la liste de préfixes peut contenir. Valeurs valides : 1 à 200.	10
AddressFamily	string	Oui	La famille d'adresses IP. Valeurs valides : IPv4 IPv6	IPv4
ClientToken	string	Non	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 peut pas dépasser 64 caractères. Pour plus d'informations, consultez Comment garantir l'idempotence.	0c593ea1-3bea-11e9-b96b-88e9fe637760
PrefixListName	string	Oui	Le nom de la liste de préfixes. Le nom doit comporter de 2 à 128 caractères et peut contenir des lettres, des chiffres, des deux-points (:), des traits de soulignement (_), des points (.) et des traits d'union (-). Il doit commencer par une lettre et ne peut pas commencer par http://, https://, com.aliyun ou com.alibabacloud.	PrefixListNameSample
Description	string	Non	La description de la liste de préfixes. La description doit comporter de 2 à 256 caractères et ne peut pas commencer par http:// ou https://.	Ceci est une description
Entry	array<object>	Non	Les détails des entrées dans la liste de préfixes.
	object	Non
Description	string	Non	La description de l'entrée N. La description doit comporter de 2 à 32 caractères et ne peut pas commencer par http:// ou https://. Valeurs valides de N : 0 à 200.	Exemple de description 01
Cidr	string	Oui	Le bloc CIDR de l'entrée N. Valeurs valides de N : 0 à 200. Remarques : Le nombre total d'entrées ne peut pas dépasser la valeur MaxEntries. Les types de blocs CIDR sont déterminés par la famille d'adresses IP. Vous ne pouvez pas combiner des blocs CIDR IPv4 et IPv6 dans une seule liste de préfixes. Les blocs CIDR doivent être uniques dans toutes les entrées d'une liste de préfixes. Par exemple, vous ne pouvez pas spécifier 192.168.1.0/24 deux fois dans les entrées de la liste de préfixes. Vous pouvez définir une adresse IP unique. Le système convertit automatiquement l'adresse IP en bloc CIDR. Par exemple, si vous définissez 192.168.1.100, le système la convertit automatiquement en 192.168.1.100/32. Si vous utilisez un bloc CIDR IPv6, le système compresse automatiquement les zéros du bloc CIDR et met les lettres en minuscules. Par exemple, si vous spécifiez 2001:0DB8:0000:0000:0000:0000:0000:0000/32, le système le convertit en 2001:db8::/32. Pour plus d'informations sur les blocs CIDR, consultez Qu'est-ce que le CIDR ? Ce paramètre est vide par défaut.	192.168.1.0/24
Tag	array<object>	Non	Les balises à ajouter à la liste de préfixes.
	object	Non	La balise N à ajouter à la liste de préfixes.
Key	string	Non	La clé de la balise N. Valeurs valides de N : 1 à 20. La clé de balise ne peut pas être une chaîne vide. La clé de balise peut comporter jusqu'à 128 caractères et ne peut pas commencer par acs: ou aliyun. Elle ne peut pas contenir http:// ou https://.	CléTest
Value	string	Non	La valeur de la balise N. Valeurs valides de N : 1 à 20. La valeur de la balise peut être une chaîne vide. La valeur de la balise peut comporter jusqu'à 128 caractères et ne peut pas contenir http:// ou https://.	ValeurTest
ResourceGroupId	string	Non	L'identifiant du groupe de ressources auquel affecter la liste de préfixes.	rg-bp67acfmxazb4p****

Éléments de réponse

Élément	Type	Description	Exemple
	object
PrefixListId	string	L'identifiant de la liste de préfixes.	pl-x1j1k5ykzqlixdcy****
RequestId	string	L'identifiant de la requête.	38793DB8-A4B2-4AEC-BFD3-111234E9188D

Exemples

JSON format

{
  "PrefixListId": "pl-x1j1k5ykzqlixdcy****",
  "RequestId": "38793DB8-A4B2-4AEC-BFD3-111234E9188D"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	MissingParameter	%s	A parameter is not specified.
400	InvalidParameter.AddressFamily	The parameter AddressFamily should be IPv4 or IPv6.	The specified AddressFamily parameter is invalid. The valid values of this parameter are IPv4 and IPv6.
400	InvalidParameter	%s	The specified parameter is invalid.
400	InvalidParameter.PrefixListName	The parameter PrefixListName is not valid.	The prefix list name is invalid.
400	InvalidDescription.Malformed	The specified Description is wrongly formed.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	The specified ClientToken parameter is invalid.
400	InvalidParameter.CidrMalformed	%s	The specified CIDR block is invalid.
400	InvalidParameter.CidrDuplicated	%s	Duplicate CIDR blocks are specified.
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	LimitExceed.MaxEntries	The number of entries exceeds the MaxEntries of the specified prefix list.	The number of specified entries exceeds the MaxEntries value.
404	LimitExceed.PrefixListPerRegion	The number of prefix lists in the region exceeds the limit.	The maximum number of prefix lists in the current region has been reached.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	The specified region ID does not exist.
404	InvalidResourceGroup.NotFound	The specified resource group is not found.	Cannot find the corresponding resource group

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

Notes de version

Consultez Notes de version pour la liste complète.