ModifyNotificationConfiguration - Auto Scaling - Alibaba Cloud ドキュメントセンター

イベント通知ルールを変更します。イベント通知ルールは、指定した種類のイベントが発生した場合に、CloudMonitor、Message Service (MNS) のトピック、または MNS キューに通知を自動的に送信できます。これにより、スケーリンググループの動向をいち早く把握でき、さらにリソース管理を自動化できます。既存のイベント通知ルールがビジネス要件を満たさない場合は、新しいルールを作成することなく、ModifyNotificationConfiguration API を呼び出してイベント通知ルールを変更できます。この API を呼び出してイベント通知ルールの通知方法を変更することはできない点にご注意ください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ess:ModifyNotificationConfiguration

update

*ScalingGroup

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ScalingGroupId	string	必須	スケーリンググループの ID です。	asg-bp1igpak5ft1flyp****
NotificationArn	string	必須	通知受信者の Alibaba Cloud リソースネーム (ARN) です。このパラメータの値の形式は次のとおりです： CloudMonitor を通知受信者として指定する場合は、`acs:ess:{region-id}:{account-id}:cloudmonitor` 形式で指定します。 Message Service (MNS) のキューを通知受信者として指定する場合は、`acs:mns:{region-id}:{account-id}:queue/{queuename}` 形式で指定します。 MNS トピックを通知受信者として指定する場合は、`acs:mns:{region-id}:{account-id}:topic/{topicname}` 形式で指定します。上記の値の形式に含まれる変数の意味は次のとおりです： region-id：スケーリンググループのリージョン ID です。 account-id：Alibaba Cloud アカウントの ID です。 queuename：MNS キューの名前です。 topicname：MNS トピックの名前です。	acs:ess:cn-beijing:161456884340****:cloudmonitor
NotificationTypes	array	必須	イベントタイプです。
	string	任意	イベントタイプです。有効な値は次のとおりです： AUTOSCALING:SCALE_OUT_SUCCESS：スケールアウトの成功イベント AUTOSCALING:SCALE_IN_SUCCESS：スケールインの成功イベント AUTOSCALING:SCALE_OUT_ERROR：スケールアウトの失敗イベント AUTOSCALING:SCALE_IN_ERROR：スケールインの失敗イベント AUTOSCALING:SCALE_REJECT：スケーリングリクエストの拒否 AUTOSCALING:SCALE_OUT_START：スケールアウトの開始イベント AUTOSCALING:SCALE_IN_START：スケールインの開始イベント AUTOSCALING:SCHEDULE_TASK_EXPIRING：期限切れ間近のスケジュールタスク SCALING_GROUP_DIAGNOSE：スケーリンググループの診断 AUTOSCALING:SCALE_OUT_WARN：スケールアウトの一部成功イベント AUTOSCALING:SCALE_IN_WARN：スケールインの一部成功イベント	AUTOSCALING:SCALE_OUT_SUCCESS
RegionId	string	任意	スケーリンググループのリージョン ID です。	cn-beijing
TimeZone	string	任意	通知のタイムゾーンです。値は UTC で指定します。たとえば、UTC+8 は UTC より 8 時間進んでいることを示し、UTC-7 は UTC より 7 時間遅れていることを示します。	UTC+8
MessageEncoding	string	任意	通知メッセージコンテンツのエンコーディングです。有効な値は次のとおりです： PlainText：エンコードは適用されません。コンテンツはプレーンテキストとして送信されます。 Base64：Base64 エンコードが適用されます。デフォルト値は Base64 です。説明このパラメータは、MNS の通知受信者にのみ設定できます。	PlainText

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエストの ID です。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

例

成功レスポンス

JSONJSON

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

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。