Tüm Ürünler
Search

Bu Ürün

    :CreateServerGroup

    Belge Merkezi

    :CreateServerGroup

    Son Güncelleme:Oct 02, 2026

    Network Load Balancer (NLB) örneği için bir sunucu grubu oluşturur.

    • protocol parametresi, isteklerin arka uç sunucularına iletilmesinde kullanılan protokolü belirtir.

    • NLB örnekleri yalnızca TCP, UDP veya TCP üzerinden SSL kullanan arka uç sunucu gruplarını destekler.

    • CreateServerGroup eşzamansız bir işlemdir. İsteği gönderdikten sonra, işlem arka planda devam etse bile sistem bir istek kimliği döndürür. Bir sunucu grubunun oluşturma durumunu sorgulamak için GetJobStatus işlemini çağırabilirsiniz.

      • Görev durumu Succeeded ise sunucu grubu oluşturulmuştur.

      • Görev durumu Processing ise sunucu grubu oluşturulmaktadır.

    Hata Ayıklama

    OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kullanım kolaylığı açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için örnek kodları dinamik olarak oluşturur.

    İstek parametreleri

    ParametreTürGerekliÖrnekAçıklama
    ActionStringEvetCreateServerGroup

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

    ServerGroupTypeStringHayırInstance

    Sunucu grubunun türü. Geçerli değerler:

    • Instance: Ecs, Ens veya Eci türünde sunucular eklemenize olanak tanır. Bu varsayılan değerdir.
    • Ip: IP adreslerini belirterek sunucu eklemenize olanak tanır.
    ServerGroupNameStringEvetNLB_ServerGroup

    Sunucu grubunun adı.

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

    AddressIPVersionStringHayıripv4

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

    • ipv4: IPv4. Bu varsayılan değerdir.
    • DualStack: çift yığın.
    ProtocolStringHayırTCP

    İsteklerin arka uç sunucularına iletilmesinde kullanılan protokol. Geçerli değerler:

    • TCP: Bu varsayılan değerdir.
    • UDP
    • TCPSSL
    VpcIdStringEvetvpc-bp15zckdt37pq72zv****

    Sunucu grubunun ait olduğu VPC'nin kimliği.

    Not ServerGroupType değeri Instance olarak ayarlanırsa sunucu grubuna yalnızca belirtilen VPC'deki sunucular eklenebilir.
    AnyPortEnabledBooleanHayırfalse

    Tüm bağlantı noktaları üzerinden iletimin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • true: evet.
    • false: hayır. Bu varsayılan değerdir.
    ConnectionDrainEnabledBooleanHayırfalse

    Bağlantı boşaltmanın etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • true: evet.
    • false: hayır. Bu varsayılan değerdir.
    ConnectionDrainTimeoutIntegerHayır10

    Bağlantı boşaltma zaman aşımı süresi. Birim: saniye.

    Geçerli değerler: 10 ila 900.

    SchedulerStringHayırWrr

    Zamanlama algoritması. Geçerli değerler:

    • Wrr: Ağırlıklı yuvarlak-robin algoritması kullanılır. Daha yüksek ağırlığa sahip arka uç sunucuları, daha düşük ağırlıklı sunuculara göre daha fazla istek alır. Bu varsayılan değerdir.
    • rr: Yuvarlak-robin algoritması kullanılır. İstekler arka uç sunucularına sırayla iletilir.
    • sch: Kaynak IP karma özeti kullanılır. Aynı kaynak IP adresinden gelen istekler aynı arka uç sunucusuna iletilir.
    • tch: Dört öğeli karma özeti kullanılır. Kaynak IP adresi, hedef IP adresi, kaynak bağlantı noktası ve hedef bağlantı noktası olmak üzere dört faktöre dayalı tutarlı karma özeti belirtir. Bu dört faktöre göre aynı bilgileri içeren istekler aynı arka uç sunucusuna iletilir.
    • qch: QUIC ID karma özeti kullanılır. Aynı QUIC ID'yi içeren istekler aynı arka uç sunucusuna iletilir.
    PreserveClientIpEnabledBooleanHayırfalse

    İstemci IP korumanın etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • true: evet.
    • false: hayır. Bu varsayılan değerdir.
    HealthCheckConfig.HealthCheckEnabledBooleanHayırtrue

    Sağlık denetimi özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • true: evet. Bu varsayılan değerdir.
    • false: hayır.
    HealthCheckConfig.HealthCheckTypeStringHayırTCP

    Sağlık denetimlerinde kullanılan protokol. Geçerli değerler: TCP (varsayılan) ve HTTP.

    HealthCheckConfig.HealthCheckConnectPortIntegerHayır0

    Sağlık denetimleri için kullanılan arka uç bağlantı noktası.

    Geçerli değerler: 0 ila 65535.

    Varsayılan değer: 0. Değer 0 olarak ayarlanırsa arka uç sunucusunun bağlantı noktası sağlık denetimleri için kullanılır.

    HealthCheckConfig.HealthyThresholdIntegerHayır2

    Sağlıksız bir arka uç sunucusunun sağlıklı olarak bildirilmesi için art arda başarıyla geçmesi gereken sağlık denetimi sayısı. Bu durumda sağlık durumu fail durumundan success durumuna değişir.

    Geçerli değerler: 2 ila 10.

    Varsayılan değer: 2.

    HealthCheckConfig.UnhealthyThresholdIntegerHayır2

    Sağlıklı bir arka uç sunucusunun sağlıksız olarak bildirilmesi için art arda başarısız olması gereken sağlık denetimi sayısı. Bu durumda sağlık durumu success durumundan fail durumuna değişir.

    Geçerli değerler: 2 ila 10.

    Varsayılan değer: 2.

    HealthCheckConfig.HealthCheckConnectTimeoutIntegerHayır5

    Bir sağlık denetimi yanıtının maksimum zaman aşımı süresi. Birim: saniye.

    Geçerli değerler: 1 ila 300.

    Varsayılan değer: 5.

    HealthCheckConfig.HealthCheckIntervalIntegerHayır10

    Art arda yapılan iki sağlık denetimi arasındaki süre. Birim: saniye.

    Geçerli değerler: 5 ila 50.

    Varsayılan değer: 10.

    HealthCheckConfig.HealthCheckDomainStringHayır$SERVER_IP

    Sağlık denetimleri için kullanılan alan adı. Geçerli değerler:

    • $SERVER_IP: bir arka uç sunucusunun özel IP adresi.
    • domain: sağlık denetimleri için kullanmak istediğiniz alan adı. Alan adı 1 ila 80 karakter uzunluğunda olmalı; küçük harf, rakam, kısa çizgi (-) ve nokta (.) içerebilir.
    Not Bu parametre yalnızca HealthCheckType değeri HTTP olarak ayarlandığında etkili olur.
    HealthCheckConfig.HealthCheckUrlStringHayır/test/index.html

    Sağlık denetimi isteklerinin gönderildiği yol.

    Yol 1 ila 80 karakter uzunluğunda olmalı ve yalnızca harf, rakam ile şu özel karakterleri içerebilir: - / . % ? # & =. Ayrıca şu genişletilmiş karakterleri de içerebilir: _ ; ~ ! ( ) * [ ] @ $ ^ : ' , +. Yol eğik çizgi (/) ile başlamalıdır.

    Not Bu parametre yalnızca HealthCheckType değeri HTTP olarak ayarlandığında etkili olur.
    HealthCheckConfig.HealthCheckHttpCode.NStringHayırhttp_2xx

    Sağlık denetimleri için döndürülecek HTTP durum kodları. Birden çok HTTP durum kodunu virgül (,) ile ayırın.

    Geçerli değerler: http_2xx (varsayılan), http_3xx, http_4xx ve http_5xx.

    Not Bu parametre yalnızca HealthCheckType değeri HTTP olarak ayarlandığında etkili olur.
    HealthCheckConfig.HttpCheckMethodStringHayırGET

    Sağlık denetimlerinde kullanılan HTTP yöntemi. Geçerli değerler: GET (varsayılan) ve HEAD.

    Not Bu parametre yalnızca HealthCheckType değeri HTTP olarak ayarlandığında etkili olur.
    ResourceGroupIdStringHayırrg-atstuj3rtop****

    Sunucu grubunun ait olduğu kaynak grubunun kimliği.

    DryRunBooleanHayırtrue

    Deneme çalıştırmasının 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 geçemezse bir hata iletisi döndürülür. İstek deneme çalıştırmasından 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ından geçerse 2xx HTTP durum kodu döndürülür ve işlem gerçekleştirilir.
    ClientTokenStringHayır123e4567-e89b-12d3-a456-426655440000

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

    Değeri istemci aracılığıyla oluşturabilirsiniz ancak farklı istekler arasında değerin benzersiz olduğundan emin olmalısınız. Belirteç yalnızca ASCII karakterleri içerebilir.

    Not Bu parametreyi ayarlamazsanız sistem otomatik olarak RequestId değerini ClientToken değeri olarak kullanır. RequestId değeri her API isteği için farklı olabilir.
    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.

    Yanıt parametreleri

    Parametre Tür Örnek Açıklama
    RequestId String 54B48E3D-DF70-471B-AA93-08E683A1B45


    İsteğin kimliği.
    ServerGroupId String sgp-atstuj3rtoptyui****


    Sunucu grubunun kimliği.
    JobId String 72dcd26b-f12d-4c27-b3af-18f6aed5****


    Eşzamansız görevin kimliği.

    Örnekler

    Örnek istekler

    http(s)://[Endpoint]/?Action=CreateServerGroup
