功能介紹
給 彈性伸縮 組配置通知功能。每調(diào)用一次該接口，伸縮組即配置一個通知主題及其通知場景，每個伸縮組最多可以增加5個主題。通知主題由用戶事先在 SMN 創(chuàng)建并進(jìn)行訂閱，當(dāng)通知主題對應(yīng)的通知場景出現(xiàn)時，伸縮組會向用戶的訂閱終端發(fā)送通知。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
PUT /autoscaling-api/v1/{project_id}/scaling_notification/{scaling_group_id}
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
項目ID |
|
scaling_group_id |
是 |
String |
伸縮組ID |
請求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
topic_urn |
是 |
String |
SMN服務(wù)中Topic的唯一的資源標(biāo)識。創(chuàng)建Topic請參考《 消息通知 服務(wù)》的創(chuàng)建Topic。 |
|
topic_scene |
是 |
Array of strings |
通知場景，有以下五種類型。
|
請求示例
創(chuàng)建一個topic_urn為urn:smn:regionId:b53e5554fad0494d96206fb84296510b:gsh的通知，在ID為e5d27f5c-dd76-4a61-b4bc-a67c5686719a的伸縮組擴(kuò)容成功，擴(kuò)容失敗，縮容成功，縮容失敗，伸縮組發(fā)生異常場景下會發(fā)送消息。
PUT https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_notification/e5d27f5c-dd76-4a61-b4bc-a67c5686719a
{
"topic_urn": "urn:smn:regionId:b53e5554fad0494d96206fb84296510b:gsh",
"topic_scene": [
"SCALING_UP","SCALING_UP_FAIL","SCALING_DOWN","SCALING_DOWN_FAIL","SCALING_GROUP_ABNORMAL"
]
}
響應(yīng)參數(shù)
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
topic_urn |
String |
SMN服務(wù)中Topic的唯一的資源標(biāo)識 |
|
topic_scene |
Array of strings |
通知場景，有以下五種類型。
|
|
topic_name |
String |
SMN服務(wù)中Topic的資源名稱。 |
響應(yīng)示例
{
"topic_urn": "urn:smn:regionId:b53e5554fad0494d96206fb84296510b:gsh",
"topic_scene": [
"SCALING_UP","SCALING_UP_FAIL","SCALING_DOWN","SCALING_DOWN_FAIL","SCALING_GROUP_ABNORMAL"
],
"topic_name": "gsh"
}
返回值
- 正常
- 異常
返回值
說明
400 Bad Request
服務(wù)器未能處理請求。
401 Unauthorized
被請求的頁面需要用戶名和密碼。
403 Forbidden
對被請求的頁面訪問禁止。
404 Not Found
服務(wù)器無法找到被請求的頁面。
405 Method Not Allowed
請求中指定的方法不被允許。
406 Not Acceptable
服務(wù)器生成的響應(yīng)無法被客戶端所接受。
407 Proxy Authentication Required
用戶必須首先使用代理服務(wù)器進(jìn)行驗證，這樣請求才會被處理。
408 Request Timeout
請求超出了服務(wù)器的等待時間。
409 Conflict
由于沖突，請求無法被完成。
500 Internal Server Error
請求未完成。服務(wù)異常。
501 Not Implemented
請求未完成。服務(wù)器不支持所請求的功能。
502 Bad Gateway
請求未完成。服務(wù)器從上游服務(wù)器收到一個無效的響應(yīng)。
503 Service Unavailable
請求未完成。系統(tǒng)暫時異常。
504 Gateway Timeout
網(wǎng)關(guān)超時。
錯誤碼
請參考錯誤碼。
