CreateNotificationConfiguration - 建立Auto Scaling事件及資源變化通知

更新時間:
Copy as MD

調用API CreateNotificationConfiguration建立Auto Scaling事件及資源變化通知,協助您及時掌握伸縮組的動態,進一步實現Auto Scaling事件的自動化管理。

介面說明

  • 您可以設定由CloudMonitor系統事件、輕量訊息佇列(原 MNS)隊列或輕量訊息佇列(原 MNS)主題接收訊息通知。當伸縮組發生指定類型的伸縮事件或者資源變化時,Auto Scaling會通知CloudMonitor或輕量訊息佇列(原 MNS)。

  • 同一個伸縮組內的不同事件通知不可重複使用同一個接收端。

    例如,不同的事件通知不能同時使用同一個CloudMonitor、同一個 MNS 主題或者同一個 MNS 隊列。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ess:CreateNotificationConfiguration

create

*ScalingGroup

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

請求參數

名稱

類型

必填

描述

樣本值

ScalingGroupId

string

伸縮組的 ID。

asg-bp1igpak5ft1flyp****

NotificationArn

string

通知物件識別碼,設定本參數時支援以下通知方式:

  • CloudMonitor,參數取值格式:acs:ess:{region-id}:{account-id}:cloudmonitor

  • MNS 隊列,參數取值格式:acs:mns:{region-id}:{account-id}:queue/{queuename}

  • MNS 主題,參數取值格式:acs:mns:{region-id}:{account-id}:topic/{topicname}

參數格式中的變數含義如下:

  • region-id:伸縮組所在的地區的 ID。

  • account-id:阿里雲帳號 ID。

  • queuename:MNS 隊列的名稱。

  • topicname:MNS 主題的名稱。

acs:mns:cn-beijing:161456884340****:queue/modifyLifecycleHo****

NotificationTypes

array

一類或者多類Auto Scaling事件及資源變化通知。多個取值使用重複列表的形式。

您可以調用 API DescribeNotificationTypes 介面查詢參數取值。

string

一類或者多類Auto Scaling事件及資源變化通知。多個取值使用重複列表的形式。

您可以調用 API DescribeNotificationTypes 介面查詢參數取值。

AUTOSCALING:SCALE_OUT_SUCCESS

RegionId

string

伸縮組所屬的地區 ID。

cn-beijing

TimeZone

string

訊息通知的時區。 時區相對於國際標準時間的位移量: 如 UTC+8(東八區)、UTC-7(西七區)等。

UTC+8

MessageEncoding

string

訊息通知內容的編碼方式。取值範圍:

  • PlainText:不編碼,採用明文傳輸。

  • Base64:Base 64 編碼。

預設值:Base64。

說明

僅支援 MNS 通知對象設定該參數。

PlainText

返回參數

名稱

類型

描述

樣本值

object

RequestId

string

請求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

樣本

正常返回樣本

JSON格式

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情