CreateNotificationConfiguration - Auto Scaling - Alibaba Cloud Documentation Center

Notifikasi event secara otomatis mengirim pesan ke CloudMonitor, topik Message Service (MNS), atau antrian MNS ketika event tertentu terjadi. Fitur ini membantu Anda memantau status grup penskalaan dan mengotomatiskan pengelolaan sumber daya. Jika notifikasi event yang ada tidak lagi memenuhi kebutuhan bisnis Anda, Anda dapat memanggil operasi ModifyNotificationConfiguration untuk memperbarui notifikasi terkait event Auto Scaling dan perubahan sumber daya—tanpa perlu membuat notifikasi baru. Namun, metode notifikasi tidak dapat diubah.

Catatan penggunaan

Anda dapat mengonfigurasi CloudMonitor, antrian MNS, atau topik MNS sebagai penerima notifikasi. Ketika jenis tertentu dari event penskalaan atau perubahan sumber daya terjadi dalam grup penskalaan, Auto Scaling akan mengirim notifikasi ke CloudMonitor atau MNS.
Notifikasi event yang berbeda dalam grup penskalaan yang sama tidak boleh menggunakan penerima yang sama.
Misalnya, notifikasi event yang berbeda tidak boleh menggunakan instans CloudMonitor, topik MNS, atau antrian MNS yang sama.

Debugging

Anda dapat langsung memanggil operasi ini di OpenAPI Explorer. Ini menghemat upaya Anda dalam menghitung signature. Setelah pemanggilan berhasil, OpenAPI Explorer secara otomatis menghasilkan contoh kode SDK.

Parameter permintaan

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateNotificationConfiguration	Parameter yang diperlukan. Tetapkan nilainya ke CreateNotificationConfiguration.
ScalingGroupId	String	Yes	asg-bp1igpak5ft1flyp****	ID grup penskalaan.
NotificationArn	String	Yes	acs:mns:cn-beijing:161456884340**:queue/modifyLifecycleHo**	Nama Sumber Daya Alibaba Cloud (ARN) dari objek notifikasi. Metode notifikasi berikut didukung: CloudMonitor: `acs:ess:{region-id}:{account-id}:cloudmonitor`. Antrian MNS: `acs:mns:{region-id}:{account-id}:queue/{queuename}`. Topik MNS: `acs:mns:{region-id}:{account-id}:topic/{topicname}`. Variabel dalam format di atas dijelaskan sebagai berikut: `region-id`: ID wilayah tempat grup penskalaan berada. `account-id`: ID Akun Alibaba Cloud Anda. `queuename`: Nama antrian MNS. `topicname`: Nama topik MNS.
NotificationType.N	String	No	AUTOSCALING:SCALE_OUT_SUCCESS	Satu atau beberapa jenis notifikasi untuk event Auto Scaling dan perubahan resource. Nilai N dapat berupa bilangan bulat dari 1 hingga 8. Tentukan beberapa nilai dalam daftar berulang. Anda dapat memanggil operasi DescribeNotificationTypes untuk menanyakan nilai valid parameter ini.
RegionId	String	No	cn-beijing	ID wilayah tempat grup penskalaan berada.
TimeZone	String	No	UTC+8	Zona waktu notifikasi. Offset dari Coordinated Universal Time (UTC). Contoh: UTC+8 dan UTC-7.
MessageEncoding	String	No	PlainText	Metode encoding konten notifikasi. Nilai yang valid: PlainText: Konten tidak diencode dan dikirim dalam teks biasa. Base64: Konten diencode dengan Base64. Nilai default: Base64. Catatan Parameter ini hanya dapat diatur untuk notifikasi MNS.

Parameter respons

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	ID permintaan.

Contoh

Contoh permintaan

http(s)://ess.aliyuncs.com/?Action=CreateNotificationConfiguration
&ScalingGroupId=asg-bp1igpak5ft1flyp****
&NotificationArn=acs:mns:cn-beijing:161456884340****:queue/modifyLifecycleHo****
&NotificationType=["AUTOSCALING:SCALE_OUT_SUCCESS"]
&RegionId=cn-beijing
&<Common request parameters>

Contoh respons

XML format

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

<CreateNotificationConfigurationResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</CreateNotificationConfigurationResponse>

JSON format

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Kode kesalahan

Untuk informasi lebih lanjut tentang kode kesalahan, lihat Error Center.

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	InvalidNotificationArn	Parameter notificationArn yang ditentukan tidak valid.	NotificationArn yang ditentukan tidak valid.
400	InvalidNotificationTypes	Jenis notifikasi yang ditentukan tidak valid.	NotificationType.N yang ditentukan tidak valid.
400	NotificationConfigurationExist	Konfigurasi notifikasi yang ditentukan sudah ada untuk scalingGroup tersebut.	Notifikasi event yang ditentukan sudah ada dalam grup penskalaan.
400	NotificationConfigurationQuotaExceed.ForScalingGroup	Jumlah NotificationConfiguration melebihi kuota untuk scalingGroup yang ditentukan.	Jumlah notifikasi yang dikonfigurasi untuk grup penskalaan melebihi kuota.
400	QueueNotExist	Antrian queuename yang ditentukan tidak ada.	Antrian MNS yang ditentukan tidak ada.
400	TopicNotExist	Topik topicname yang ditentukan tidak ada.	Topik MNS yang ditentukan tidak ada.
400	UnsupportedNotificationType.CurrentRegion	NotificationType tidak didukung di wilayah khusus tempat grup penskalaan berada.	Metode notifikasi ini tidak didukung di wilayah saat ini.
400	InvalidParameter.TimeZone	Parameter TimeZone yang ditentukan tidak valid.	Parameter TimeZone yang ditentukan tidak valid.
404	InvalidScalingGroupId.NotFound	Grup penskalaan yang ditentukan tidak ada.	Grup penskalaan yang ditentukan tidak ada.