AttachInstances - - Alibaba Cloud Dokümantasyon Merkezi

Bir ölçeklendirme grubuna hizmete sunmak için örnekler ekler veya hizmete sunmak üzere Ekonomik Mod'da durdurulan Elastic Compute Service (ECS) örneklerini yeniden başlatır. Ölçeklendirme grubunuza hizmete sunmak amacıyla ECS örnekleri, elastik konteyner örnekleri veya Alibaba Cloud tarafından yönetilen üçüncü taraf örnekler eklemek için AttachInstances işlemini çağırabilirsiniz. Ayrıca, ölçeklendirme grubunuzda Ekonomik Mod'da durdurulan ECS örneklerini hizmete sunmak için yeniden başlatmak amacıyla da bu işlemi çağırabilirsiniz.

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

ess:AttachInstances

update

*ScalingGroup

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

None

Request parameters

Parameter	Type	Required	Description	Example
ScalingGroupId	string	Yes	Ölçeklendirme grubu kimliği.	asg-bp18p2yfxow2dloq****
Entrusted	boolean	No	Elle eklenen örneklerin yaşam döngülerini yönetmek için ölçeklendirme grubunun kullanılıp kullanılmayacağını belirtir. Geçerli değerler: true: Ölçeklendirme grubu, elle eklenen örneklerin ve otomatik olarak oluşturulan örneklerin yaşam döngülerini aynı şekilde yönetir. Bu durumda Auto Scaling, örnekler ölçeklendirme grubundan kaldırıldığında bu örnekleri serbest bırakır. Bu kural, DetachInstances işlemi çağrılarak kaldırılan örnekler için geçerli değildir. false: Ölçeklendirme grubu, elle eklenen örneklerin yaşam döngülerini yönetmez. Bu durumda Auto Scaling, örnekler ölçeklendirme grubundan kaldırıldığında bu örnekleri serbest bırakmaz. Not Bu parametreyi abonelik örnekleri, Alibaba Cloud dışı örnekler ve Ekonomik Moddaki örnekler için belirtemezsiniz. Varsayılan değer: false.	false
InstanceIds	array	No	ECS örneklerinin, elastik konteyner örneklerinin, Alibaba Cloud dışı örneklerin veya Ekonomik Moddaki örneklerin kimlikleri.
	string	No	ECS örneğinin, elastik konteyner örneğinin, Alibaba Cloud dışı örneğin veya Ekonomik Moddaki örneğin kimliği. Örnek kimlikleri: ECS örneği: i-28wt4**. Elastik konteyner örneği: eci-bp17gw49eu09yiwm. Alibaba Cloud dışı örnek: mi-2cx*. Ekonomik Moddaki ECS örneği: i-2cd2f. Not** Her çağrıda bir ölçeklendirme grubuna aynı anda yalnızca aynı türdeki örnekleri ekleyebilirsiniz.	i-28wt4****
LoadBalancerWeights	array	No	Bir ECS örneğinin veya elastik konteyner örneğinin arka uç sunucu olarak ağırlığı. Birden fazla örnek için aynı anda ağırlık belirtmek amacıyla bu parametreyi kullanabilirsiniz.
	integer	No	Bir ECS örneğinin veya elastik konteyner örneğinin arka uç sunucu olarak ağırlığı. Geçerli değerler: 1 ile 100 arası. Not Bu parametreyi abonelik örnekleri ve Ekonomik Moddaki örnekler için belirtemezsiniz. Varsayılan değer: 50.	50
LifecycleHook	boolean	No	Bu işlemi çağırdığınızda ölçek genişletme için yaşam döngüsü kancasının tetiklenip tetiklenmeyeceğini belirtir. Geçerli değerler: true false Not Bu parametreyi abonelik örnekleri ve Ekonomik Moddaki örnekler için belirtemezsiniz. Varsayılan değer: false.	false
RegionId	string	No	Ölçeklendirme grubunun bölge kimliği.	cn-qingdao
ClientToken	string	No	İsteğin idempotent olmasını sağlamak için kullanılan istemci belirteci. Belirteci oluşturmak için istemciyi kullanabilirsiniz, ancak belirtecin farklı istekler arasında benzersiz olduğundan emin olmalısınız. Belirteç yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz. Daha fazla bilgi için bkz. İdempotans sağlama.	123e4567-e89b-12d3-a456-42665544****
IgnoreInvalidInstance	boolean	No	Ölçeklendirme grubuna bir örnek grubu eklendiğinde geçersiz örneklerin yoksayılıp yoksayılmayacağını belirtir. Geçerli değerler: true: Geçersiz örnekleri yoksayar. Geçersiz örnekler varsa ve geçerli örnekler eklenirse, ilgili ölçeklendirme etkinliği Uyarı durumuna geçer. Yoksayılan geçersiz örnekleri görüntülemek için ölçeklendirme etkinliği ayrıntılarını kontrol edebilirsiniz. false: Geçersiz örnekleri yoksaymaz. Ölçeklendirme grubuna eklemek istediğiniz örnek grubunda geçersiz örnekler varsa bir hata raporlanır. Varsayılan değer: false.	false

Response elements

Element	Type	Description	Example
	object
ScalingActivityId	string	Ölçeklendirme etkinliğinin kimliği.	asa-bp1crxor24s28xf1****
RequestId	string	İsteğin kimliği.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Examples

Success response

JSON format

{
  "ScalingActivityId": "asa-bp1crxor24s28xf1****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Error codes

HTTP status code	Error code	Error message	Description
500	InternalError	The request processing has failed due to some unknown error, exception or failure.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.