az snapshot

  • リファレンス

マネージド ディスク、ネイティブ BLOB、またはその他のスナップショットの特定時点のコピーを管理します。

コマンド

名前 説明 型 Status
az snapshot create

スナップショットの作成。

 コア GA
az snapshot delete

スナップショットを削除します。

 コア GA
az snapshot grant-access

スナップショットへの読み取りアクセス権を付与します。

 コア GA
az snapshot list

リソース グループの下にスナップショットを一覧表示します。

 コア GA
az snapshot revoke-access

スナップショットへのアクセスを取り消します。

 コア GA
az snapshot show

スナップショットに関する情報を取得します。

 コア GA
az snapshot update

スナップショットを更新します。

 コア GA
az snapshot wait

条件が満たされるまで CLI を待機状態にします。

 コア GA

az snapshot create

スナップショットの作成。

az snapshot create --name
                   --resource-group
                   [--accelerated-network {false, true}]
                   [--architecture {Arm64, x64}]
                   [--bandwidth-copy-speed {Enhanced, None}]
                   [--copy-start {false, true}]
                   [--disk-access]
                   [--disk-encryption-set]
                   [--edge-zone]
                   [--elastic-san-id]
                   [--encryption-type {EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey}]
                   [--for-upload {false, true}]
                   [--hyper-v-generation {V1, V2}]
                   [--incremental {false, true}]
                   [--location]
                   [--network-access-policy {AllowAll, AllowPrivate, DenyAll}]
                   [--no-wait]
                   [--public-network-access {Disabled, Enabled}]
                   [--size-gb]
                   [--sku {Premium_LRS, Standard_LRS, Standard_ZRS}]
                   [--source]
                   [--source-storage-account-id]
                   [--tags]

例

BLOB URI からインポートしてスナップショットを作成します。

az snapshot create -g MyResourceGroup -n MySnapshot --source https://vhd1234.blob.core.windows.net/vhds/osdisk1234.vhd

空のスナップショットを作成します。

az snapshot create -g MyResourceGroup -n MySnapshot --size-gb 10

同じリソース グループ内の既存のディスクをコピーして、スナップショットを作成します。

az snapshot create -g MyResourceGroup -n MySnapshot2 --source MyDisk

別のリソース グループ内の既存のディスクからスナップショットを作成します。

az snapshot create -g MyResourceGroup -n MySnapshot2 --source "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.Compute/disks/MyDisk"

スナップショットを作成し、ディスク アクセス リソースに関連付けます。

az snapshot create -g MyResourceGroup -n MySnapshot --size-gb 10 --network-access-policy AllowPrivate --disk-access MyDiskAccessID

必須のパラメーター

--name -n

スナップショットの名前です。

--resource-group -g

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

省略可能のパラメーター

--accelerated-network
プレビュー

OS ディスク イメージがサポートされている場合、お客様はマネージド ディスクまたはスナップショットを設定して高速ネットワークを有効にすることができます。

承認された値: false, true
--architecture

CPU アーキテクチャ。

承認された値: Arm64, x64
--bandwidth-copy-speed

このフィールドがスナップショットに設定され、createOption が CopyStart の場合、スナップショットはより迅速にコピーされます。

承認された値: Enhanced, None
--copy-start

ディープ コピー プロセスを使用してスナップショットを作成します。リソースの作成は、ソースからすべてのデータがコピーされた後にのみ完了と見なされます。

承認された値: false, true
--disk-access

ディスク上のプライベート エンドポイントを使用するためのディスク アクセス リソースの名前または ID。

--disk-encryption-set

ディスクの暗号化に使用されるディスク暗号化セットの名前または ID。

--edge-zone

エッジ ゾーンの名前。

--elastic-san-id --elastic-san-resource-id

これは、ソース エラスティック SAN ボリューム スナップショットの ARM ID です。

--encryption-type

暗号化の種類。 EncryptionAtRestWithPlatformKey: ディスクは、保存時に XStore マネージド キーを使用して暗号化されます。 既定の暗号化の種類です。 EncryptionAtRestWithCustomerKey: ディスクは、保存時にカスタマー マネージド キーを使用して暗号化されます。

承認された値: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--for-upload

