Tüm Ürünler
Search

Bu Ürün

    :CreateLoadBalancer

    Belge Merkezi

    :CreateLoadBalancer

    Son Güncelleme:Oct 02, 2026

    Bir Network Load Balancer (NLB) örneği oluşturur.

    Kullanım notları

    • Bir NLB örneği oluşturduğunuzda hizmete bağlı rol AliyunServiceRoleForNlb otomatik olarak oluşturulur ve size atanır.

    • CreateLoadBalancer eşzamansız bir işlemdir. Bir istek gönderdiğinizde sistem bir örnek kimliği döndürür ve görevi arka planda çalıştırır. Bir NLB örneğinin durumunu sorgulamak için GetLoadBalancerAttribute çağrısı yapabilirsiniz.

      • Bir NLB örneği Provisioning durumunda ise NLB örneği oluşturuluyor demektir.

      • Bir NLB örneği Active durumunda ise NLB örneği oluşturulmuş demektir.

    Hata ayıklama

    OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer içinde çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlemin örnek kodunu dinamik olarak oluşturur.

    İstek parametreleri

    ParametreTürGerekliÖrnekAçıklama
    ActionStringEvetCreateLoadBalancer

    Gerçekleştirmek istediğiniz işlem. Değeri CreateLoadBalancer olarak ayarlayın.

    LoadBalancerTypeStringHayırnetwork

    Örneğin türü. Değeri, bir NLB örneğini belirten network olarak ayarlayın.

    LoadBalancerNameStringHayırNLB1

    NLB örneğinin adı.

    Değer 2 ila 128 karakter uzunluğunda olmalı; harf, rakam, nokta (.), alt çizgi (_) ve tire (-) içerebilir. Değer bir harfle başlamalıdır.

    AddressTypeStringEvetInternet

    NLB örneği tarafından kullanılan IPv4 adresi türü. Geçerli değerler:

    • Internet: NLB örneği genel bir IP adresi kullanır. NLB örneğinin alan adı genel IP adresine çözümlenir. Bu nedenle NLB örneğine İnternet üzerinden erişilebilir.
    • Intranet: NLB örneği özel bir IP adresi kullanır. NLB örneğinin alan adı özel IP adresine çözümlenir. Bu nedenle NLB örneğine, NLB örneğinin dağıtıldığı sanal özel bulut (VPC) üzerinden erişilebilir.
    Not Çift yığınlı bir NLB örneği için genel IPv6'yı etkinleştirmek üzere EnableLoadBalancerIpv6Internet işlemini çağırın.
    AddressIpVersionStringHayıripv4

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

    • ipv4: IPv4. Bu varsayılan değerdir.
    • DualStack: çift yığın
    VpcIdStringEvetvpc-bp1b49rqrybk45nio****

    NLB örneğinin dağıtıldığı VPC'nin kimliği.

    ZoneMappings.N.VSwitchIdStringEvetvsw-sersdf****

    Alandaki vSwitch. Bir NLB örneğinin her alanında yalnızca bir vSwitch (alt ağ) belirtebilirsiniz. En az iki alan eklemeniz gerekir. En fazla 10 alan ekleyebilirsiniz.

    ZoneMappings.N.ZoneIdStringEvetcn-hangzhou-a

    NLB örneğinin alan kimliği. En az iki alan eklemeniz gerekir. En fazla 10 alan ekleyebilirsiniz.

    En güncel alan listesini sorgulamak için DescribeZones işlemini çağırabilirsiniz.

    ZoneMappings.N.PrivateIPv4AddressStringHayır192.168.10.1

    Özel IP adresi. En az iki alan eklemeniz gerekir. En fazla 10 alan ekleyebilirsiniz.

    ZoneMappings.N.AllocationIdStringHayıreip-bp1aedxso6u80u0qf****

    İnternet'e yönelik NLB örneğiyle ilişkilendirilen esnek IP adresinin (EIP) kimliği. Her alan için bir EIP belirtebilirsiniz. En az iki alan eklemeniz gerekir. En fazla 10 alan ekleyebilirsiniz.

    BandwidthPackageIdStringHayırcbwp-bp1vevu8h3ieh****

    İnternet'e yönelik NLB örneğiyle ilişkilendirilen EIP bant genişliği paketinin kimliği.

    LoadBalancerBillingConfig.PayTypeStringHayırPostPay

    NLB örneğinin faturalandırma yöntemi.

    Değeri, kullandıkça öde faturalandırma yöntemini belirten PostPay olarak ayarlayın.

    ResourceGroupIdStringHayırrg-atstuj3rtop****

    Kaynak grubunun kimliği.

    DryRunBooleanHayırfalse

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

    • true: deneme çalıştırması yapar. Sistem gerekli parametreleri, istek sözdizimini ve sınırları kontrol eder. İstek deneme çalıştırmasından başarısız olursa bir hata mesajı döndürülür. İstek deneme çalıştırmasını geçerse DryRunOperation hata kodu döndürülür.
    • false: deneme çalıştırması yapar ve isteği gönderir. İstek deneme çalıştırmasını geçerse 2xx HTTP durum kodu döndürülür ve işlem gerçekleştirilir. Bu varsayılan değerdir.
    ClientTokenStringHayır123e4567-e89b-12d3-a456-426655440000

    İsteğin yinelenebilirliğini sağlamak için kullanmak istediğiniz istemci belirteci.

    Değeri istemci aracılığıyla oluşturabilirsiniz ancak değerin tüm istekler arasında benzersiz olduğundan emin olmanız gerekir. ClientToken değeri yalnızca ASCII karakterleri içerir.

    Not Bu parametreyi ayarlamazsanız sistem otomatik olarak RequestId değerini ClientToken değeri olarak kullanır. Her API isteği için RequestId değeri farklıdır.
    RegionIdStringHayırcn-hangzhou

    NLB örneğinin dağıtıldığı bölgenin kimliği.

    En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

    DeletionProtectionConfig.EnabledBooleanHayırfalse

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

    • true: evet
    • false (varsayılan): hayır
    DeletionProtectionConfig.ReasonStringHayırThe instance is in the Running state.

    Silme koruma özelliğinin etkinleştirilme veya devre dışı bırakılma nedeni. Değer 2 ila 128 karakter uzunluğunda olmalı; harf, rakam, nokta (.), alt çizgi (_) ve tire (-) içerebilir. Değer bir harfle başlamalıdır.

    ModificationProtectionConfig.StatusStringHayırConsoleProtection

    Yapılandırma salt okunur modunun etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • NonProtection: yapılandırma salt okunur modunu etkinleştirmez. Reason parametresini ayarlayamazsınız. Reason parametresi ayarlanırsa değer temizlenir.
    • ConsoleProtection: yapılandırma salt okunur modunu etkinleştirir. Reason parametresini ayarlayabilirsiniz.
    Not Bu parametreyi ConsoleProtection olarak ayarlarsanız NLB konsolunda örnek yapılandırmalarını değiştiremezsiniz. Ancak API işlemlerini çağırarak örnek yapılandırmalarını değiştirebilirsiniz.
    ModificationProtectionConfig.ReasonStringHayırService guarantee period

    Yapılandırma salt okunur modunun etkinleştirilme nedeni. Değer 2 ila 128 karakter uzunluğunda olmalı; harf, rakam, nokta (.), alt çizgi (_) ve tire (-) içerebilir. Değer bir harfle başlamalıdır.

    Not Bu parametre yalnızca Status değeri ConsoleProtection olarak ayarlandığında etkili olur.

    Yanıt parametreleri

    Parametre Tür Örnek Açıklama
    RequestId String CEF72CEB-54B6-4AE8-B225-F876FF7BA984


    İsteğin kimliği.
    LoadbalancerId String nlb-83ckzc8d4xlp8o****


    NLB örneğinin kimliği.
    OrderId Long 20230000


    NLB örneğine ilişkin siparişin kimliği.

    Örnekler

    Örnek istekler

    http(s)://[Endpoint]/?Action=CreateLoadBalancer
