Tüm Ürünler
Search
Belge Merkezi

:UpdateServerGroupAttribute

Son Güncelleme:Oct 02, 2026

Network Load Balancer (NLB) sunucu grubunun yapılandırmasını değiştirir.

Hata Ayıklama

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

İstek parametreleri

ParametreTürGerekliÖrnekAçıklama
ActionStringEvetUpdateServerGroupAttribute

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

ServerGroupIdStringEvetsgp-atstuj3rtoptyui****

Sunucu grubunun kimliği.

ServerGroupNameStringHayırNLB_ServerGroup1

Sunucu grubunun yeni adı.

Ad 2 ila 128 karakter uzunluğunda olmalı ve harfler, rakamlar, noktalar (.), alt çizgiler (_) ve tireler (-) içerebilir. Ad bir harfle başlamalıdır.

ConnectionDrainEnabledBooleanHayırfalse

Bağlantı boşaltmanın etkin olup olmadığını belirtir. Geçerli değerler:

  • true: bağlantı boşaltmayı etkinleştirir.
  • false: bağlantı boşaltmayı devre dışı bırakır.
ConnectionDrainTimeoutIntegerHayır10

Bağlantı boşaltma zaman aşımı süresi. Birim: saniye. Geçerli değerler: 10 ile 900 arasındadır.

SchedulerStringHayırWrr

Zamanlama algoritması. Geçerli değerler:

  • Wrr: Daha yüksek ağırlığa sahip arka uç sunucuları, daha düşük ağırlığa sahip olanlara göre daha fazla istek alır.
  • rr: İstekler arka uç sunucularına sırayla iletilir.
  • sch: Aynı kaynak IP adresinden gelen istekler aynı arka uç sunucusuna iletilir.
  • tch: Dörtlü öğe karma kullanılır. Bu değer; kaynak IP adresi, hedef IP adresi, kaynak bağlantı noktası ve hedef bağlantı noktası olmak üzere dört faktöre dayalı tutarlı karma belirtir. Bu dört faktöre göre aynı bilgileri içeren istekler aynı arka uç sunucusuna iletilir.
  • qch: Aynı QUIC kimliğini içeren istekler aynı arka uç sunucusuna iletilir.
PreserveClientIpEnabledBooleanHayırfalse

İstemci IP korumanın etkin olup olmadığını belirtir. Geçerli değerler:

  • true: istemci IP korumayı etkinleştirir.
  • false: istemci IP korumayı devre dışı bırakır.
HealthCheckConfig.HealthCheckEnabledBooleanHayırfalse

Sağlık denetiminin etkin olup olmadığını belirtir. Geçerli değerler:

  • true: sağlık denetimini etkinleştirir.
  • false: sağlık denetimini devre dışı bırakır.
HealthCheckConfig.HealthCheckTypeStringHayırTCP

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

HealthCheckConfig.HealthCheckConnectPortIntegerHayır0

Sağlık denetimleri için kullanılan arka uç bağlantı noktası. Geçerli değerler: 0 ile 65535 arasındadır. Değeri 0 olarak ayarlarsanız arka uç sunucularının bağlantı noktaları sağlık denetimleri için kullanılır.

HealthCheckConfig.HealthyThresholdIntegerHayır3

Sağlıksız bir arka uç sunucusunun sağlıklı olarak kabul edilmesi için art arda 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 ile 10 arasındadır.

HealthCheckConfig.UnhealthyThresholdIntegerHayır3

Sağlıklı bir arka uç sunucusunun sağlıksız olarak kabul edilmesi 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 ile 10 arasındadır.

HealthCheckConfig.HealthCheckConnectTimeoutIntegerHayır100

Bir sağlık denetimi yanıtının maksimum zaman aşımı süresi. Birim: saniye. Geçerli değerler: 1 ile 300 arasındadır.

HealthCheckConfig.HealthCheckIntervalIntegerHayır5

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

Geçerli değerler: 5 ile 50 arasındadır.

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: belirli bir alan adı. Alan adı 1 ila 80 karakter uzunluğunda olmalı ve küçük harfler, rakamlar, tireler (-) ve noktalar (.) içerebilir.
Not Bu parametre yalnızca HealthCheckType değerini HTTP olarak ayarladığınızda 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 harfler, rakamlar ile şu özel karakterleri içerebilir: - / . % ? # & =. Yol 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ğerini HTTP olarak ayarladığınızda 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ğerini HTTP olarak ayarladığınızda etkili olur.
HealthCheckConfig.HttpCheckMethodStringHayırGET

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

Not Bu parametre yalnızca HealthCheckType değerini HTTP olarak ayarladığınızda etkili olur.
RegionIdStringHayırcn-hangzhou

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

Kullanılabilir bölgeleri sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

DryRunBooleanHayırfalse

Yalnızca isteğin ön kontrolünü yapıp yapmayacağınızı belirtir. Geçerli değerler:

  • true: UpdateServerGroupAttribute işlemini gerçekleştirmeden isteği kontrol eder. Sistem gerekli parametreleri, istek sözdizimini ve sınırlamaları kontrol eder. İstek kontrolü geçemezse bir hata iletisi döndürülür. İstek kontrolü geçerse DryRunOperation hata kodu döndürülür.
  • false (varsayılan): isteği gönderir. İstek kontrolü geçerse 2xx HTTP durum kodu döndürülür ve UpdateServerGroupAttribute işlemi gerçekleştirilir.
ClientTokenStringHayır123e4567-e89b-12d3-a456-426655440000

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

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

Not Bu parametreyi belirtmezseniz sistem ClientToken değerini otomatik olarak RequestId değerine ayarlar. RequestId her API isteği için farklı olabilir.

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=UpdateServerGroupAttribute
&ServerGroupId=sgp-atstuj3rtoptyui****
&ServerGroupName=NLB_ServerGroup1
&ConnectionDrainEnabled=false
&ConnectionDrainTimeout=10
&Scheduler=Wrr
&PreserveClientIpEnabled=false
&HealthCheckConfig={"HealthCheckEnabled":false,"HealthCheckType":"TCP","HealthCheckConnectPort":0,"HealthyThreshold":3,"UnhealthyThreshold":3,"HealthCheckConnectTimeout":100,"HealthCheckInterval":5,"HealthCheckDomain":"$SERVER_IP","HealthCheckUrl":"/test/index.html","HealthCheckHttpCode":["http_2xx"],"HttpCheckMethod":"GET"}
&RegionId=cn-hangzhou
&DryRun=false
&ClientToken=123e4567-e89b-12d3-a456-426655440000
Common request parameters

Örnek başarılı yanıtlar

XML biçimi

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

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

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. Hizmet hata kodları.