CreateVpcPrefixList - Virtual Private Cloud - Centre de documentation Alibaba Cloud

Crée une liste de préfixes.

Description de l'opération

Vous ne pouvez pas appeler l'opération CreateVpcPrefixList de manière répétée pendant la période spécifiée.

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.

vpc:CreateVpcPrefixList

create

*PrefixList

acs:vpc:{#regionId}:{#accountId}:prefixlist/*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
PrefixListName	string	Non	Le nom de la liste de préfixes. Le nom doit comporter de 1 à 128 caractères et ne peut pas commencer par `http://` ou `https://`.	nom
PrefixListDescription	string	Non	La description de la liste de préfixes. La description doit comporter de 1 à 256 caractères et ne peut pas commencer par `http://` ou `https://`.	description
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer la valeur, mais vous devez vous assurer qu'elle est unique parmi toutes les requêtes. ClientToken ne peut contenir que des caractères ASCII. Remarque Si vous ne spécifiez pas ce paramètre, ClientToken prend la valeur de RequestId. La valeur de RequestId peut être différente pour chaque requête API.	123e4567-e89b-12d3-a456-426655440000
DryRun	boolean	Non	Indique si un test à blanc doit être effectué. Valeurs valides : true : effectue uniquement un test à blanc. Le système vérifie les paramètres requis, la syntaxe de la requête et les limites. Si la requête échoue au test à blanc, un message d'erreur est renvoyé. Si la requête réussit le test à blanc, le code d'erreur DryRunOperation est renvoyé. false (par défaut) : effectue un test à blanc et exécute la requête réelle. Si la requête réussit le test à blanc, un code d'état HTTP 2xx est renvoyé et l'opération est exécutée.	false
MaxEntries	integer	Non	Le nombre maximal de blocs CIDR que vous pouvez spécifier dans la liste de préfixes. Valeur par défaut : 50.	50
PrefixListEntries	array<object>	Non	Les informations sur les blocs CIDR spécifiés dans la liste de préfixes.
	object	Non
Cidr	string	Non	Le bloc CIDR spécifié dans la liste de préfixes.	192.168.0.0/16
Description	string	Non	La description du bloc CIDR spécifié dans la liste de préfixes. La description doit comporter de 1 à 256 caractères et ne peut pas commencer par `http://` ou `https://`.	CIDR
ResourceGroupId	string	Non	L'identifiant du groupe de ressources auquel appartient la liste de préfixes.	rg-bp67acfmxazb4ph****
RegionId	string	Oui	L'identifiant de la région dans laquelle vous souhaitez créer la liste de préfixes. Vous pouvez appeler l'opération DescribeRegions pour obtenir la liste des régions la plus récente.	cn-hangzhou
IpVersion	string	Non	La version IP. Valeurs valides : IPv4 (par défaut) IPv6	IPv4
Tag	array<object>	Non	La liste des balises.
	object	Non
Key	string	Non	La clé de la balise N. Vous pouvez spécifier jusqu'à 20 clés de balise. La clé de la balise ne peut pas être une chaîne vide. La clé de la balise peut comporter jusqu'à 128 caractères. Elle ne peut pas commencer par aliyun ou acs:, et ne peut pas contenir `http://` ou `https://`.	FinanceDept
Value	string	Non	La valeur de la balise N. Vous pouvez spécifier jusqu'à 20 valeurs de balise. 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://`. La valeur de la balise ne peut pas commencer par aliyun ou acs:.	FinanceJoshua

Éléments de réponse

Élément	Type	Description	Exemple
	object
PrefixListId	string	L'identifiant de la liste de préfixes.	pl-0b700s2ee3***
RequestId	string	L'identifiant de la requête.	54B48E3D-DF70-471B-AA93-08E683A1B45
ResourceGroupId	string	L'identifiant du groupe de ressources auquel appartient la liste de préfixes.	rg-bp67acfmxazb4ph****

Exemples

JSON format

{
  "PrefixListId": "pl-0b700s2ee3***",
  "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "ResourceGroupId": "rg-bp67acfmxazb4ph****"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	UnsupportedFeature.IpVersion	The ipversion type is not supported.	The specified ipVersion is not supported.
400	QuotaExceeded.PrefixListCidrCount	The quota of prefixListMaxEntry count is exceeded.	The value of entryCount exceeds the upper limit.
400	OperationFailed.CidrCountExceedMaxCount	The operation is failed because of cidrCountExceedMaxCount.	The number of CIDR blocks specified exceeds the maximum allowed value of cidrMaxCount.
400	IllegalParam.CidrBlock	The param of cidrBlock is illegal.	The error message returned because the value of the cidrBlock parameter is invalid.
400	IllegalParam.CidrName	The param of cidrName is illegal.	The specified cidrName is invalid.
400	DuplicatedParam.CidrBlock	The param of cidrBlock is duplicated.	The error message returned because a duplicate CIDR block is specified.
400	QuotaExceeded.PrefixListCount	The quota of prefixList count is exceeded.	The value of prefixList exceeds the upper limit.

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

Notes de version

Consultez Notes de version pour la liste complète.