az monitor autoscale

リファレンス

自動スケーリング設定を管理します。

コマンド

名前	説明	型	状態
az monitor autoscale create	新しい自動スケール設定を作成します。	コア	GA
az monitor autoscale delete	自動スケール設定を削除します。	コア	GA
az monitor autoscale list	リソースグループの自動スケール設定を一覧表示します。	コア	GA
az monitor autoscale profile	自動スケールプロファイルを管理します。	コア	GA
az monitor autoscale profile create	固定または定期的な自動スケールプロファイルを作成します。	コア	GA
az monitor autoscale profile delete	自動スケールプロファイルを削除します。	コア	GA
az monitor autoscale profile list	自動スケールプロファイルを一覧表示します。	コア	GA
az monitor autoscale profile list-timezones	タイムゾーン情報を検索します。	コア	GA
az monitor autoscale profile show	自動スケールプロファイルの詳細を表示します。	コア	GA
az monitor autoscale rule	自動スケールスケーリングルールを管理します。	コア	GA
az monitor autoscale rule copy	自動スケールルールをプロファイル間でコピーします。	コア	GA
az monitor autoscale rule create	新しい自動スケールルールを追加します。	コア	GA
az monitor autoscale rule delete	プロファイルから自動スケールルールを削除します。	コア	GA
az monitor autoscale rule list	プロファイルの自動スケールルールを一覧表示します。	コア	GA
az monitor autoscale show	自動スケール設定を取得します。	コア	GA
az monitor autoscale show-predictive-metric	予測自動スケーリングメトリックの将来のデータを表示します。	コア	GA
az monitor autoscale update	自動スケール設定を更新します。	コア	GA

az monitor autoscale create

編集

新しい自動スケール設定を作成します。

自動スケールの詳細については、「 https://docs.microsoft.com/azure/monitoring-and-diagnostics/monitoring-understanding-autoscale-settings」を参照してください。

az monitor autoscale create --count
                            --resource
                            [--action]
                            [--disabled {false, true}]
                            [--email-administrator {false, true}]
                            [--email-coadministrators {false, true}]
                            [--location]
                            [--max-count]
                            [--min-count]
                            [--name]
                            [--resource-group]
                            [--resource-namespace]
                            [--resource-parent]
                            [--resource-type]
                            [--scale-look-ahead-time]
                            [--scale-mode {Disabled, Enabled, ForecastOnly}]
                            [--tags]

例

自動スケール設定を作成して、2 ~ 5 インスタンス (既定では 3) の間でスケーリングします。スケーリングの発生時に管理者にメールを送信します。

az monitor autoscale create -g {myrg} --resource {resource-id} --min-count 2 --max-count 5 \
  --count 3 --email-administrator

az monitor autoscale rule create -g {myrg} --autoscale-name {resource-name} --scale out 1 \
  --condition "Percentage CPU > 75 avg 5m"

az monitor autoscale rule create -g {myrg} --autoscale-name {resource-name} --scale in 1 \
  --condition "Percentage CPU < 25 avg 5m"

4 つのインスタンスに対して自動スケール設定を作成します。

az monitor autoscale create -g {myrg} --resource {resource-id} --count 4

新しい自動スケール設定を作成します。 (自動生成)

az monitor autoscale create --count 3 --max-count 5 --min-count 2 --name MyAutoscaleSettings --resource myScaleSet --resource-group MyResourceGroup --resource-type Microsoft.Compute/virtualMachineScaleSets

必須のパラメーター

--count

使用するインスタンスの分子。 --min/max-count と共に使用する場合、使用するインスタンスの既定の数。

--resource

ターゲットリソースの名前または ID。

省略可能のパラメーター

--action -a

スケーリングイベントが発生したときに発生するアクションを追加します。

使用法: --action TYPE KEY [ARG ...]Email: --action email bob@contoso.comann@contoso.com Webhook: --action webhook https://www.contoso.com/alert apiKey=value Webhook: --action webhook https://www.contoso.com/alert?apiKey=value 複数のアクションは、複数の --action 引数を使用して指定できます。

--disabled

自動スケール設定を無効な状態で作成します。

指定可能な値: false, true

--email-administrator

スケーリング時にサブスクリプション管理者に電子メールを送信します。

指定可能な値: false, true

--email-coadministrators

スケーリングについてサブスクリプションの共同管理者に電子メールを送信します。

指定可能な値: false, true

--location -l

Location。値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。

--max-count

インスタンスの最大数。

--min-count

インスタンスの最小数。

--name -n

自動スケール設定の名前。

--resource-group -g

リソースグループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--resource-namespace

ターゲットリソースプロバイダーの名前空間。

--resource-parent

ターゲットリソースの親パス (該当する場合)。

--resource-type

ターゲットリソースの種類。名前空間/型形式 (例: "Microsoft.Compute/virtualMachines") を受け入れることもできます。

--scale-look-ahead-time

事前に起動するインスタンスを指定する時間。 ISO 8601 形式で 1 分から 60 分の間である必要があります (たとえば、100 日は P100D になります)。

--scale-mode

予測自動スケールモード。

指定可能な値: Disabled, Enabled, ForecastOnly

--tags

スペース区切りのタグ: key[=value] [key[=value] ...]既存のタグをクリアするには、"" を使用します。

グローバルパラメーター

--debug

すべてのデバッグログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプメッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。詳細なデバッグログを表示するには --debug を使います。

az monitor autoscale delete

編集

自動スケール設定を削除します。

az monitor autoscale delete [--autoscale-name]
                            [--ids]
                            [--resource-group]
                            [--subscription]

省略可能のパラメーター

--autoscale-name --name -n

自動スケーリング設定の名前。

--ids

1 つまたは複数のリソース ID (スペース区切り)。これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--resource-group -g

リソースグループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

グローバルパラメーター

--debug

すべてのデバッグログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプメッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。詳細なデバッグログを表示するには --debug を使います。

az monitor autoscale list

編集

リソースグループの自動スケール設定を一覧表示します。

az monitor autoscale list --resource-group
                          [--max-items]
                          [--next-token]

必須のパラメーター

--resource-group -g

リソースグループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--max-items

コマンドの出力で返される項目の合計数。使用可能な項目の合計数が指定された値を超える場合は、コマンドの出力にトークンが提供されます。改ページ位置の変更を再開するには、後続のコマンドの引数 --next-token トークン値を指定します。

--next-token

ページ分割を開始する場所を指定するトークン。これは、以前に切り捨てられた応答からのトークン値です。

グローバルパラメーター

--debug

すべてのデバッグログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプメッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。詳細なデバッグログを表示するには --debug を使います。

az monitor autoscale show

編集

自動スケール設定を取得します。

az monitor autoscale show [--autoscale-name]
                          [--ids]
                          [--resource-group]
                          [--subscription]

例

自動スケール設定の詳細を表示します。

az monitor autoscale show --name MyAutoscaleSettings --resource-group MyResourceGroup

省略可能のパラメーター

--autoscale-name --name -n

自動スケーリング設定の名前。

--ids

--resource-group -g

リソースグループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

グローバルパラメーター

--debug

すべてのデバッグログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプメッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。詳細なデバッグログを表示するには --debug を使います。

az monitor autoscale show-predictive-metric

編集

予測自動スケーリングメトリックの将来のデータを表示します。

az monitor autoscale show-predictive-metric --aggregation
                                            --interval
                                            --metric-name
                                            --metric-namespace
                                            --timespan
                                            [--autoscale-setting-name]
                                            [--ids]
                                            [--resource-group]
                                            [--subscription]

必須のパラメーター

--aggregation

取得する集計の種類 (コンマ区切り) の一覧。

--interval

クエリの間隔 (つまり timegrain)。

--metric-name

取得するメトリックの名前 (コンマ区切り)。特殊なケース: メトリック名自体にコンマが含まれる場合は、%2 を使用して指定します。たとえば、'Metric,Name1' は 'Metric%2Name1'にする必要があります。

--metric-namespace

メトリック定義のクエリを実行するメトリック名前空間。

--timespan

クエリの期間。 "startDateTime_ISO/endDateTime_ISO" という形式の文字列です。

省略可能のパラメーター

--autoscale-setting-name

自動スケーリング設定の名前。

--ids

--resource-group -g

リソースグループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

グローバルパラメーター

--debug

すべてのデバッグログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプメッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。詳細なデバッグログを表示するには --debug を使います。

az monitor autoscale update

編集

自動スケール設定を更新します。

自動スケールの詳細については、「 https://docs.microsoft.com/azure/monitoring-and-diagnostics/monitoring-understanding-autoscale-settings」を参照してください。

