Todos os produtos
Search

Este produto

    Server Load Balancer:CreateLoadBalancer

    Central de documentação

    Server Load Balancer:CreateLoadBalancer

    Última atualização: Sep 08, 2026

    Cria uma instância SLB.

    Descrição da operação

    Nota

    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

    slb:CreateLoadBalancer

    create

    *LoadBalancer

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

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    RegionId

    string

    Sim

    O ID da região da instância do Classic Load Balancer (CLB).

    Você pode chamar DescribeRegions para consultar os IDs de região.

    cn-hangzhou
    AddressType

    string

    Não

    O tipo de rede da instância do Classic Load Balancer (CLB). Valores válidos:

    • internet: Após a criação de uma instância SLB voltada para a Internet, o sistema aloca um endereço IP público para a instância para que ela possa encaminhar solicitações da Internet.

    • intranet: Após a criação de uma instância do Server Load Balancer voltada para a rede interna do tipo VPC, o sistema aloca um endereço IP de rede interna para a instância para que ela possa encaminhar apenas solicitações de rede interna.

    internet
    InternetChargeType

    string

    Não

    O método de medição da instância voltada para a Internet. Valores válidos:

    • paybytraffic (padrão): pagamento por transferência de dados.

    • paybybandwidth: pagamento por largura de banda.

    Nota

    • Se PayType estiver definido como PayOnDemand e InstanceChargeType estiver definido como PayByCLCU, este parâmetro suporta apenas paybytraffic.

    • Se você definir este parâmetro como paybytraffic, não precisará definir o parâmetro Bandwidth. Mesmo que você defina o parâmetro Bandwidth, o valor não entrará em vigor.

    paybytraffic
    Bandwidth

    integer

    Não

    A largura de banda máxima da instância. Unidade: Mbit/s.

    Valores válidos: 1 a 5000.

    Nota

    Este parâmetro entra em vigor apenas quando AddressType está definido como internet e InternetChargeType está definido como paybybandwidth.

    10
    ClientToken

    string

    Não

    O token de cliente usado para garantir a idempotência da solicitação.

    Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações.

    Nota

    Se você não especificar este parâmetro, o sistema usará o RequestId da solicitação de API como o ClientToken. O RequestId pode ser diferente para cada solicitação de API.

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

    string

    Não

    O nome da instância do Server Load Balancer.

    O nome deve ter de 1 a 80 caracteres e pode conter letras, dígitos, pontos (.), sublinhados (_) e hifens (-). Deve começar com uma letra ou um caractere chinês.

    Se você não especificar este parâmetro, o sistema alocará automaticamente um nome padrão para a instância.

    lb-bp1o94dp5i6ea****
    VpcId

    string

    Não

    O ID da VPC à qual a instância do Server Load Balancer pertence.

    vpc-bp1aevy8sofi8mh1****
    VSwitchId

    string

    Não

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

    Para criar uma instância do Server Load Balancer do tipo VPC, você deve especificar este parâmetro. Se você especificar este parâmetro, o valor de AddressType será automaticamente definido como intranet.

    Nota

    Certifique-se de que o vSwitch especificado por VSwitchId esteja na mesma zona que a zona primária.

    vsw-bp12mw1f8k3jgy****
    MasterZoneId

    string

    Não

    O ID da zona primária da instância do Server Load Balancer.

    Você pode chamar DescribeZone para consultar as zonas primárias e secundárias em uma região.

    Nota

    Certifique-se de que a zona primária esteja na mesma zona que o vSwitch especificado por VSwitchId.

    cn-hangzhou-b
    SlaveZoneId

    string

    Não

    O ID da zona secundária da instância do Server Load Balancer.

    Você pode chamar DescribeZone para consultar as zonas primárias e secundárias em uma região.

    cn-hangzhou-d
    LoadBalancerSpec

    string

    Não

    A especificação da instância SLB. Valores válidos:

    • slb.s1.small

    • slb.s2.small

    • slb.s2.medium

    • slb.s3.small

    • slb.s3.medium

    • slb.s3.large

    Nota

    • Se InstanceChargeType estiver definido como PayByCLCU, este parâmetro não entrará em vigor e você não precisará especificá-lo.

    • As instâncias do Classic Load Balancer (CLB) com pagamento por especificação não estão mais disponíveis para compra desde 00:00:00 (UTC+8) de 1º de junho de 2025. Para mais detalhes, consulte Aviso sobre a descontinuação das instâncias CLB com pagamento por especificação.

    slb.s1.small
    ResourceGroupId

    string

    Não

    O ID do grupo de recursos corporativos.

    rg-atstuj3rtopt****
    PayType deprecated

    string

    Não

    O método de faturamento da instância. Valores válidos:

    • PayOnDemand: pós-pago.

    PayOnDemand
    PricingCycle deprecated

    string

    Não

    O ciclo de faturamento da instância voltada para a Internet por assinatura. Valores válidos:

    • month

    • year

    Nota

    Este parâmetro é aplicável apenas ao site da China (aliyun.com) e é válido apenas para instâncias por assinatura.

    month
    Duration deprecated

    integer

    Não

    A duração da assinatura da instância voltada para a Internet. Valores válidos:

    • Se PricingCycle estiver definido como month, os valores válidos são de 1 a 9.

    • Se PricingCycle estiver definido como year, os valores válidos são de 1 a 5.

    Nota

    Este parâmetro é aplicável apenas ao site da China (aliyun.com) e é válido apenas para instâncias por assinatura.

    1
    AutoPay deprecated

    boolean

    Não

    Especifica se o pagamento da instância voltada para a Internet por assinatura deve ser feito automaticamente. Valores válidos:

    • true: O pagamento automático é concluído automaticamente. Após chamar esta operação, a instância SLB é criada imediatamente.

    • false (padrão): Após chamar esta operação, o pedido é criado, mas o pagamento automático não é concluído. Você pode visualizar o pedido não pago no console. Como o pedido não foi pago, a instância SLB não é criada.

    Nota

    Este parâmetro é aplicável apenas ao site da China (aliyun.com) e é válido apenas para instâncias por assinatura.

    true
    AddressIPVersion

    string

    Não

    A versão do IP da instância do Server Load Balancer. Valores válidos: ipv4 e ipv6.

    ipv4
    Address

    string

    Não

    O endereço IP privado da instância. O endereço IP deve estar dentro do bloco CIDR do vSwitch.

    192.168.XX.XX
    Tag

    array<object>

    Não

    As tags.

    object

    Não

    As tags.

    Key

    string

    Não

    A chave da tag da instância. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia.

    A chave da tag pode ter até 64 caracteres e não pode começar com aliyun ou acs:. Não pode conter http:// ou https://.

    test
    Value

    string

    Não

    O valor da tag da instância. Valores válidos de N: 1 a 20. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres e não pode começar com aliyun ou acs:. Não pode conter http:// ou https://.

    value
    DeleteProtection

    string

    Não

    Especifica se a proteção contra exclusão deve ser ativada. Valores válidos:

    • on: ativada.

    • off: desativada.

    on
    ModificationProtectionStatus

    string

    Não

    O modo somente leitura de configuração da instância do Classic Load Balancer (CLB). Valores válidos:

    • NonProtection: O modo somente leitura de configuração está desativado. O valor de ModificationProtectionReason é limpo quando você define este valor.

    • ConsoleProtection: O modo somente leitura de configuração está ativado para o console.

    Nota

    Se você definir este parâmetro como ConsoleProtection para ativar o modo somente leitura de configuração, não poderá modificar as configurações da instância no console do Server Load Balancer. No entanto, você pode chamar operações de API para modificar as configurações da instância.

    ConsoleProtection
    ModificationProtectionReason

    string

    Não

    O motivo para ativar o modo somente leitura de configuração. O motivo deve ter de 1 a 80 caracteres e deve começar com uma letra ou um caractere chinês. Pode conter dígitos, pontos (.), sublinhados (_) e hifens (-).

    Nota

    Este parâmetro entra em vigor apenas quando ModificationProtectionStatus está definido como ConsoleProtection.

    Instância gerenciada
    InstanceChargeType

    string

    Não

    O método de faturamento da instância.

    Valores válidos: PayByCLCU: pagamento por uso.

    Nota

    PayBySpec

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    VpcId

    string

    O ID da VPC à qual a instância do Server Load Balancer pertence.

    vpc-25dvzy9****
    AddressIPVersion

    string

    O tipo de endereço IP da instância do Server Load Balancer.

    ipv4
    VSwitchId

    string

    O ID do vSwitch ao qual a instância do Server Load Balancer pertence.

    vsw-255ecr****
    RequestId

    string

    O ID da solicitação.

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

    string

    O nome da instância do Server Load Balancer.

    lb-bp1o94dp5i6ea****
    LoadBalancerId

    string

    O ID da instância do Server Load Balancer.

    lb-hddhfjg****
    ResourceGroupId

    string

    O ID do grupo de recursos.

    rg-atstuj3rto****
    Address

    string

    O endereço IP alocado para a instância SLB.

    42.XX.XX.6
    NetworkType

    string

    O tipo de rede da instância do Server Load Balancer. Valores válidos:

    • vpc: VPC.

    • classic: rede clássica.

    classic
    OrderId

    integer

    O ID do pedido da instância por assinatura.

    20212961978****

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "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
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    400 OperationFailed.ZoneResourceLimit The operation failed because of resource limit of the specified zone. A operação falhou devido a recursos insuficientes na zona atual.
    400 CloudBoxNotSupportIpv6 The cloudBox instance does not support ipv6. As instâncias do CloudBox não suportam IPv6.
    400 CloudBoxNotSupportInternet The cloudBox instance does not support internet. As instâncias do CloudBox não suportam acesso à Internet.
    400 OperationFailed.RegionResourceLimit The operation failed because of resource limit of the specified region. A operação falhou devido a recursos insuficientes na região especificada.
    400 Operation.NotAllowed Operation Denied. The charge type of internet prepay instance can only be paybybandwidth. A operação é restrita. Esta operação não é permitida.
    400 OperationFailed.UnpaidBillsExist The account has unpaid bills. Please pay your overdue bill first. A operação falhou porque sua conta possui faturas não pagas. Pague suas faturas em atraso primeiro.
    400 RegionOrZonesNotSupportIpv6 The specified region or master/slave zones does not support ipv6. A região ou zona primária/secundária especificada não suporta IPv6.
    400 InvalidParameter.Mismatch AddressType and IpVersion is conflict, IPv6 does not support intranet instance. O tipo de rede entra em conflito com a versão do IP. Instâncias SLB voltadas para a rede interna não suportam IPv6.
    400 PAYFOR.CREDIT_PAY_INSUFFICIENT_BALANCE Your account does not have enough balance.
    400 HighRiskOperationDenied The operation is denied because of high risk. A operação foi negada porque a operação atual é de alto risco.
    400 VSwitchAvailableIpNotExist The specified VSwitch has no availabe ip. O vSwitch especificado não possui endereços IP disponíveis.
    400 VSwitchNotExist The specified VSwitch does not exist. O vSwitch especificado não existe.
    400 InvalidParameter Illegal parameter. The IP address is not in subnet. O IP Vgw está vazio. Especifique o parâmetro Vgw ip.
    400 Instance.ShareSlbNotSupportPay95 Illegal parameter. The share instance not support PayBy95 or PayByOld95. As instâncias de recursos compartilhados não suportam PayBy95 ou PayByOld95.
    400 Instance.Pay95RateInvalid Illegal parameter. The rate is illegal. O Rate especificado é inválido. Verifique as restrições do parâmetro e tente novamente.
    400 Instance.Pay95BandwidthIllegal Illegal parameter. The bandwidth is illegal. O Bandwidth especificado é inválido. Verifique as restrições do parâmetro e tente novamente.
    400 Instance.InternetChargeTypeNotAllowed Illegal parameter. The specified InternetChargeType not allowed. O parâmetro é inválido. O InternetChargeType especificado não é suportado.
    400 OperationFailed.TokenIsProcessing The operation is failed, because the Client Token is processing. A operação falhou porque a solicitação atual está sendo processada.
    400 InsufficientBalance Your account does not have enough balance. O saldo da conta é insuficiente. Recarregue sua conta e tente novamente.
    400 MissingParam.VSwitchId The parameter VSwitchId is required. O parâmetro VSwitchId está ausente.
    400 InvalidVpcId.NotExist The specified VPC not exist. A VPC especificada não existe.
    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. O CloudType especificado é inválido. Verifique as restrições do parâmetro e tente novamente após fazer as correções.
    400 OperationFailed.InvalidAccount The account information is incomplete. A operação falhou porque as informações da conta estão incompletas.
    400 RegionOrZonesNotSupportCEN The specified region or master/slave zones does not support cloudType of hybrid_cen. A região ou zona primária/secundária especificada não suporta o CEN.
    400 MissingParam.LoadBalancerSpec The param LoadBalancerSpec is required. O parâmetro LoadBalancerSpec está ausente.
    400 InvalidParameter.Bandwidth The param Bandwidth is invalid. O Bandwidth especificado é inválido. Verifique as restrições do parâmetro e tente novamente.
    400 OperationForbidden.AccountRiskReject The operation failed because of account risk reject. A operação falhou porque a conta atual foi sinalizada pelo controle de riscos.
    400 OperationForbidden.QuotaLimit The operation failed because of quota limit of shared loadbalancers. A operação falhou porque o número de instâncias de recursos compartilhados atingiu o limite de cota.
    400 InvalidParam.ModificationProtectionStatus The param ModificationProtectionStatus is invalid. O ModificationProtectionStatus especificado é inválido. Verifique as restrições do parâmetro e tente novamente após realizar as alterações.
    400 InvalidParam.ModificationProtectionReason The param ModificationProtectionReason is invalid. O ModificationProtectionReason especificado é inválido. Verifique as restrições do parâmetro e tente novamente após realizar as alterações.
    400 ShareSlbHaltSales The share instance has been discontinued. As instâncias SLB de recursos compartilhados estão esgotadas.
    400 OperationFailed.CashBookInsufficient No payment method is specified for your account, We recommend that you add a payment method or maintain a prepayment balance. A operação falhou porque sua conta não possui um método de pagamento especificado. Adicione um método de pagamento ou mantenha um saldo de pré-pagamento.
    400 OperationFailed.OnlyInnerCommoditySupportToPurchase AliCroup2Cloud user only can buy inner commodity. A operação falhou porque os usuários de nuvem corporativa só podem adquirir produtos internos.
    400 OperationFailed.InvokeLingXiaoFailed Failed to invoke lingxiao service. A operação falhou porque a chamada para o serviço Lingxiao falhou.
    400 AllocateVpcInstanceFailed Failed to allocate vpc instance. Falha ao alocar uma instância conectada à VPC.
    400 QueryCreditCtrlInfoFailed Failed to query credit ctrl info. Falha ao consultar as informações do usuário.
    400 QueryCommodityCenterFailed Failed to query commodity center. Falha ao consultar o centro de produtos.
    400 RegionNotSupportParameter Current region does not support the param of %s. O parâmetro especificado não é suportado na região atual.
    400 QueryAccountBookInfoFailed Failed to invoke account book info. Falha ao chamar as informações do livro-razão.
    400 RateAccountFailed Failed to rate account for pricing. Falha ao chamar o serviço de preços.
    400 TradeWaitDistributorAudit The trade needs distributor to audit. Esta transação está pendente de revisão pelo revendedor.
    400 OperationFailed.InvokeProxyFailed Failed to invoke proxy. A operação falhou porque a chamada para o serviço de gerenciamento falhou.
    400 QueryAccountCompleteProgressFailed Failed to query account progress. Falha ao consultar o progresso da conta.
    400 QueryVoucherInfoFailed Failed to query voucher info. Falha ao consultar as informações da credencial.
    400 InvalidVSwitchId.NotFound The specified vSwitch instance is invalid. A instância vSwitch é inválida.
    400 IllegalParam.SpecType The param of SpecType is illegal. O SpecType especificado é inválido. Verifique as restrições do parâmetro e tente novamente.
    400 MissingParam.SpecType The param of SpecType is missing. O parâmetro SpecType está ausente.
    400 UnsupportedRegion The feature is not supported in current region. O recurso de hospedagem de recursos não é suportado na região atual.
    400 PayInsufficientBalance Your account balance is insufficient. O saldo da sua conta é insuficiente.
    400 IllegalParam.InstanceChargeType The parameter InstanceChargeType is illegal.
    400 SystemBusy The system is busy. O sistema está ocupado.
    400 PRODUCT.NOT_AVAILABLE_IZ The Instance zone id doesn t support O ID da zona especificada para a instância não é suportado.
    400 PRICE.INQUIRY_FAILED The instance pricing inquiry is failed. Falha ao consultar o preço da instância.
    400 AssociateIpFail The instance associating ip is failed.
    400 SDK.ServerUnreachable Service is unreachable. O serviço está temporariamente indisponível. Tente novamente mais tarde.
    400 OverQuota The Total is over the quota O número de instâncias excede a cota.
    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. Não há endereços IP disponíveis na sub-rede.
    400 BeforePayRuleBatchValidateError The pre-payment rule center instance rule validation failed. Please check if the instance limit has been reached. A verificação da regra da instância do centro de regras falhou antes do pagamento. Verifique se o limite de instâncias foi atingido.
    400 TradeSyncCreateSubError Subscription transfer failed. A conversão de assinatura falhou. Tente novamente mais tarde.
    400 QueryOrderError Failed to query the order. Please try again later. Falha ao consultar o pedido. Tente novamente mais tarde.
    400 CreateOrderTimeout Order creation timed out. Please try again later. A criação do pedido expirou. Tente novamente mais tarde.
    400 MultiGrayKeyResourceInconsist The identifier for the gray resource is set incorrectly. O identificador do recurso de canary release está configurado incorretamente.
    400 InsufficientAvailableQuota Your account available balance is less than 0. Please recharge before attempting to make a purchase. O saldo da sua conta é inferior a 0. Recarregue sua conta e tente novamente.
    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. Um risco foi detectado no seu método de pagamento. Conclua a verificação usando o link no e-mail ou na mensagem interna. Faça um novo pedido após a conclusão da verificação.

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.