&ServerGroupType=Instance
&ServerGroupName=NLB_ServerGroup
&AddressIPVersion=ipv4
&Protocol=TCP
&VpcId=vpc-bp15zckdt37pq72zv****
&AnyPortEnabled=false
&ConnectionDrainEnabled=false
&ConnectionDrainTimeout=10
&Scheduler=Wrr
&PreserveClientIpEnabled=false
&HealthCheckConfig={"HealthCheckEnabled":true,"HealthCheckType":"TCP","HealthCheckConnectPort":0,"HealthyThreshold":2,"UnhealthyThreshold":2,"HealthCheckConnectTimeout":5,"HealthCheckInterval":10,"HealthCheckDomain":"$SERVER_IP","HealthCheckUrl":"/test/index.html","HealthCheckHttpCode":["http_2xx"],"HttpCheckMethod":"GET"}
&ResourceGroupId=rg-atstuj3rtop****
&DryRun=true
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&RegionId=cn-hangzhou
&Common request parameters

    Başarılı yanıt örnekleri

    XML biçimi

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

<CreateServerGroupResponse>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B45</RequestId>
    <ServerGroupId>sgp-atstuj3rtoptyui****</ServerGroupId>
    <JobId>72dcd26b-f12d-4c27-b3af-18f6aed5****</JobId>
</CreateServerGroupResponse>

    JSON biçimi

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

{
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "ServerGroupId" : "sgp-atstuj3rtoptyui****",
  "JobId" : "72dcd26b-f12d-4c27-b3af-18f6aed5****"
}

    Hata kodları

    Hata kodlarının listesi için bkz. Service error codes.