az monitor autoscale update [--add]
                            [--add-action]
                            [--autoscale-name]
                            [--count]
                            [--email-administrator {0, 1, f, false, n, no, t, true, y, yes}]
                            [--email-coadministrators {0, 1, f, false, n, no, t, true, y, yes}]
                            [--enabled {0, 1, f, false, n, no, t, true, y, yes}]
                            [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                            [--ids]
                            [--max-count]
                            [--min-count]
                            [--remove]
                            [--remove-action]
                            [--resource-group]
                            [--scale-look-ahead-time]
                            [--scale-mode {Disabled, Enabled, ForecastOnly}]
                            [--set]
                            [--subscription]
                            [--tags]

例

既定では、固定の 3 つのインスタンスを使用するように自動スケール設定を更新します。

az monitor autoscale update -g myrg -n autoscale-name --count 3

自動スケール設定を更新して、電子メール通知を削除します。

az monitor autoscale update -g myrg -n autoscale-name --remove-action email bob@contoso.com

自動スケール設定を更新します。

az monitor autoscale update --count 3 --email-administrator true --enabled true --max-count 5 --min-count 2 --name MyAutoscaleSettings --resource-group MyResourceGroup --tags key[=value]

省略可能のパラメーター

--add

パスとキー値のペアを指定して、オブジェクトの一覧にオブジェクトを追加します。例: --add property.listProperty <key=value, string or JSON string>.

--add-action --add-actions -a

スケーリングイベントが発生したときに発生するアクションを追加します。使用法: --add-action TYPE KEY [ARG ...]Email: --add-action email bob@contoso.comann@contoso.com Webhook: --add-action webhook https://www.contoso.com/alert apiKey=value Webhook: --add-action webhook https://www.contoso.com/alert?apiKey=value 複数のアクションを複数の --add-action 引数を使用して指定できます。短縮構文、json-file、yaml-file をサポートします。詳細を表示するには、"??" を試してください。

--autoscale-name --name -n

自動スケーリング設定の名前。

--count

使用するインスタンスの分子。 --min/max-count と共に使用する場合、使用するインスタンスの既定の数。

--email-administrator

スケーリング時にサブスクリプション管理者に電子メールを送信します。

指定可能な値: 0, 1, f, false, n, no, t, true, y, yes

--email-coadministrators

スケーリングについてサブスクリプションの共同管理者に電子メールを送信します。

指定可能な値: 0, 1, f, false, n, no, t, true, y, yes

--enabled

有効なフラグ。リソースに対して自動スケーリングを有効にするかどうかを指定します。既定値は "False" です。

指定可能な値: 0, 1, f, false, n, no, t, true, y, yes

--force-string

'set' または 'add' を使用する場合は、JSON に変換するのではなく、文字列リテラルを保持します。

指定可能な値: 0, 1, f, false, n, no, t, true, y, yes

--ids

--max-count

インスタンスの最大数。

--min-count

インスタンスの最小数。

--remove

リストからプロパティまたは要素を削除します。例: --remove property.list OR --remove propertyToRemove。

--remove-action --remove-actions -r

1 つ以上のアクションを削除します。使用法: --remove-action TYPE KEY [KEY ...]電子メール: --remove-action email bob@contoso.comann@contoso.com Webhook: --remove-action webhook https://contoso.com/alert https://alerts.contoso.com。短縮構文、json-file、yaml-file をサポートします。詳細を表示するには、"??" を試してください。

--resource-group -g

リソースグループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--scale-look-ahead-time

事前に起動するインスタンスを指定する時間。 ISO 8601 形式で 1 分から 60 分の間である必要があります (たとえば、100 日は P100D になります)。

--scale-mode

予測自動スケールモード。

指定可能な値: Disabled, Enabled, ForecastOnly

--set

設定するプロパティパスと値を指定して、オブジェクトを更新します。例: --set property1.property2=。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--tags

リソースを記述しているキーと値のペアの一覧を取得または設定します。これらのタグはリソースグループをまたがってこのリソースを表示およびグループ化する際に使用できます。 1 つのリソースに対して最大 15 個のタグを指定できます。各タグには、キーの長さが 128 文字以下で、値の長さが 256 文字以下である必要があります。短縮構文、json-file、yaml-file をサポートします。詳細を表示するには、"??" を試してください。

グローバルパラメーター

--debug

すべてのデバッグログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプメッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

JMESPath クエリ文字列。詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。詳細なデバッグログを表示するには --debug を使います。

次の方法で共有

az monitor autoscale

コマンド

az monitor autoscale create

例

必須のパラメーター

省略可能のパラメーター

az monitor autoscale delete

省略可能のパラメーター

az monitor autoscale list

必須のパラメーター

省略可能のパラメーター

az monitor autoscale show

例

省略可能のパラメーター

az monitor autoscale show-predictive-metric

必須のパラメーター

省略可能のパラメーター

az monitor autoscale update

例

省略可能のパラメーター

その他のリソース