概要
Scalingポリシー(policy)を作成したり変更したりします。ポリシーの実行をリクエストすると、設定されたポリシーに基づいて scale-inまたは scale-out actionを実行します。
リクエスト
リクエストパラメータ
| パラメータ名 | 必須の有無 | タイプ | 制限事項 | 説明 |
|---|---|---|---|---|
| policyName | Yes | String | 最小: 1 最大: 255 |
- スケーリングポリシーの識別子 特定の Auto Scaling Group所属であり、その範囲内ではこの名前で重複して作成不可 Auto Scaling Groupの範囲内でポリシー名がない場合は作成し、既に存在する場合は内容変更が必要 1つの Auto Scaling Groupにつき最大10のポリシーを作成できる |
| autoScalingGroupName | Yes | String | 最小: 1, 最大: 255 | ポリシーが実行されるオートスケーリンググループ名を入力 |
| adjustmentTypeCode | Yes | String | 最小: 1, 最大: 5 | Groupの capacityを調整するタイプコード CHANG(Change In Capacity) EXACT(ExactCapacity)PRCNT(PercentChangeInCapacity) |
| scalingAdjustment | Yes | Integer | 最小: -2147483647, 最大: 2147483647 | スケーリングのための Group capacity調整値 |
| cooldown | No | Integer | 最小: 0, 最大: 2147483647 | スケーリングアクション終了後に cooldown時間中はアラーム通知を受けても無視 |
| minAdjustmentStep | No | Integer | 最小: 1, 最大: 2147483647 | - 最小調整幅(step) adjustmentTypeCodeタイプが PRCNT(PercentChangeInCapacity)の場合にのみ指定可能(指定しないことも可能)PRCNT(PercentChangeInCapacity)タイプの場合、scalingAdjustmentによる変更量が minAdjustmentStep値より小さいと変更量を minAdjustmentStepに設定 |
| responseFormatType | No | String | - レスポンス結果の形式タイプ オプション: xml | json デフォルト: xml |
レスポンス
レスポンスボディ
例
リクエスト例
{AUTOSCALILNG_API_URL}/putScalingPolicy
?adjustmentTypeCode=PRCNT
&autoScalingGroupName=asg-0602b
&cooldown=100
&minAdjustmentStep=2
&policyName=p-0602
&scalingAdjustment=40
レスポンス例
<putScalingPolicyResponse>
<requestId>492648d9-9016-4b29-9773-bc457c2bdefd</requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
</putScalingPolicyResponse>
エラーコード
以下のエラーコードは、このアクション(Action)で発生する特徴的なエラーです。共通して発生するエラーについての詳細説明は、NAVERクラウドプラットフォーム APIをご参照ください。
| HTTP Response Code | リターンコード | リターンメッセージ |
|---|---|---|
| 400 | 50130 | The quota for capacity groups or launch configurations for this customer has already been reached. |