ストレージ コマンドを使用して、後で BLOB をアップロードするためのスナップショットを作成します。 "az スナップショット grant-access --access-level Write" を実行して、スナップショットの SAS トークンを取得します。

承認された値: false, true
--hyper-v-generation

仮想マシンのハイパーバイザー生成。 OS ディスクにのみ適用されます。

承認された値: V1, V2
--incremental

スナップショットが増分であるかどうか。 同じディスク上の増分スナップショットは、完全なスナップショットよりも少ない領域を占有し、差分することができます。

承認された値: false, true
--location -l

Location。 値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。 場所が指定されておらず、既定の場所が指定されていない場合、場所はリソース グループと同じように自動的に設定されます。

--network-access-policy

ネットワーク経由でディスクにアクセスするためのポリシー。

承認された値: AllowAll, AllowPrivate, DenyAll
--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False
--public-network-access
プレビュー

お客様は、マネージド ディスクまたはスナップショットを設定して、ディスク上のエクスポート ポリシーを制御できます。

承認された値: Disabled, Enabled
--size-gb -z

GB 単位のサイズ。 最大サイズ: 4095 GB (特定のプレビュー ディスクは大きくなる可能性があります)。

--sku
承認された値: Premium_LRS, Standard_LRS, Standard_ZRS
既定値: Standard_LRS
--source

アンマネージド BLOB URI、マネージド ディスク ID または名前、スナップショット ID または名前など、ディスク/スナップショットを作成するソース。

--source-storage-account-id

ソース BLOB が別のサブスクリプションにある場合に使用されます。

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

スナップショットを削除します。

az snapshot delete [--ids]
                   [--name]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--resource-group]
                   [--subscription]

省略可能のパラメーター

--ids

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

--name --snapshot-name -n

作成されるスナップショットの名前。 スナップショットの作成後に名前を変更することはできません。 名前でサポートされている文字は、a~z、A~Z、0~9、_ および -です。 名前の最大長は 80 文字です。

--no-wait

実行時間の長い操作の終了を待機しません。

承認された値: 0, 1, f, false, n, no, t, true, y, yes
--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 snapshot grant-access

スナップショットへの読み取りアクセス権を付与します。

az snapshot grant-access --duration-in-seconds
                         [--access-level {Read, Write}]
                         [--file-format {VHD, VHDX}]
                         [--ids]
                         [--name]
                         [--resource-group]
                         [--subscription]

例

スナップショットへの読み取りアクセス権を付与します。 (自動生成)

az snapshot grant-access --duration-in-seconds 3600 --name MySnapshot --resource-group MyResourceGroup

ファイル形式を指定して、スナップショットへの読み取りアクセス権を付与します。

az snapshot grant-access --duration-in-seconds 3600 --name MySnapshot --resource-group MyResourceGroup --file-format VHDX

必須のパラメーター

--duration-in-seconds

SAS アクセスの有効期限が切れるまでの時間 (秒単位)。

省略可能のパラメーター

--access-level

アクセス レベル。

承認された値: Read, Write
既定値: Read
--file-format

VHDX ファイル形式のスナップショットで SAS の要求を行うときにファイル形式を指定するために使用します。

承認された値: VHD, VHDX
--ids

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

--name -n

スナップショットの名前です。

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

リソース グループの下にスナップショットを一覧表示します。

az snapshot list [--max-items]
                 [--next-token]
                 [--resource-group]

省略可能のパラメーター

--max-items

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

--next-token

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

--resource-group -g

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

グローバル パラメーター
--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 snapshot revoke-access

スナップショットへのアクセスを取り消します。

