az monitor autoscale

  • リファレンス

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

コマンド

名前 説明 型 Status
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

場所。 値のソース: 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

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 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

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 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、または JSON 文字列>。

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

スケーリング イベントが発生したときに発生するアクションを追加します。 使用法: --add-action TYPE KEY [ARG ...]電子メール: --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

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

--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.comWebhook: --remove-action webhookhttps://contoso.com/alerthttps://alerts.contoso.com.ann@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 を使います。