Todos os produtos
Search
Central de documentação

ENS:CreateLoadBalancer

Última atualização: Jul 23, 2026

Cria uma instância de balanceamento de carga chamando a operação CreateLoadBalancer.

Descrição da operação

  • Frequência de chamadas da API: 100 vezes por segundo.

  • Frequência de chamadas por usuário: 5 vezes por segundo.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ens:CreateLoadBalancer

create

*All Resource

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

EnsRegionId

string

Sim

O ID da zona de borda ENS.

cn-chengdu-telecom.

LoadBalancerSpec

string

Sim

A especificação da instância de balanceamento de carga.

elb.s2.medium.

LoadBalancerName

string

Não

O nome da instância de balanceamento de carga. O nome deve ter de 1 a 80 caracteres e pode conter letras e caracteres chineses. Se você não especificar este parâmetro, o sistema atribuirá automaticamente um nome à instância.

Nota

O nome não pode começar com http:// ou https://.

gcs-pre-websocket-eslb-telecom.

PayType

string

Sim

O tipo de cobrança. PostPaid (atualmente o único tipo suportado): pay-as-you-go.

PostPaid.

NetworkId

string

Sim

O ID da rede da instância de Edge Load Balancing (ELB) a ser criada.

n-5sax03dh2eyagujgsn7z9****

VSwitchId

string

Sim

O ID do vSwitch ao qual a instância VPC pertence.

vsw-5s78haoys9oylle6ln71m****

ClientToken

string

Não

Garante a idempotência da solicitação para evitar operações duplicadas causadas por múltiplas tentativas.

  • Gere um valor de parâmetro a partir do seu cliente e garanta que o valor seja exclusivo em diferentes solicitações. O valor do ClientToken suporta apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento.

  • Se você usar um ClientToken que já foi utilizado anteriormente e os outros parâmetros da solicitação permanecerem inalterados, o cliente receberá o mesmo resultado da primeira submissão, sem impacto no estado do lado do servidor.

  • Você pode tentar novamente quando a API atingir o tempo limite ou retornar o código de erro PROCESSING, e a idempotência entrará em vigor. Se o resultado retornado for um código de status HTTP 200, a nova tentativa retornará o mesmo resultado da chamada anterior, sem impacto no estado do lado do servidor. Se o resultado retornado for um código de status HTTP 4xx e o código de erro não for PROCESSING, a idempotência não entrará em vigor.

  • O ClientToken é válido por 10 minutos.

26C28756-2586-17AF-B802-0DC50D8FDEBB.

BillingCycle

string

Não

O ciclo de cobrança da instância ELB.

Hour.

LoadBalancerType

string

Não

O tipo da instância de Edge Load Balancing.

  • CLB: Instância de Classic Load Balancing.

  • InternetDR: Instância de balanceamento de carga de padrão público.

CLB.

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

1ECC937A-AE0E-4626-BE51-DED1D6D1C888

LoadBalancerId

string

O ID da instância de balanceamento de carga.

lb-5s7crik3yo3bp03gqrbp5****

VSwitchId

string

O ID do vSwitch ao qual a instância de balanceamento de carga pertence.

vsw-5savh5ngxh8sbj14bu7n****

LoadBalancerName

string

O nome da instância de balanceamento de carga.

gcs-pre-websocket-****

NetworkId

string

O ID da rede.

n-5sax03dh2eyagujgsn7z9****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "1ECC937A-AE0E-4626-BE51-DED1D6D1C888",
  "LoadBalancerId": "lb-5s7crik3yo3bp03gqrbp5****",
  "VSwitchId": "vsw-5savh5ngxh8sbj14bu7n****",
  "LoadBalancerName": "gcs-pre-websocket-****",
  "NetworkId": "n-5sax03dh2eyagujgsn7z9****"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidParameter.%s The specified field %s invalid. Please check it again.
