Tous les produits
Search

Ce produit

    :CreateLoadBalancer

    Centre de documentation

    :CreateLoadBalancer

    Dernière mise à jour :Sep 08, 2026

    Crée une instance SLB.

    Description de l'opération

    Remarque

    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.

    slb:CreateLoadBalancer

    create

    *LoadBalancer.

    acs:slb:{#regionId}:{#accountId}:loadbalancer/*
    • slb:AddressType
    		 Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    RegionId

    string

    Oui

    L'identifiant de la région de l'instance Classic Load Balancer (CLB).

    Vous pouvez appeler DescribeRegions pour interroger les identifiants de région.

    cn-hangzhou
    AddressType

    string

    Non

    Le type de réseau de l'instance Classic Load Balancer (CLB). Valeurs valides :

    • internet : après la création d'une instance SLB orientée Internet, le système attribue une adresse IP publique à l'instance afin qu'elle puisse transférer les requêtes provenant d'Internet.

    • intranet : après la création d'une instance Server Load Balancer orientée vers le réseau interne de type VPC, le système attribue une adresse IP de réseau interne à l'instance afin qu'elle puisse uniquement transférer les requêtes du réseau interne.

    internet
    InternetChargeType

    string

    Non

    La méthode de comptage de l'instance orientée Internet. Valeurs valides :

    • paybytraffic (par défaut) : facturation par transfert de données.

    • paybybandwidth : facturation par bande passante.

    Remarque

    • Si PayType est défini sur PayOnDemand et InstanceChargeType sur PayByCLCU, ce paramètre prend uniquement en charge paybytraffic.

    • Si vous définissez ce paramètre sur paybytraffic, vous n'avez pas besoin de définir le paramètre Bandwidth. Même si vous définissez le paramètre Bandwidth, la valeur ne prend pas effet.

    paybytraffic
    Bandwidth

    integer

    Non

    La bande passante maximale de l'instance. Unité : Mbit/s.

    Valeurs valides : 1 à 5000.

    Remarque

    Ce paramètre ne prend effet que lorsque AddressType est défini sur internet et InternetChargeType sur paybybandwidth.

    10
    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 pour chaque requête.

    Remarque

    Si vous ne spécifiez pas ce paramètre, le système utilise le RequestId de la requête API comme ClientToken. Le RequestId peut être différent pour chaque requête API.

    593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3
    LoadBalancerName

    string

    Non

    Le nom de l'instance Server Load Balancer.

    Le nom doit comporter de 1 à 80 caractères et peut contenir des lettres, des chiffres, des points (.), des traits de soulignement (_) et des traits d'union (-). Il doit commencer par une lettre ou un caractère chinois.

    Si vous ne spécifiez pas ce paramètre, le système attribue automatiquement un nom par défaut à l'instance.

    lb-bp1o94dp5i6ea****
    VpcId

    string

    Non

    L'identifiant du VPC auquel l'instance Server Load Balancer appartient.

    vpc-bp1aevy8sofi8mh1****
    VSwitchId

    string

    Non

    L'identifiant du vSwitch auquel l'instance SLB appartient.

    Pour créer une instance Server Load Balancer de type VPC, vous devez spécifier ce paramètre. Si vous spécifiez ce paramètre, la valeur de AddressType est automatiquement définie sur intranet.

    Remarque

    Assurez-vous que le vSwitch spécifié par VSwitchId se trouve dans la même zone que la zone principale.

    vsw-bp12mw1f8k3jgy****
    MasterZoneId

    string

    Non

    L'identifiant de la zone principale de l'instance Server Load Balancer.

    Vous pouvez appeler DescribeZone pour interroger les zones principales et secondaires d'une région.

    Remarque

    Assurez-vous que la zone principale se trouve dans la même zone que le vSwitch spécifié par VSwitchId.

    cn-hangzhou-b
    SlaveZoneId

    string

    Non

    L'identifiant de la zone secondaire de l'instance Server Load Balancer.

    Vous pouvez appeler DescribeZone pour interroger les zones principales et secondaires d'une région.

    cn-hangzhou-d
    LoadBalancerSpec

    string

    Non

    La spécification de l'instance SLB. Valeurs valides :

    • slb.s1.small

    • slb.s2.small

    • slb.s2.medium

    • slb.s3.small

    • slb.s3.medium

    • slb.s3.large

    Remarque

    slb.s1.small
    ResourceGroupId

    string

    Non

    L'identifiant du groupe de ressources d'entreprise.

    rg-atstuj3rtopt****
    PayType deprecated

    string

    Non

    Le mode de facturation de l'instance. Valeurs valides :

    • PayOnDemand : facturation à l'usage.

    PayOnDemand
    PricingCycle deprecated

    string

    Non

    Le cycle de facturation de l'instance orientée Internet par abonnement. Valeurs valides :

    • month

    • year

    Remarque

    Ce paramètre s'applique uniquement au site chinois (aliyun.com) et n'est valide que pour les instances par abonnement.

    month
    Duration deprecated

    integer

    Non

    La durée de l'abonnement de l'instance orientée Internet. Valeurs valides :

    • Si PricingCycle est défini sur month, les valeurs valides sont de 1 à 9.

    • Si PricingCycle est défini sur year, les valeurs valides sont de 1 à 5.

    Remarque

    Ce paramètre s'applique uniquement au site chinois (aliyun.com) et n'est valide que pour les instances par abonnement.

    1
    AutoPay deprecated

    boolean

    Non

    Indique si le paiement automatique de l'instance orientée Internet par abonnement doit être effectué. Valeurs valides :

    • true : le paiement automatique est effectué. Après avoir appelé cette opération, l'instance SLB est immédiatement créée.

    • false (par défaut) : après avoir appelé cette opération, la commande est créée mais le paiement automatique n'est pas effectué. Vous pouvez consulter la commande impayée dans la console. Étant donné que la commande n'est pas payée, l'instance SLB n'est pas créée.

    Remarque

    Ce paramètre s'applique uniquement au site chinois (aliyun.com) et n'est valide que pour les instances par abonnement.

    true
    AddressIPVersion

    string

    Non

    La version IP de l'instance Server Load Balancer. Valeurs valides : ipv4 et ipv6.

    ipv4
    Address

    string

    Non

    L'adresse IP privée de l'instance. L'adresse IP doit se trouver dans le bloc CIDR du vSwitch.

    192.168.XX.XX
    Tag

    array<object>

    Non

    Les balises.

    object

    Non

    Les balises.

    Key

    string

    Non

    La clé de balise de l'instance. 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'à 64 caractères et ne peut pas commencer par aliyun ou acs:. Elle ne peut pas contenir http:// ou https://.

    test
    Value

    string

    Non

    La valeur de balise de l'instance. Valeurs valides de N : 1 à 20. La valeur de balise peut être une chaîne vide. La valeur de balise peut comporter jusqu'à 128 caractères et ne peut pas commencer par aliyun ou acs:. Elle ne peut pas contenir http:// ou https://.

    value
    DeleteProtection

    string

    Non

    Indique si la protection contre la suppression doit être activée. Valeurs valides :

    • on : activée.

    • off : désactivée.

    on
    ModificationProtectionStatus

    string

    Non

    Le mode lecture seule de la configuration de l'instance Classic Load Balancer (CLB). Valeurs valides :

    • NonProtection : le mode lecture seule de la configuration est désactivé. La valeur de ModificationProtectionReason est effacée lorsque vous définissez cette valeur.

    • ConsoleProtection : le mode lecture seule de la configuration est activé pour la console.

    Remarque

    Si vous définissez ce paramètre sur ConsoleProtection pour activer le mode lecture seule de la configuration, vous ne pouvez pas modifier les configurations d'instance dans la console Server Load Balancer. Cependant, vous pouvez appeler des opérations d'API pour modifier les configurations d'instance.

    ConsoleProtection
    ModificationProtectionReason

    string

    Non

    La raison de l'activation du mode lecture seule de la configuration. La raison doit comporter de 1 à 80 caractères et doit commencer par une lettre ou un caractère chinois. Elle peut contenir des chiffres, des points (.), des traits de soulignement (_) et des traits d'union (-).

    Remarque

    Ce paramètre ne prend effet que lorsque ModificationProtectionStatus est défini sur ConsoleProtection.

    Instance gérée
    InstanceChargeType

    string

    Non

    Le mode de facturation de l'instance.

    Valeurs valides : PayByCLCU : facturation à l'utilisation.

    Remarque

    PayBySpec

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    VpcId

    string

    L'identifiant du VPC auquel l'instance Server Load Balancer appartient.

    vpc-25dvzy9****
    AddressIPVersion

    string

    Le type d'adresse IP de l'instance Server Load Balancer.

    ipv4
    VSwitchId

    string

    L'identifiant du vSwitch auquel l'instance Server Load Balancer appartient.

    vsw-255ecr****
    RequestId

    string

    L'identifiant de la requête.

    365F4154-92F6-4AE4-92F8-7FF34B540710
    LoadBalancerName

    string

    Le nom de l'instance Server Load Balancer.

    lb-bp1o94dp5i6ea****
    LoadBalancerId

    string

    L'identifiant de l'instance Server Load Balancer.

    lb-hddhfjg****
    ResourceGroupId

    string

    L'identifiant du groupe de ressources.

    rg-atstuj3rto****
    Address

    string

    L'adresse IP attribuée à l'instance SLB.

    42.XX.XX.6
    NetworkType

    string

    Le type de réseau de l'instance Server Load Balancer. Valeurs valides :

    • vpc : VPC.

    • classic : réseau classique.

    classic
    OrderId

    integer

    L'identifiant de commande de l'instance par abonnement.

    20212961978****

    Exemples

    JSON format

    {
  "VpcId": "vpc-25dvzy9****",
  "AddressIPVersion": "ipv4",
  "VSwitchId": "vsw-255ecr****",
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540710",
  "LoadBalancerName": "lb-bp1o94dp5i6ea****",
  "LoadBalancerId": "lb-hddhfjg****",
  "ResourceGroupId": "rg-atstuj3rto****",
  "Address": "42.XX.XX.6",
  "NetworkType": "classic",
  "OrderId": 0
}

    Codes d'erreur

    Code de statut HTTP

    Code d'erreur

    Message d'erreur

    Description
    400 OperationFailed.ZoneResourceLimit The operation failed because of resource limit of the specified zone. L'opération a échoué en raison de ressources insuffisantes dans la zone actuelle.
    400 CloudBoxNotSupportIpv6 The cloudBox instance does not support ipv6. Les instances CloudBox ne prennent pas en charge IPv6.
    400 CloudBoxNotSupportInternet The cloudBox instance does not support internet. Les instances CloudBox ne prennent pas en charge l'accès à Internet.
    400 OperationFailed.RegionResourceLimit The operation failed because of resource limit of the specified region. L'opération a échoué en raison de ressources insuffisantes dans la région spécifiée.
    400 Operation.NotAllowed Operation Denied. The charge type of internet prepay instance can only be paybybandwidth. L'opération est restreinte. Cette opération n'est pas autorisée.
    400 OperationFailed.UnpaidBillsExist The account has unpaid bills. Please pay your overdue bill first. L'opération a échoué car votre compte présente des factures impayées. Payez d'abord vos factures en retard.
    400 RegionOrZonesNotSupportIpv6 The specified region or master/slave zones does not support ipv6. La région ou la zone principale/secondaire spécifiée ne prend pas en charge IPv6.
    400 InvalidParameter.Mismatch AddressType and IpVersion is conflict, IPv6 does not support intranet instance. Le type de réseau est en conflit avec la version IP. Les instances SLB internes ne prennent pas en charge IPv6.
    400 PAYFOR.CREDIT_PAY_INSUFFICIENT_BALANCE Your account does not have enough balance.
    400 HighRiskOperationDenied The operation is denied because of high risk. L'opération est refusée car l'opération actuelle est une opération à haut risque.
    400 VSwitchAvailableIpNotExist The specified VSwitch has no availabe ip. Le vSwitch spécifié ne dispose d'aucune adresse IP disponible.
    400 VSwitchNotExist The specified VSwitch does not exist. Le vSwitch spécifié n'existe pas.
    400 InvalidParameter Illegal parameter. The IP address is not in subnet. L'adresse IP Vgw est vide. Spécifiez le paramètre Vgw ip.
    400 Instance.ShareSlbNotSupportPay95 Illegal parameter. The share instance not support PayBy95 or PayByOld95. Les instances à ressources partagées ne prennent pas en charge PayBy95 ou PayByOld95.
    400 Instance.Pay95RateInvalid Illegal parameter. The rate is illegal. Le Rate spécifié n'est pas valide. Vérifiez les contraintes des paramètres et réessayez.
    400 Instance.Pay95BandwidthIllegal Illegal parameter. The bandwidth is illegal. Le Bandwidth spécifié n'est pas valide. Vérifiez les contraintes des paramètres et réessayez.
    400 Instance.InternetChargeTypeNotAllowed Illegal parameter. The specified InternetChargeType not allowed. Le paramètre n'est pas valide. L'InternetChargeType spécifié n'est pas pris en charge.
    400 OperationFailed.TokenIsProcessing The operation is failed, because the Client Token is processing. L'opération a échoué car la requête actuelle est en cours de traitement.
    400 InsufficientBalance Your account does not have enough balance. Le solde du compte est insuffisant. Rechargez votre compte et réessayez.
    400 MissingParam.VSwitchId The parameter VSwitchId is required. Le paramètre VSwitchId est manquant.
    400 InvalidVpcId.NotExist The specified VPC not exist. Le VPC spécifié n'existe pas.
    400 PAY.MAYI_WITHHOLDING_AGREEMENT_ILLEGAL Your account did not sign a withholding agreement or no coupons in Alipay.
    400 InvalidParameter.CloudType The specified CloudType is invalid. Le paramètre CloudType spécifié n'est pas valide. Vérifiez les contraintes du paramètre et réessayez après avoir apporté les corrections nécessaires.
    400 OperationFailed.InvalidAccount The account information is incomplete. L'opération a échoué car les informations du compte sont incomplètes.
    400 RegionOrZonesNotSupportCEN The specified region or master/slave zones does not support cloudType of hybrid_cen. La région ou la zone principale/secondaire spécifiée ne prend pas en charge CEN.
    400 MissingParam.LoadBalancerSpec The param LoadBalancerSpec is required. Le paramètre LoadBalancerSpec est manquant.
    400 InvalidParameter.Bandwidth The param Bandwidth is invalid. Le Bandwidth spécifié n'est pas valide. Vérifiez les contraintes des paramètres et réessayez.
    400 OperationForbidden.AccountRiskReject The operation failed because of account risk reject. L'opération a échoué car le compte actuel a été signalé par le contrôle des risques.
    400 OperationForbidden.QuotaLimit The operation failed because of quota limit of shared loadbalancers. L'opération a échoué car le nombre d'instances à ressources partagées a atteint la limite du quota.
    400 InvalidParam.ModificationProtectionStatus The param ModificationProtectionStatus is invalid. Le paramètre ModificationProtectionStatus spécifié n'est pas valide. Vérifiez les contraintes du paramètre et réessayez après avoir apporté les modifications nécessaires.
    400 InvalidParam.ModificationProtectionReason The param ModificationProtectionReason is invalid. Le paramètre ModificationProtectionReason spécifié n'est pas valide. Vérifiez les contraintes du paramètre et réessayez après avoir apporté les modifications nécessaires.
    400 ShareSlbHaltSales The share instance has been discontinued. Les instances SLB à ressources partagées sont épuisées.
    400 OperationFailed.CashBookInsufficient No payment method is specified for your account, We recommend that you add a payment method or maintain a prepayment balance. L'opération a échoué car votre compte ne dispose pas de mode de paiement spécifié. Ajoutez un mode de paiement ou maintenez un solde de prépaiement.
    400 OperationFailed.OnlyInnerCommoditySupportToPurchase AliCroup2Cloud user only can buy inner commodity. L'opération a échoué car les utilisateurs du cloud d'entreprise ne peuvent acheter que des produits internes.
    400 OperationFailed.InvokeLingXiaoFailed Failed to invoke lingxiao service. L'opération a échoué car l'appel au service Lingxiao a échoué.
    400 AllocateVpcInstanceFailed Failed to allocate vpc instance. Échec de l'allocation d'une instance connectée à un VPC.
    400 QueryCreditCtrlInfoFailed Failed to query credit ctrl info. Échec de l'interrogation des informations utilisateur.
    400 QueryCommodityCenterFailed Failed to query commodity center. Échec de l'interrogation du centre des produits.
    400 RegionNotSupportParameter Current region does not support the param of %s. Le paramètre spécifié n'est pas pris en charge dans la région actuelle.
    400 QueryAccountBookInfoFailed Failed to invoke account book info. Échec de l'appel des informations du grand livre.
    400 RateAccountFailed Failed to rate account for pricing. Échec de l'appel au service de tarification.
    400 TradeWaitDistributorAudit The trade needs distributor to audit. Cette transaction est en attente d'examen par le revendeur.
    400 OperationFailed.InvokeProxyFailed Failed to invoke proxy. L'opération a échoué car l'appel au service de gestion a échoué.
    400 QueryAccountCompleteProgressFailed Failed to query account progress. Échec de l'interrogation de la progression du compte.
    400 QueryVoucherInfoFailed Failed to query voucher info. Échec de l'interrogation des informations d'identification.
    400 InvalidVSwitchId.NotFound The specified vSwitch instance is invalid. L'instance vSwitch n'est pas valide.
    400 IllegalParam.SpecType The param of SpecType is illegal. Le SpecType spécifié n'est pas valide. Vérifiez les contraintes des paramètres et réessayez.
    400 MissingParam.SpecType The param of SpecType is missing. Le paramètre SpecType est manquant.
    400 UnsupportedRegion The feature is not supported in current region. La fonctionnalité d'hébergement de ressources n'est pas prise en charge dans la région actuelle.
    400 PayInsufficientBalance Your account balance is insufficient. Le solde de votre compte est insuffisant.
    400 IllegalParam.InstanceChargeType The parameter InstanceChargeType is illegal.
    400 SystemBusy The system is busy. Le système est occupé.
    400 PRODUCT.NOT_AVAILABLE_IZ The Instance zone id doesn t support L'identifiant de zone spécifié de l'instance n'est pas pris en charge.
    400 PRICE.INQUIRY_FAILED The instance pricing inquiry is failed. Échec de l'interrogation de la tarification des instances.
    400 AssociateIpFail The instance associating ip is failed.
    400 SDK.ServerUnreachable Service is unreachable. Le service est temporairement indisponible. Réessayez plus tard.
    400 OverQuota The Total is over the quota Le nombre d'instances dépasse le quota.
    400 InvalidParam.TagValue %s.
    400 InvalidParam.TagKey %s.
    400 SizeLimitExceeded.Tag %s.
    400 MissingParam.TagKey The param MissingParam.TagKey is missing.
    400 SubnetIpExhaust No subnet IP addresses are available. Aucune adresse IP n'est disponible dans le sous-réseau.
    400 BeforePayRuleBatchValidateError The pre-payment rule center instance rule validation failed. Please check if the instance limit has been reached. La vérification de la règle d'instance du centre de règles a échoué avant le paiement. Vérifiez si la limite d'instances a été atteinte.
    400 TradeSyncCreateSubError Subscription transfer failed. La conversion de l'abonnement a échoué. Réessayez plus tard.
    400 QueryOrderError Failed to query the order. Please try again later. Échec de l'interrogation de la commande. Réessayez plus tard.
    400 CreateOrderTimeout Order creation timed out. Please try again later. Le délai de création de la commande a expiré. Réessayez ultérieurement.
    400 MultiGrayKeyResourceInconsist The identifier for the gray resource is set incorrectly. L'identifiant de la ressource de la version canari est mal configuré.
    400 InsufficientAvailableQuota Your account available balance is less than 0. Please recharge before attempting to make a purchase. Le solde de votre compte est inférieur à 0. Rechargez votre compte et réessayez.
    400 Forbidden.AliGroupForbiddenRegion Thre region is forbidden for aligroup user.
    403 SecurityRisk.AuthVerification We have detected a security risk with your payment method. Please proceed with verification via the link in your email or console message and re-submit your order after verification. Un risque a été détecté concernant votre mode de paiement. Effectuez la vérification en utilisant le lien fourni dans l'e-mail ou le message interne. Passez une nouvelle commande une fois la vérification terminée.

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

    Notes de version

    Consultez Notes de version pour la liste complète.