CreateLoadBalancer - - Centre de documentation Alibaba Cloud

Crée un équilibreur de charge applicatif dans une région spécifiée.

Description de l'opération

L'opération CreateLoadBalancer est asynchrone. Un appel réussi renvoie un identifiant d'instance, mais l'instance d'équilibreur de charge applicatif est créée en arrière-plan. Appelez GetLoadBalancerAttribute pour vérifier l'état de création de l'instance d'équilibreur de charge applicatif :

Si l'instance est dans l'état provisioning, elle est en cours de création.
Si l'instance est dans l'état active, elle a été créé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.

alb:CreateLoadBalancer

create

*LoadBalancer

acs:alb:{#regionId}:{#accountId}:loadbalancer/*

alb:AddressType

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ClientToken	string	Non	Un jeton client pour garantir l'idempotence de la requête. Vous pouvez générer une valeur unique depuis votre client pour chaque requête. Le paramètre ClientToken n'accepte que les caractères ASCII. Remarque Si vous omettez ce paramètre, le système utilise le RequestId de la requête comme ClientToken.	5A2CFF0E-5718-45B5-9D4D-70B3FF3898
DryRun	boolean	Non	Indique si un test à blanc doit être effectué. Valeurs valides : true : effectue un test à blanc sans créer l'instance d'équilibreur de charge applicatif. Le système vérifie les paramètres requis, le format de la requête et les limites du service. Si la requête échoue à la vérification, une erreur est renvoyée. Si la requête réussit la vérification, le système renvoie le code d'erreur DryRunOperation. false (par défaut) : envoie une requête normale. Si la requête réussit la vérification, le système renvoie un code d'état HTTP 2xx et exécute l'opération.	false
VpcId	string	Oui	L'identifiant du VPC pour l'instance d'équilibreur de charge applicatif.	vpc-bp1b49rqrybk45nio****
AddressType	string	Oui	Le type d'adresse de l'équilibreur de charge applicatif. Valeurs valides : Internet : une adresse IP publique est attribuée à l'équilibreur de charge. Son nom de domaine est résolu en l'adresse IP publique, permettant l'accès depuis le réseau public. Intranet : une adresse IP privée est attribuée à l'équilibreur de charge. Son nom de domaine est résolu en l'adresse IP privée, permettant l'accès uniquement depuis le réseau privé du VPC où l'équilibreur de charge est déployé.	Internet
LoadBalancerName	string	Non	Le nom de l'instance d'équilibreur de charge applicatif. Le nom doit comporter de 2 à 128 caractères. Il doit commencer par une lettre, un caractère chinois ou un chiffre, et peut contenir des chiffres, des points (.), des traits de soulignement (_), des tirets (-) et des espaces.	alb1
DeletionProtectionEnabled	boolean	Non	Indique si la protection contre la suppression doit être activée. Valeurs valides : true : active la protection contre la suppression. false (par défaut) : désactive la protection contre la suppression.	false
ModificationProtectionConfig	object	Non	Les paramètres de protection contre les modifications.
Reason	string	Non	La raison de l'activation de la protection contre les modifications. La raison doit comporter de 2 à 128 caractères. Elle doit commencer par une lettre ou un caractère chinois, et peut contenir des chiffres, des points (.), des traits de soulignement (_) et des tirets (-). Remarque Ce paramètre n'est effectif que lorsque Status est défini sur ConsoleProtection.	Instance gérée
Status	string	Non	L'état de protection contre les modifications de l'instance d'équilibreur de charge applicatif. Valeurs valides : NonProtection : la protection contre les modifications est désactivée. Si vous spécifiez une valeur pour Reason, la valeur est effacée. ConsoleProtection : la protection contre les modifications basée sur la console est activée. Si vous spécifiez une valeur pour Reason, la valeur prend effet. Remarque Si vous définissez la valeur sur ConsoleProtection, vous ne pouvez pas modifier l'instance dans la console de l'équilibreur de charge applicatif. Cependant, vous pouvez toujours la modifier en appelant des opérations d'API.	ConsoleProtection
ZoneMappings	array<object>	Oui	Les mappages entre les zones de disponibilité et les sous-réseaux. Vous pouvez spécifier jusqu'à 10 zones de disponibilité. Si la région dispose de deux zones de disponibilité ou plus, vous devez en spécifier au moins deux.
	object	Non	Les mappages entre les zones de disponibilité et les sous-réseaux. Vous pouvez spécifier jusqu'à 10 zones de disponibilité. Si la région dispose de deux zones de disponibilité ou plus, vous devez en spécifier au moins deux.
VSwitchId	string	Oui	L'identifiant du sous-réseau dans la zone de disponibilité spécifiée. Chaque zone de disponibilité ne peut être mappée qu'à un seul sous-réseau.	vsw-sersdf****
ZoneId	string	Oui	L'identifiant de la zone de disponibilité. Vous pouvez appeler l'opération DescribeZones pour interroger les zones disponibles.	cn-hangzhou-a
AllocationId	string	Non	L'identifiant de l'adresse IP élastique (EIP) à associer à l'instance orientée vers Internet.	eip-bp1aedxso6u80u0qf****
EipType	string	Non	Le type d'adresse IP élastique. Valeurs valides : Common (par défaut) : une adresse IP élastique. Anycast : une EIP Anycast. Remarque Pour les régions qui prennent en charge la liaison d'EIP Anycast à une instance d'équilibreur de charge applicatif, consultez Limitations.	Common
IntranetAddress	string	Non	L'adresse IPv4 privée.	192.168.10.1
AddressAllocatedMode	string	Non	Le mode d'allocation d'adresse. Valeurs valides : Fixed (par défaut) : une adresse IP statique est attribuée à chaque zone de disponibilité. Dynamic : une adresse IP est attribuée dynamiquement à chaque zone de disponibilité. Remarque À partir de 00:00:00 le 25 février 2025 (UTC+8), toutes les instances créées en appelant cette API seront des instances ALB améliorées, quel que soit le mode spécifié. Les modes IP ne sont plus distingués et les adresses IP allouées s'adaptent automatiquement. Les instances ALB existantes créées avant la mise à niveau ne sont pas affectées.	Fixed
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	rg-atstuj3rtop****
LoadBalancerEdition	string	Oui	L'édition de l'équilibreur de charge applicatif. Les différentes éditions ont des fonctionnalités et des politiques de facturation différentes. Valeurs valides : Basic : édition de base. Standard : édition standard. StandardWithWaf : édition avec WAF activé.	Standard
LoadBalancerBillingConfig	object	Oui	La configuration de facturation de l'instance d'équilibreur de charge applicatif.
PayType	string	Oui	La méthode de facturation de l'instance. Définissez la valeur sur PostPay pour le paiement à l'usage.	PostPay
BandwidthPackageId	string	Non	L'identifiant du package de bande passante partagée associé à l'instance orientée vers Internet.	cbwp-bp1vevu8h3ieh****
AddressIpVersion	string	Non	La version du protocole. Valeurs valides : IPv4 : IPv4. DualStack : l'instance prend en charge à la fois IPv4 et IPv6.	IPv4
Tag	array<object>	Non	Les balises à ajouter à l'instance.
	object	Non	La structure de la balise.
Key	string	Non	La clé de la balise. La clé peut comporter jusqu'à 128 caractères, ne peut pas commencer par aliyun ou acs:, et ne peut pas contenir http:// ou https://.	env
Value	string	Non	La valeur de la balise. La valeur peut comporter jusqu'à 128 caractères, ne peut pas commencer par aliyun ou acs:, et ne peut pas contenir http:// ou https://.	product
SecurityGroupIds	array<object>	Non	Les identifiants des groupes de sécurité à associer à l'instance.
	object	Non	Les identifiants des groupes de sécurité à associer à l'instance.
SecurityGroupId	string	Non	L'identifiant du groupe de sécurité.	sg-gw82chzr7ru23iwbn9mu

Éléments de réponse

Élément	Type	Description	Exemple
	object	La réponse de la création d'une instance d'équilibreur de charge applicatif.
LoadBalancerId	string	L'identifiant de l'instance d'équilibreur de charge applicatif.	alb-o9ulmq5hqn68jk****
RequestId	string	L'identifiant de la requête.	CEF72CEB-54B6-4AE8-B225-F876FF7BA984

Exemples

JSON format

{
  "LoadBalancerId": "alb-o9ulmq5hqn68jk****",
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	ResourceNotEnough.VSwitchIp	The specified resource %s is not enough.	The specified resource %s is not enough.
400	QuotaExceeded.LoadBalancersNum	The quota of %s is exceeded, usage %s/%s.	The quota of %s is exceeded, usage %s/%s.
400	Mismatch.ZoneIdAndVSwitchId	The %s and %s are mismatched.	The %s and %s are mismatched.
400	DuplicatedParam.ZoneId	The param of ZoneId is duplicated.
400	OperationDenyed.ServiceLinkedRoleNotExist	The service linked role AliyunServiceRoleForAlb does not exist.
404	ResourceNotFound.VSwitch	The specified resource %s is not found.	The specified resource %s is not found.

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

Notes de version

Consultez Notes de version pour la liste complète.