Mengaktifkan grup penskalaan. Jika grup penskalaan berada dalam status Disabled dan memiliki sumber konfigurasi instans seperti launch template atau konfigurasi penskalaan, Anda dapat memanggil operasi EnableScalingGroup untuk mengaktifkannya. Operasi ini memungkinkan Auto Scaling menyesuaikan daya komputasi (jumlah instans) dalam grup penskalaan secara dinamis sesuai kebutuhan bisnis Anda.
Catatan penggunaan
Anda hanya dapat memanggil operasi ini untuk mengaktifkan grup penskalaan jika grup tersebut berada dalam status Inactive dan memiliki sumber konfigurasi instans, seperti launch template, konfigurasi penskalaan, atau Instance Elastic Compute Service (ECS) yang ditentukan saat pembuatan grup penskalaan. Jika persyaratan ini tidak terpenuhi, operasi akan gagal.
CatatanGrup penskalaan hanya dapat memiliki satu sumber konfigurasi instans aktif dalam satu waktu. Saat Anda memanggil operasi ini untuk mengaktifkan grup penskalaan, Anda dapat menentukan konfigurasi penskalaan atau launch template. Jika grup penskalaan sudah memiliki konfigurasi instans sebelum pemanggilan, konfigurasi atau launch template yang Anda tentukan dalam permintaan akan menggantikan konfigurasi yang ada.
Jika Anda menentukan InstanceId.N untuk ditambahkan ke grup penskalaan dalam permintaan, Auto Scaling akan memeriksa apakah penambahan tersebut menyebabkan jumlah total Instance ECS berada di luar batas MinSize dan MaxSize setelah operasi dijalankan.
Jika jumlah total Instance ECS turun di bawah nilai MinSize, Auto Scaling secara proaktif membuat Instance ECS pay-as-you-go hingga mencapai ambang batas minimum.
Sebagai contoh, jika MinSize ditetapkan ke 5 saat membuat grup penskalaan dan Anda menyertakan InstanceId.N dalam permintaan untuk menambahkan dua Instance ECS saat mengaktifkan grup penskalaan, Auto Scaling akan membuat tiga Instance ECS tambahan setelah dua instance tersebut ditambahkan.
Jika jumlah total Instance ECS melebihi nilai MaxSize, operasi gagal.
Debugging
Parameter permintaan
Parameter | Tipe | Wajib | Contoh | Deskripsi |
Action | String | Ya | EnableScalingGroup | Operasi yang ingin Anda lakukan. Tetapkan nilainya ke EnableScalingGroup. |
ScalingGroupId | String | Ya | asg-bp14wlu85wrpchm0**** | ID grup penskalaan. |
ActiveScalingConfigurationId | String | Tidak | asc-bp1ffogfdauy0nu5**** | ID konfigurasi penskalaan yang ingin Anda aktifkan dalam grup penskalaan. |
LaunchTemplateId | String | Tidak | lt-m5e3ofjr1zn1aw7**** | ID launch template yang ingin Anda aktifkan dalam grup penskalaan. |
LaunchTemplateVersion | String | Tidak | Default | Nomor versi launch template. Nilai yang valid:
|
InstanceId.N | String | Tidak | i-283vv**** | ID Instance ECS N yang ingin Anda tambahkan ke grup penskalaan setelah grup penskalaan diaktifkan. Nilai N yang valid: 1 hingga 20. Instance ECS N yang ingin Anda tambahkan ke grup penskalaan harus memenuhi persyaratan berikut:
|
LoadBalancerWeight.N | Integer | Tidak | 50 | Bobot Instance ECS N atau instance kontainer elastis N sebagai server backend. Nilai N yang valid: 1 hingga 20. Nilai parameter ini yang valid: 1 hingga 100. Nilai default: 50. |
LaunchTemplateOverride.N.WeightedCapacity | Integer | Tidak | 4 | Bobot tipe instans N. Bobot ini menentukan kapasitas instans dengan tipe instans N dalam grup penskalaan. Jika Anda ingin menskalakan instans dalam grup penskalaan berdasarkan bobot tipe instans N, Anda harus menentukan parameter ini setelah menentukan LaunchTemplateOverride.N.InstanceType. Nilai N pada kedua parameter tersebut harus sama. Bobot yang lebih tinggi berarti jumlah instans tipe instans N yang lebih sedikit diperlukan untuk memenuhi kebutuhan kapasitas yang diharapkan. Metrik kinerja seperti jumlah vCPU dan ukuran memori setiap tipe instans dapat berbeda-beda. Anda dapat menentukan bobot berbeda untuk tipe instans berbeda sesuai kebutuhan bisnis Anda. Contoh:
Untuk memenuhi kebutuhan kapasitas yang diharapkan, Auto Scaling harus melakukan skala keluar dua instans ecs.c5.xlarge. Catatan Kapasitas grup penskalaan selama skala keluar tidak boleh melebihi jumlah maksimum instance yang ditentukan oleh MaxSize ditambah bobot tipe instance maksimum. Nilai WeightedCapacity yang valid dalam InstanceTypeOverride.N.WeightedCapacity: 1 hingga 500. |
RegionId | String | Tidak | cn-qingdao | ID wilayah grup penskalaan. |
Parameter respons
Parameter | Tipe | Contoh | Deskripsi |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** | ID permintaan. |
Contoh
Permintaan Contoh
http(s)://ess.aliyuncs.com/?Action=EnableScalingGroup
&ScalingGroupId=asg-bp14wlu85wrpchm0****
&ActiveScalingConfigurationId=asc-bp1ffogfdauy0nu5****
&LaunchTemplateId=lt-m5e3ofjr1zn1aw7****
&LaunchTemplateVersion=Default
&InstanceId=["i-283vv****"]
&LoadBalancerWeight=[50]
&LaunchTemplateOverride=[{"InstanceType":"ecs.c5.xlarge","WeightedCapacity":4}]
&RegionId=cn-qingdao
&<Common request parameters>Respons Sukses Contoh
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<EnableScalingGroupResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</EnableScalingGroupResponse>JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}Kode kesalahan
Untuk daftar kode kesalahan, lihat Kode Kesalahan Layanan.
Kode Status HTTP | Kode Kesalahan | Pesan Kesalahan | Deskripsi |
404 | InvalidScalingGroupId.NotFound | The specified scaling group does not exist. | Grup penskalaan yang ditentukan tidak ada dalam Akun Alibaba Cloud saat ini. |
403 | Forbidden.Unauthorized | A required authorization for the specified action is not supplied. | Auto Scaling tidak memiliki otorisasi untuk memanggil operasi ini. |
400 | IncorrectScalingGroupStatus | The current status of the specified scaling group does not support this action. | Grup penskalaan yang ditentukan berada dalam status Deleting. |
404 | InvalidScalingConfigurationId.NotFound | The specified scaling configuration does not exist. | Konfigurasi penskalaan yang ditentukan tidak ada dalam grup penskalaan yang ditentukan. |
400 | InvalidScalingConfigurationId.InstanceTypeMismatch | The specified scaling configuration and existing active scaling configuration have different instance type. | Tipe instans dalam konfigurasi penskalaan yang ditentukan berbeda dari tipe instans dalam konfigurasi penskalaan aktif. |
400 | MissingActiveScalingConfiguration | An active scaling configuration for the specified scaling group is not supplied. | Tidak ada konfigurasi penskalaan aktif yang ditentukan untuk grup penskalaan. |
404 | InvalidInstanceId.NotFound | Instance "XXX" does not exist. | Instance ECS yang ditentukan tidak ada dalam Akun Alibaba Cloud saat ini. |
400 | InvalidInstanceId. RegionMismatch | Instance "XXX" and the specified scaling group are not in the same Region. | Instance ECS yang ditentukan dan grup penskalaan tidak berada di wilayah yang sama. |
400 | InvalidInstanceId. InstanceTypeMismatch | Instance "XXX" and existing active scaling configuration have different instance type. | Tipe instans Instance ECS yang ditentukan berbeda dari tipe instans yang ditentukan dalam konfigurasi penskalaan aktif. |
400 | IncorrectInstanceStatus | The current status of instance "XXX" does not support this action. | Instance ECS yang ditentukan tidak berada dalam status Running. |
400 | InvalidInstanceId. NetworkTypeMismatch | The network type of instance "XXX" does not support this action. | Jenis jaringan Instance ECS yang ditentukan tidak sesuai dengan jenis jaringan grup penskalaan. |
400 | InvalidInstanceId.VPCMismatch | Instance "XXX" and the specified scaling group are not in the same VPC. | Grup penskalaan yang ditentukan dan Instance ECS yang ditambahkan tidak berada di VPC yang sama. |
400 | InvalidInstanceId.InUse | Instance "XXX" is already attached to another scaling group. | Instance ECS yang ditentukan telah ditambahkan ke grup penskalaan lain. |
400 | IncorrectLoadBalancerStatus | The current status of the specified load balancer does not support this action. | Load balancer yang ditentukan tidak berada dalam status Active. |
400 | IncorrectLoadBalancerHealthCheck | The current health check type of specified load balancer does not support this action. | Pemeriksaan kesehatan tidak diaktifkan untuk load balancer yang ditentukan. |
400 | InvalidLoadBalancerId.IncorrectInstanceNetworkType | The network type of the instance in specified Load Balancer does not support this action. | Jenis jaringan Instance ECS yang terhubung ke load balancer yang ditentukan berbeda dari jenis jaringan grup penskalaan. |
400 | InvalidLoadBalancerId.VPCMismatch | The specified virtual switch and the instance in specified Load Balancer are not in the same VPC. | Instance ECS yang terhubung ke load balancer yang ditentukan tidak berada di VPC yang sama dengan vSwitch yang ditentukan oleh VSwitchId. |
400 | IncorrectDBInstanceStatus | The current status of DB instance "XXX" does not support this action. | Instance ApsaraDB RDS yang ditentukan tidak berada dalam status Running. |
400 | IncorrectCapacity.MaxSize | To attach the instances, the total capacity will be greater than the max size. | Penambahan jumlah Instance ECS yang ditentukan menyebabkan jumlah total Instance ECS dalam grup penskalaan melebihi nilai MaxSize. |
400 | LaunchTemplateVersionSet.NotFound | The specific version of launch template is not exist. | Versi launch template yang ditentukan tidak ada. |
400 | LaunchTemplateSet.NotFound | The specified launch template set is not found. | Launch template yang ditentukan tidak ada. |
400 | TemplateMissingParameter.ImageId | The input parameter "ImageId" that is mandatory for processing this request is not supplied. | Tidak ada nilai yang ditentukan untuk ImageId yang diperlukan dalam launch template. |
400 | TemplateMissingParameter.InstanceTypes | The input parameter "InstanceTypes" that is mandatory for processing this request is not supplied. | Tidak ada nilai yang ditentukan untuk InstanceTypes yang diperlukan dalam launch template. |
400 | TemplateMissingParameter.SecurityGroup | The input parameter "SecurityGroup" that is mandatory for processing this request is not supplied. | Tidak ada nilai yang ditentukan untuk SecurityGroup yang diperlukan dalam launch template. |
400 | TemplateVersion.NotNumber | The input parameter "LaunchTemplateVersion" is supposed to be a string representing the version number. | Nomor versi tetap yang ditentukan untuk LaunchTemplateVersion mengandung karakter non-digit. |