&LoadBalancerType=network
&LoadBalancerName=NLB1
&AddressType=Internet
&AddressIpVersion=ipv4
&VpcId=vpc-bp1b49rqrybk45nio****
&ZoneMappings=[{"VSwitchId":"vsw-sersdf****","ZoneId":"cn-hangzhou-a","PrivateIPv4Address":"192.168.10.1","AllocationId":"eip-bp1aedxso6u80u0qf****"}]
&BandwidthPackageId=cbwp-bp1vevu8h3ieh****
&LoadBalancerBillingConfig={"PayType":"PostPay"}
&ResourceGroupId=rg-atstuj3rtop****
&DryRun=false
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&RegionId=cn-hangzhou
&DeletionProtectionConfig={"Enabled":false,"Reason":"The instance is in the Running state."}
&ModificationProtectionConfig={"Status":"ConsoleProtection","Reason":"Service guarantee period"}
&<Common request parameters>

    Başarılı yanıt örnekleri

    XML biçimi

    HTTP/1.1 200 OK
Content-Type:application/xml

<CreateLoadBalancerResponse>
    <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
    <LoadbalancerId>nlb-83ckzc8d4xlp8o****</LoadbalancerId>
    <OrderId>20230000</OrderId>
</CreateLoadBalancerResponse>

    JSON biçimi

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "CEF72CEB-54B6-4AE8-B225-F876FF7BA984",
  "LoadbalancerId" : "nlb-83ckzc8d4xlp8o****",
  "OrderId" : 20230000
}

    Hata kodları

    Hata kodlarının listesi için bkz. Hizmet hata kodları.