az snapshot revoke-access [--ids]
                          [--name]
                          [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                          [--resource-group]
                          [--subscription]

例

スナップショットへの読み取りアクセスを取り消します。

az snapshot revoke-access --name MySnapshot --resource-group MyResourceGroup

省略可能のパラメーター

--ids

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

--name --snapshot-name -n

スナップショットの名前です。

--no-wait

実行時間の長い操作の終了を待機しません。

承認された値: 0, 1, f, false, n, no, t, true, y, yes
--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 snapshot show

スナップショットに関する情報を取得します。

az snapshot show [--ids]
                 [--name]
                 [--resource-group]
                 [--subscription]

省略可能のパラメーター

--ids

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

--name --snapshot-name -n

作成されるスナップショットの名前。 スナップショットの作成後に名前を変更することはできません。 名前でサポートされている文字は、a~z、A~Z、0~9、_ および -です。 名前の最大長は 80 文字です。

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

スナップショットを更新します。

az snapshot update [--accelerated-network {false, true}]
                   [--add]
                   [--architecture {Arm64, x64}]
                   [--disk-access]
                   [--disk-encryption-set]
                   [--encryption-type {EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey}]
                   [--force-string]
                   [--ids]
                   [--name]
                   [--network-access-policy {AllowAll, AllowPrivate, DenyAll}]
                   [--no-wait]
                   [--public-network-access {Disabled, Enabled}]
                   [--remove]
                   [--resource-group]
                   [--set]
                   [--sku {Premium_LRS, Standard_LRS, Standard_ZRS}]
                   [--subscription]

例

スナップショットを更新し、ディスク アクセス リソースに関連付けます。

az snapshot update --name MySnapshot --resource-group MyResourceGroup --network-access-policy AllowPrivate --disk-access MyDiskAccessID

スナップショットを更新します。 (自動生成)

az snapshot update --name MySnapshot --resource-group MyResourceGroup --subscription MySubscription

省略可能のパラメーター

--accelerated-network
プレビュー

OS ディスク イメージがサポートされている場合、お客様はマネージド ディスクまたはスナップショットを設定して高速ネットワークを有効にすることができます。

承認された値: false, true
--add

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

既定値: []
--architecture

CPU アーキテクチャ。

承認された値: Arm64, x64
--disk-access

ディスク上のプライベート エンドポイントを使用するためのディスク アクセス リソースの名前または ID。

--disk-encryption-set

ディスクの暗号化に使用されるディスク暗号化セットの名前または ID。

--encryption-type

暗号化の種類。 EncryptionAtRestWithPlatformKey: ディスクは、保存時に XStore マネージド キーを使用して暗号化されます。 既定の暗号化の種類です。 EncryptionAtRestWithCustomerKey: ディスクは、保存時にカスタマー マネージド キーを使用して暗号化されます。

承認された値: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--force-string

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

既定値: False
--ids

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

--name -n

スナップショットの名前です。

--network-access-policy

ネットワーク経由でディスクにアクセスするためのポリシー。

承認された値: AllowAll, AllowPrivate, DenyAll
--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False
--public-network-access
プレビュー

お客様は、マネージド ディスクまたはスナップショットを設定して、ディスク上のエクスポート ポリシーを制御できます。

承認された値: Disabled, Enabled
--remove

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

既定値: []
--resource-group -g

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

--set

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

既定値: []
--sku
承認された値: Premium_LRS, Standard_LRS, Standard_ZRS
--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 snapshot wait

条件が満たされるまで CLI を待機状態にします。

az snapshot wait [--created]
                 [--custom]
                 [--deleted]
                 [--exists]
                 [--ids]
                 [--interval]
                 [--name]
                 [--resource-group]
                 [--subscription]
                 [--timeout]
                 [--updated]

省略可能のパラメーター

--created

'provisioningState' が 'Succeeded' で作成されるまで待ちます。

既定値: False
--custom

条件がカスタム JMESPath クエリを満たすまで待ちます。 例: provisioningState!='InProgress'、instanceView.statuses[?code=='PowerState/running']。

--deleted

削除されるまで待ちます。

既定値: False
--exists

リソースが存在するまで待ちます。

既定値: False
--ids

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

--interval

ポーリング間隔 (秒単位)。

既定値: 30
--name --snapshot-name -n

作成されるスナップショットの名前。 スナップショットの作成後に名前を変更することはできません。 名前でサポートされている文字は、a~z、A~Z、0~9、_ および -です。 名前の最大長は 80 文字です。

--resource-group -g

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

--subscription

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

--timeout

最大待機時間 (秒単位)。

既定値: 3600
--updated

provisioningState が 'Succeeded' で更新されるまで待ちます。

既定値: False
グローバル パラメーター
--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 を使います。