az image
カスタムの仮想マシン イメージを管理する。
コマンド
az image builder |
イメージ ビルダー テンプレートを管理およびビルドします。 |
az image builder cancel |
イメージ テンプレートに基づいて、実行時間の長いイメージ ビルドをキャンセルします。 |
az image builder create |
イメージ ビルダー テンプレートを作成します。 |
az image builder customizer |
イメージ ビルダー テンプレート カスタマイザーを管理する。 |
az image builder customizer add |
イメージ ビルダー カスタマイザーをイメージ ビルダー テンプレートに追加します。 |
az image builder customizer clear |
イメージ ビルダー テンプレートからすべてのイメージ ビルダー カスタマイザーを削除します。 |
az image builder customizer remove |
イメージ ビルダー テンプレートからイメージ ビルダー カスタマイザーを削除します。 |
az image builder delete |
イメージ ビルダー テンプレートを削除します。 |
az image builder list |
イメージ ビルダー テンプレートを一覧表示します。 |
az image builder output |
イメージ ビルダー テンプレート出力ディストリビューターを管理する。 |
az image builder output add |
イメージ ビルダー出力ディストリビューターをイメージ ビルダー テンプレートに追加します。 |
az image builder output clear |
イメージ ビルダー テンプレートからすべてのイメージ ビルダー出力ディストリビューターを削除します。 |
az image builder output remove |
イメージ ビルダー テンプレートからイメージ ビルダー出力ディストリビューターを削除します。 |
az image builder run |
イメージ ビルダー テンプレートを作成します。 |
az image builder show |
イメージ ビルダー テンプレートを表示します。 |
az image builder show-runs |
イメージ ビルダー テンプレートの実行出力を表示します。 |
az image builder update |
イメージ ビルダー テンプレートを更新します。 |
az image builder validator |
イメージ ビルダー テンプレートの検証を管理します。 |
az image builder validator add |
既存のイメージ ビルダー テンプレートに検証を追加します。 |
az image builder validator remove |
既存のイメージ ビルダー テンプレートから検証を削除します。 |
az image builder validator show |
既存のイメージ ビルダー テンプレートの検証を表示します。 |
az image builder wait |
テンプレートの条件が満たされるまで、CLI を待機状態にします。 |
az image copy |
マネージド イメージ (または VM) を他のリージョンにコピーします。 ソース ディスクを使用できる必要があります。 |
az image create |
マネージド ディスクまたはスナップショットからカスタム仮想マシン イメージを作成します。 |
az image delete |
イメージを削除します。 |
az image list |
カスタム VM イメージを一覧表示します。 |
az image show |
イメージを取得します。 |
az image update |
カスタム VM イメージを更新します。 |
az image copy
マネージド イメージ (または VM) を他のリージョンにコピーします。 ソース ディスクを使用できる必要があります。
az image copy --source-object-name
--source-resource-group
--target-location
--target-resource-group
[--cleanup]
[--export-as-snapshot]
[--parallel-degree]
[--source-type {image, vm}]
[--tags]
[--target-name]
[--target-subscription]
[--temporary-resource-group-name]
[--timeout]
例
イメージを複数のリージョンにコピーし、最後にクリーンアップします。
az image copy --source-resource-group mySources-rg --source-object-name myImage \
--target-location uksouth northeurope --target-resource-group "images-repo-rg" --cleanup
既に一般化された VM を使用して、他のリージョンにイメージを作成します。
az image copy --source-resource-group mySources-rg --source-object-name myVm \
--source-type vm --target-location uksouth northeurope --target-resource-group "images-repo-rg"
必須のパラメーター
イメージまたは VM リソースの名前。
ソース リソースのリソース グループの名前。
画像を作成するためのスペース区切りの場所リスト (westeurope など)。
イメージを作成するリソース グループの名前。
省略可能のパラメーター
完了時に一時的なリソースを削除するには、このスイッチを含めます。
コピーをイメージではなくスナップショットとしてエクスポートするには、このスイッチを含めます。
並列コピー操作の数。
イメージまたは VM。
スペース区切りのタグ: key[=value] [key[=value] ...]。"" を使用して既存のタグをクリアします。
作成される最終的なイメージの名前。
最終的なイメージを作成するサブスクリプションの名前または ID。
一時ストレージ アカウントが作成されるリソース グループ名。 --temporary_resource_group_name は 0.2.7 で非推奨になります。
コピー操作が完了するまでの時間 (秒)。 512 GB 以上のような大きなイメージ (ディスク) をコピーする場合は、この時間を増やします。
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az image create
マネージド ディスクまたはスナップショットからカスタム仮想マシン イメージを作成します。
az image create --name
--resource-group
--source
[--data-disk-caching {None, ReadOnly, ReadWrite}]
[--data-disk-sources]
[--edge-zone]
[--hyper-v-generation {V1, V2}]
[--location]
[--os-disk-caching {None, ReadOnly, ReadWrite}]
[--os-type {Linux, Windows}]
[--storage-sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
[--tags]
[--zone-resilient {false, true}]
例
既存のディスクからイメージを作成します。
az image create -g MyResourceGroup -n image1 --os-type Linux \
--source /subscriptions/db5eb68e-73e2-4fa8-b18a-0123456789999/resourceGroups/rg1/providers/Microsoft.Compute/snapshots/s1
同じリソース グループ内の既存の一般化された仮想マシンをキャプチャして、イメージを作成します。
az image create -g MyResourceGroup -n image1 --source MyVm1
必須のパラメーター
新しいイメージ名。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
仮想マシン ID または名前、OS ディスク BLOB URI、マネージド OS ディスク ID または名前、OS スナップショット ID または名前など、同じリージョンの OS ディスク ソース。
省略可能のパラメーター
イメージのデータ ディスクのストレージ キャッシュの種類。
アンマネージド BLOB URI、マネージド ディスク ID または名前、スナップショット ID または名前など、データ ディスク ソースの領域で区切られたリスト。
エッジ ゾーンの名前。
イメージから作成された仮想マシンのハイパーバイザーの生成。
場所。 値のソース: az account list-locations
az configure --defaults location=<location>
を使用して、既定の場所を構成できます。
イメージの OS ディスクのストレージ キャッシュの種類。
VM イメージを作成するストレージ アカウントの SKU。 ソース VM が指定されている場合は使用されません。
スペース区切りのタグ: key[=value] [key[=value] ...]。"" を使用して既存のタグをクリアします。
イメージがゾーンの回復性を持つかどうかを指定します。 既定値は false です。 ゾーン回復性の高いイメージは、ゾーン冗長ストレージを提供するリージョンでのみ作成できます。
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az image delete
イメージを削除します。
az image delete [--ids]
[--name]
[--resource-group]
[--subscription]
省略可能のパラメーター
1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids またはその他の 'Resource Id' 引数を指定する必要があります。
イメージの名前。 必須。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az image list
カスタム VM イメージを一覧表示します。
az image list [--resource-group]
省略可能のパラメーター
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az image show
イメージを取得します。
az image show [--expand]
[--ids]
[--name]
[--resource-group]
[--subscription]
省略可能のパラメーター
操作に適用する展開式。 既定値は [なし] です。
1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids またはその他の 'Resource Id' 引数を指定する必要があります。
イメージの名前。 必須。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az image update
カスタム VM イメージを更新します。
az image update [--add]
[--force-string]
[--ids]
[--name]
[--remove]
[--resource-group]
[--set]
[--subscription]
[--tags]
例
タグを追加または更新します。
az image update -n ImageName -g ResourceGroup --tags tag1=val1 tag2=val2
すべてのタグを削除します。
az image update -n ImageName -g resourceGroup --tags
省略可能のパラメーター
パスとキー値のペアを指定して、オブジェクトの一覧にオブジェクトを追加します。 例: --add property.listProperty <key=value、string、または JSON 文字列>。
'set' または 'add' を使用する場合は、JSON に変換するのではなく、文字列リテラルを保持します。
1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids またはその他の 'Resource Id' 引数を指定する必要があります。
イメージの名前。 必須。
リストからプロパティまたは要素を削除します。 例: --remove property.list OR --remove propertyToRemove。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
設定するプロパティのパスと値を指定して、オブジェクトを更新します。 例: --set property1.property2=
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
スペース区切りのタグ: key[=value] [key[=value] ...]。既存のタグをクリアするには、"" を使用します。
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
フィードバック
フィードバックの送信と表示