UpdateLoadBalancerAddressTypeConfig - - Alibaba Cloud Dokümantasyon Merkezi

Bir Uygulama Yük Dengeleyici (ALB) örneğinin ağ türünü değiştirir.

Operation description

Başlamadan önce:

Bir ALB örneği oluşturdunuz. Daha fazla bilgi için CreateLoadBalancer konusuna bakın.
Bu işlemi kullanarak bir ALB örneğinin ağ türünü özel ağdan genel ağa değiştirmek için önce bir esnek IP adresi (EIP) oluşturmanız gerekir. Daha fazla bilgi için AllocateEipAddress konusuna bakın.

Kullanım notları:

UpdateLoadBalancerAddressTypeConfig asenkron bir işlemdir. Bir istek gönderildikten sonra sistem bir istek kimliği döndürür, ancak ALB örneğinin ağ türü henüz değiştirilmemiştir. Değişiklik işlemi arka planda devam eder. ALB örneğinin ağ türü değişiklik durumunu sorgulamak için GetLoadBalancerAttribute işlemini çağırabilirsiniz:

ALB örneği Configuring durumundaysa, yük dengeleyici örneğinin ağ türü değiştiriliyor.
ALB örneği Active durumundaysa, yük dengeleyici örneğinin ağ türü başarıyla değiştirilmiştir.

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:UpdateLoadBalancerAddressTypeConfig

update

*LoadBalancer

acs:alb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

alb:AddressType

None

Request parameters

Parameter	Type	Required	Description	Example
ClientToken	string	No	İsteğin idempotent olmasını sağlamak için kullanılan istemci belirteci. Bu parametre için istemcinizden benzersiz bir değer oluşturun. ClientToken yalnızca ASCII karakterlerini destekler. Not Bu parametreyi belirtmezseniz, sistem otomatik olarak API isteğinin RequestId değerini ClientToken olarak kullanır. Her API isteğinin RequestId değeri farklı olabilir.	123e4567-e89b-12d3-a456-42665544****
DryRun	string	No	Deneme çalıştırması yapılıp yapılmayacağını belirtir. Geçerli değerler: true: Deneme çalıştırması isteği gönderir. Örneğin ağ türü değiştirilmez. Sistem gerekli parametrelerin belirtilip belirtilmediğini, istek biçiminin geçerli olup olmadığını ve iş limitlerinin karşılanıp karşılanmadığını kontrol eder. Kontrol başarısız olursa ilgili hata döndürülür. Kontrol başarılı olursa DryRunOperation hata kodu döndürülür. false (varsayılan): Normal bir istek gönderir. Kontrol başarılı olursa sistem bir HTTP 2xx durum kodu döndürür ve işlemi gerçekleştirir.	false
LoadBalancerId	string	Yes	Yük dengeleyici örneğinin kimliği.	alb-bp1o94dp5i6ea****
AddressType	string	Yes	Hedef ağ türü. Geçerli değerler: Internet: Yük dengeleyici örneği genel bir IP adresine sahiptir ve DNS etki alanı adı genel IP adresine çözümlenir. Yük dengeleyici örneğine İnternet üzerinden erişilebilir. Intranet: Yük dengeleyici örneği yalnızca özel bir IP adresine sahiptir ve DNS etki alanı adı özel IP adresine çözümlenir. Yük dengeleyici örneğine yalnızca bulunduğu VPC'nin dahili ağ ortamından erişilebilir.	Internet
ZoneMappings	array<object>	No	Bölge ve vSwitch eşlemelerinin listesi. En fazla 10 bölge ekleyebilirsiniz. Mevcut bölge iki veya daha fazla bölgeyi destekliyorsa en az iki bölge eklemeniz gerekir.
	object	No	Bölge ve vSwitch eşleme listesi yapısı.
VSwitchId	string	No	Bölgeye karşılık gelen vSwitch. Her bölge yalnızca bir vSwitch ve bir alt ağ kullanabilir. En fazla 10 bölge ekleyebilirsiniz. Mevcut bölge iki veya daha fazla bölgeyi destekliyorsa en az iki bölge eklemeniz gerekir.	vsw-bp10ttov87felojcn****
ZoneId	string	No	Yük dengeleyici örneğinin bölge kimliği. En fazla 10 bölge ekleyebilirsiniz. Mevcut bölge iki veya daha fazla bölgeyi destekliyorsa en az iki bölge eklemeniz gerekir. Bir bölge kimliğine karşılık gelen etkin bölge bilgilerini sorgulamak için DescribeZones işlemini çağırabilirsiniz.	cn-hangzhou-a
AllocationId	string	No	EIP'nin örnek kimliği. En fazla 10 etkin bölge ekleyebilirsiniz. Not Bu işlemi ağ türünü özel ağdan genel ağa dönüştürmek için çağırdığınızda bu parametre gereklidir.	eip-bp1aedxso6u80u0qf****
EipType	string	No	EIP türü. Geçerli değerler: Common (varsayılan): standart bir EIP. Anycast: bir Anycast EIP. Not Anycast EIP'lerin ALB örneklerine bağlanmasını destekleyen bölgeler için Limits konusuna bakın.	Common
RetainResourceType	array	No	ALB tarafından otomatik olarak oluşturulan ve korunması gereken kaynak türleri. Ayarlar şu anda EIP'leri belirten eip olarak yapılandırılabilir. Otomatik oluşturma ve bağlama işlemleri bu kaynak türleri için geçerlidir.
	string	No	Korunacak kaynak türü. Bu parametreyi bir EIP'yi belirten eip olarak ayarlayabilirsiniz.	eip

Response elements

Element	Type	Description	Example
	object	Yanıt yapısı.
RequestId	string	İstek kimliği.	593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3
JobId	string	Asenkron görevin kimliği.	72dcd26b-f12d-4c27-b3af-18f6aed5****

Examples

Success response

JSON format

{
  "RequestId": "593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3",
  "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****"
}

Error codes

HTTP status code	Error code	Error message
400	OperationDenied.OnlyPostPaidEipSupported	The operation is not allowed because of OnlyPostPaidEipSupported.
400	Mismatch.ZoneIdAndVSwitchId	The ZoneId and VSwitchId are mismatched.
400	IncorrectBusinessStatus.Eip	The business status of %s [%s] is incorrect.
400	ResourceNotFound.Eip	The specified resource ResourceNotFound.Eip is not found.
400	IncorrectStatus.CommonBandwidthPackage	The status of %s [%s] is incorrect.
400	IncorrectBusinessStatus.CommonBandwidthPackage	The business status of %s [%s] is incorrect.
400	OperationDenied.AddressTypeNotChanged	The operation is not allowed because of AddressTypeNotChanged.
400	IncorrectStatus.LoadBalancer	The status of %s [%s] is incorrect.
404	ResourceNotFound.CommonBandwidthPackage	The specified resource %s is not found.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.