Tüm Ürünler
Search

Bu Ürün

    :CreateLoadBalancer

    Belge Merkezi

    :CreateLoadBalancer

    Son Güncelleme:Sep 30, 2026

    Belirtilen bir bölgede uygulama yük dengeleyici oluşturur.

    Operation description

    CreateLoadBalancer işlemi eşzamansızdır. Başarılı bir çağrı bir örnek kimliği döndürür, ancak uygulama yük dengeleyici örneği arka planda oluşturulur. Uygulama yük dengeleyici örneğinin oluşturma durumunu kontrol etmek için GetLoadBalancerAttribute işlemini çağırın:

    • Örnek provisioning durumundaysa, oluşturulma aşamasındadır.

    • Örnek active durumundaysa, oluşturulmuştur.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    alb:CreateLoadBalancer

    create

    *LoadBalancer

    acs:alb:{#regionId}:{#accountId}:loadbalancer/*
    • alb:AddressType
    		 None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    ClientToken

    string

    No

    İsteğin yinelenemezliğini sağlamak için kullanılan istemci belirteci.

    Her istek için istemcinizden benzersiz bir değer oluşturabilirsiniz. ClientToken parametresi yalnızca ASCII karakterleri destekler.

    Not

    Bu parametreyi atlarsanız, sistem isteğin RequestId değerini ClientToken olarak kullanır.

    5A2CFF0E-5718-45B5-9D4D-70B3FF3898
    DryRun

    boolean

    No

    Deneme çalıştırması yapılıp yapılmayacağını belirtir. Geçerli değerler:

    • true: Uygulama Yük Dengeleyici örneğini oluşturmadan deneme çalıştırması yapar. Sistem gerekli parametreleri, istek biçimini ve hizmet sınırlarını kontrol eder. İstek kontrolü geçemezse bir hata döndürülür. İstek kontrolü geçerse, sistem DryRunOperation hata kodunu döndürür.

    • false (varsayılan): Normal bir istek gönderir. İstek kontrolü geçerse, sistem HTTP 2xx durum kodu döndürür ve işlemi gerçekleştirir.

    false
    VpcId

    string

    Yes

    Uygulama Yük Dengeleyici örneği için VPC'nin kimliği.

    vpc-bp1b49rqrybk45nio****
    AddressType

    string

    Yes

    Uygulama Yük Dengeleyicinin adres türü. Geçerli değerler:

    • Internet: Yük dengeleyiciye genel bir IP adresi atanır. Alan adı, genel ağdan erişime izin verecek şekilde genel IP adresine çözümlenir.

    • Intranet: Yük dengeleyiciye özel bir IP adresi atanır. Alan adı, yalnızca yük dengeleyicinin dağıtıldığı VPC'nin özel ağından erişime izin verecek şekilde özel IP adresine çözümlenir.

    Internet
    LoadBalancerName

    string

    No

    Uygulama Yük Dengeleyici örneğinin adı.

    Ad 2 ila 128 karakter uzunluğunda olmalıdır. Bir harf, Çince karakter veya rakamla başlamalıdır ve rakamlar, noktalar (.), alt çizgiler (_), tireler (-) ve boşluklar içerebilir.

    alb1
    DeletionProtectionEnabled

    boolean

    No

    Silme korumasının etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • true: Silme korumasını etkinleştirir.

    • false (varsayılan): Silme korumasını devre dışı bırakır.

    false
    ModificationProtectionConfig

    object

    No

    Değişiklik koruması ayarları.

    Reason

    string

    No

    Değişiklik korumasını etkinleştirme nedeni.

    Neden 2 ila 128 karakter uzunluğunda olmalıdır. Bir harf veya Çince karakterle başlamalıdır ve rakamlar, noktalar (.), alt çizgiler (_) ve tireler (-) içerebilir.

    Not

    Bu parametre yalnızca Status, ConsoleProtection olarak ayarlandığında geçerlidir.

    Managed Instance
    Status

    string

    No

    Uygulama Yük Dengeleyici örneğinin değişiklik koruması durumu. Geçerli değerler:

    • NonProtection: Değişiklik koruması devre dışıdır. Reason için bir değer belirtirseniz, değer temizlenir.

    • ConsoleProtection: Konsol tabanlı değişiklik koruması etkinleştirilmiştir. Reason için bir değer belirtirseniz, değer etkili olur.

    Not

    Değeri ConsoleProtection olarak ayarlarsanız, örneği Uygulama Yük Dengeleyici konsolunda değiştiremezsiniz. Ancak, API işlemlerini çağırarak yine de değişiklik yapabilirsiniz.

    ConsoleProtection
    ZoneMappings

    array<object>

    Yes

    Kullanılabilirlik bölgeleri ve alt ağlar arasındaki eşlemeler. En fazla 10 kullanılabilirlik bölgesi belirtebilirsiniz. Bölgede iki veya daha fazla kullanılabilirlik bölgesi varsa, en az iki tane belirtmeniz gerekir.

    object

    No

    Kullanılabilirlik bölgeleri ve alt ağlar arasındaki eşlemeler. En fazla 10 kullanılabilirlik bölgesi belirtebilirsiniz. Bölgede iki veya daha fazla kullanılabilirlik bölgesi varsa, en az iki tane belirtmeniz gerekir.

    VSwitchId

    string

    Yes

    Belirtilen kullanılabilirlik bölgesindeki alt ağın kimliği. Her kullanılabilirlik bölgesi yalnızca bir alt ağla eşlenebilir.

    vsw-sersdf****
    ZoneId

    string

    Yes

    Kullanılabilirlik bölgesinin kimliği. Kullanılabilir bölgeleri sorgulamak için DescribeZones işlemini çağırabilirsiniz.

    cn-hangzhou-a
    AllocationId

    string

    No

    Genel ağa açık örnekle ilişkilendirilecek Esnek IP adresinin (EIP) kimliği.

    eip-bp1aedxso6u80u0qf****
    EipType

    string

    No

    Esnek IP adresinin türü. Geçerli değerler:

    • Common (varsayılan): Esnek IP adresi.

    • Anycast: Anycast EIP.

    Not

    Bir Uygulama Yük Dengeleyici örneğine Anycast EIP'leri bağlamayı destekleyen bölgeler için Sınırlamalar sayfasına bakın.

    Common
    IntranetAddress

    string

    No

    Özel IPv4 adresi.

    192.168.10.1
    AddressAllocatedMode

    string

    No

    Adres tahsis modu. Geçerli değerler:

    • Fixed (varsayılan): Her kullanılabilirlik bölgesine statik bir IP adresi atanır.

    • Dynamic: Her kullanılabilirlik bölgesine dinamik olarak bir IP adresi atanır.

    Not

    25 Şubat 2025 saat 00:00:00 (UTC+8) itibarıyla, bu API çağrılarak oluşturulan tüm örnekler, belirttiğiniz moddan bağımsız olarak yükseltilmiş ALB örnekleri olacaktır. IP modları artık ayırt edilmemektedir ve tahsis edilen IP adresleri otomatik olarak ölçeklenir. Yükseltmeden önce oluşturulan mevcut ALB örnekleri etkilenmez.

    Fixed
    ResourceGroupId

    string

    No

    Kaynak grubunun kimliği.

    rg-atstuj3rtop****
    LoadBalancerEdition

    string

    Yes

    Uygulama Yük Dengeleyicinin sürümü. Farklı sürümler farklı özelliklere ve faturalandırma politikalarına sahiptir. Geçerli değerler:

    • Basic: Temel sürüm.

    • Standard: Standart sürüm.

    • StandardWithWaf: WAF etkinleştirilmiş sürüm.

    Standard
    LoadBalancerBillingConfig

    object

    Yes

    Uygulama Yük Dengeleyici örneğinin faturalandırma yapılandırması.

    PayType

    string

    Yes

    Örneğin faturalandırma yöntemi.

    Kullandıkça öde için değeri PostPay olarak ayarlayın.

    PostPay
    BandwidthPackageId

    string

    No

    Genel ağa açık örnekle ilişkilendirilen paylaşılan bant genişliği paketinin kimliği.

    cbwp-bp1vevu8h3ieh****
    AddressIpVersion

    string

    No

    Protokol sürümü. Geçerli değerler:

    • IPv4: IPv4.

    • DualStack: Örnek hem IPv4 hem de IPv6'yı destekler.

    IPv4
    Tag

    array<object>

    No

    Örneğe eklenecek etiketler.

    object

    No

    Etiket yapısı.

    Key

    string

    No

    Etiket anahtarı. Anahtar en fazla 128 karakter uzunluğunda olabilir, aliyun veya acs: ile başlayamaz ve http:// veya https:// içeremez.

    env
    Value

    string

    No

    Etiket değeri. Değer en fazla 128 karakter uzunluğunda olabilir, aliyun veya acs: ile başlayamaz ve http:// veya https:// içeremez.

    product
    SecurityGroupIds

    array<object>

    No

    Örnekle ilişkilendirilecek güvenlik gruplarının kimlikleri.

    object

    No

    Örnekle ilişkilendirilecek güvenlik gruplarının kimlikleri.

    SecurityGroupId

    string

    No

    Güvenlik grubunun kimliği.

    sg-gw82chzr7ru23iwbn9mu

    Response elements

    Element

    Type

    Description

    Example

    object

    Bir Uygulama Yük Dengeleyici örneği oluşturma işleminden alınan yanıt.

    LoadBalancerId

    string

    Uygulama Yük Dengeleyici örnek kimliği.

    alb-o9ulmq5hqn68jk****
    RequestId

    string

    İstek kimliği.

    CEF72CEB-54B6-4AE8-B225-F876FF7BA984

    Examples

    Success response

    JSON format

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

    Error codes

    HTTP status code

    Error code

    Error message

    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.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.