400 NoPermission Permission denied.
400 SaleControl.VerificationFailed You did not pass the salecontrol verification.Please contact the product.
400 CallInterface Call Interface Happen Error.
400 OrderFailed Order failed, please try again.
400 SystemUseCouponFailed Failed to use coupon.
400 SystemUseStoredCardFailed Failed to use stored value card.
400 System.SystemError system error.
400 SystemCanRefundCheckFailed The business rule check of the cloud product fails, and this order cannot be refunded.
400 SystemOtsSystem ots storage error.
400 SystemQueryImmortalError Failed to call Juxiange.
400 SystemQueryInstanceInfoFailed Failed to find instance information.
400 SystemResellerPayCalRefundUnitError Ecological payment channel calculation unsubscribe information error.
400 SystemSaleValidateFailed Sales Expression Validation System Error.
400 SystemTransferDeleteOldResourceFailed Failed to delete the transferred instance in the transfer order.
400 SystemUnSupportOperationType Unsupported operation type.
400 RiskRiskControlRejection Risk Control Rejection.
400 AuthRamAuthFailed ram sub-account authentication failed.
400 CommodityInvalidComponent The module you purchased is illegal, please re-select.
400 CommodityInvalidItemCode Specification code illegal.
400 PriceHsfTimeoutError Time out when calling the request for quotation interface.
400 PricePatingConfigError Inquiry related goods configuration error.
400 PricePricingPlanResultNotFound Pricing plan price result not found.
400 PriceRatingGetRatingpricingPlan Obtain a valid pricing plan exception.
400 OrderAbnormalResourceStatusForRenew Invalid resource status for renewal.
400 OrderAccountStatusIllegal Illegal account status.
400 OrderArrearage User Arrears.
400 OrderBidUserOrderForbidden Bid users cannot buy on the official website.
400 OrderCaptureFailed The paid order of the instance has not been deducted successfully.
400 OrderExistsReleasedInstances There are already released instances.
400 OrderGroupOrderSizeOverflow The quantity of bound combined payment order exceeds the limit.
400 OrderHomeCurrencyCanNotDowngrade Users in current currency cannot downgrade.
400 OrderHomeCurrencyCanNotUpgradeByValueTransfer Users of current currency cannot upgrade through residual value transfer.
400 OrderInstanceHasInactiveChange Instances exist temporary upgrade.
400 OrderInstHasUnpaidOrder The instance has an unpaid order.
400 OrderInstHasUnsettledBills The instance has an unsettled bill.
400 OrderLatestOrderIsHandling Recent order is being processed, please try again later.
400 OrderMainOrderSizeOverflow The quantity of the main order exceeds the limit.
400 OrderMissingModuleInfoError Module parameter not specified.
400 OrderNoRealNameAuthentication No real-name authentication.
400 OrderNotFound The specified order information is not found.
400 OrderOpend You have activated this product.
400 OrderPeriodInvalid Illegal order cycle.
400 OrderQuantityInvalid Illegal quantity ordered.
400 OrderQueryInstanceError Query instance error.
400 OrderQueryInstanceNotExists Instance data does not exist.
400 OrderQueryOrderExchangeRateFail Failed to query order exchange rate information.
400 OrderQueryUserSettleInfoFail Failed to query user settlement information.
400 OrderQuotaExceeded Quantity exceeds limit.
400 OrderSysConstraintInvalid System constraint check failed.
400 OrderTradeCompleteSettleInfoFail Failed to complete the order settlement currency amount information.
400 TradeTradeOrderAfterPayCheckError You have already paid for the subsequent orders of this instance. The current order has been automatically voided and you cannot pay any more.
400 PurchaseExistRenewchangeProd There is a renewal change subscription that has not yet taken effect.
400 PurchaseExistToBeValidProdRuleError Currently, there are temporary orders that are not in effect, and the upgrade operation cannot be performed.
400 PurchaseExistToBeValidRenewChangeProdRuleError Currently, there is an uneffective renewal change subscription, and temporary upgrade operation cannot be performed.
400 PurchaseExistValidProdRuleError Currently, there is a temporary order in effect, and operations such as upgrade/downgrade/expansion/pre-transfer cannot be performed.
400 ProductInstanceReleased Instance released.
400 ProductInstanceTypeNotSupported The instance type is not supported.
400 PatRiskRejectForTradeData Payment order problem leads to risk control rejection.
400 PayAccountBookNotExist There is no insufficient account balance in the account book, please retry after recharging.
400 PayAmountLimitExceeded Payment limit exceeded, please resubmit.
400 PayBeforePayRiskRuleValidateFailed The payment was blocked by risk control, and the payment failed.
400 PayCounponNotExist Counpon does not exist.
400 PayCouponAmountNotEnough Insufficient voucher balance or expired.
400 PayCouponNotMeetConsumptionRule The coupon does not meet the conditions for use.
400 PayCurrencyInconsistency Currency mismatch.
400 PayCurrencyNotSupported Currency not supported.
400 PayForbiddenNoReasonFefund Banned five days no reason refund.
400 PayHsfTimeoutError Call payment system timeout.
400 PayInsufficientBalance Account balance is insufficient, please recharge and try again.
400 PayInvalidCreditCard Invalid credit card.
400 PayInvalidPayMethod Illegal payment method.
400 PayMegrePayOrderHasThanOneChagreChannel Payment failed, please retry or submit work order feedback.
400 PayNoCreditCard No valid payment method, please check the payment method and try again.
400 PayOrderPayTimeInvalid Order effective time is invalid.
400 PayPartRefundNotSupport Not Capture, no partial refund.
400 PayPayChannelPayOrderInvalidStatus Illegal status of payment order in payment channel.
400 PayPayChannelPayOrderNotExist Payment channel payment order does not exist.
400 PayPayerAccountIllegal Illegal payment account.
400 PayPayFailedParentRelationchanged If the financial custody relationship changes, please void the order and place a new order for payment.
400 PayPayForbidUserCoupon Coupon prohibited for orders.
400 PayQueryAvailableAmountFailed Failed to query user availability, please try again later.
400 PayQueryAvailableEnduserAmountFailed Failed to query the availability of quota direct customer main user, please try again later.
400 PayQueryParentRelationshipFailed Failed to query current user hosting relationship, please try again later.
400 PayQueryPayChangeChannelNotEqual Multi-order payment channels are inconsistent, please check whether the original order data payment channel is correct.
400 PayRefundFailed Accumulated refund amount exceeds payment order amount.
400 PayResellerPayGetUrlError Order payment failed, please try again later.
400 PayRiskRejectForPayerAccount Payment account problem leads to risk control rejection.
400 PayStoredCardNotExist Stored value card does not exist.
400 PaySystemError Error calling payment system.
400 PayTaxCalcFailed Failed to get user tax address.
400 PayWithholdingAgreementIllegal Withholding Agreement Status Illegal.
400 AccountAliyunAccountFrozen Alibaba Cloud account is frozen.
400 AccountAliyunAccountNotExist Alibaba Cloud account does not exist.
400 RefundRefundInstanceNotFound Unable to find instance information.
400 RefundRefundNoValidProd Refund is not available to unsubscribe.
400 RefundRefundParamInvalid Abnormal refund parameter.
400 RefundRefundQueryOrderFail Failed to query order for refund field.
400 SystemConcurrentOperate Concurrent operation causes failure.
400 PricePricingPlanNotFound Pricing plan tree not found.
400 OrderInstanceHasTempUpgrade Instances exist temporary upgrade.
400 PayQueryParentRelationchangedFailed The financial custody relationship may change, please refresh and pay again.
400 PayforCreditPayInsufficientBalance Insufficient quota, please contact your channel partner to increase the quota.
400 PayforAccountMoneyValidateError The available amount of your channel partner's account is insufficient, please contact your channel partner to recharge in time.
400 BasicInfoUncompleted You have not completed your basic personal information. Please complete the information and re-operate it.
400 Processing Request is in progress, please try again later.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.