次の方法で共有

az snapshot

  • リファレンス

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

コマンド

名前 説明 型 状態
az snapshot create

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

 コア ジョージア 州
az snapshot delete

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

 コア ジョージア 州
az snapshot grant-access

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

 コア ジョージア 州
az snapshot list

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

 コア ジョージア 州
az snapshot revoke-access

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

 コア ジョージア 州
az snapshot show

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

 コア ジョージア 州
az snapshot update

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

 コア ジョージア 州
az snapshot wait

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

 コア ジョージア 州

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 snapshot grant-access --access-level Write" を実行して、スナップショットの SAS トークンを取得します。

指定可能な値: false, true
--hyper-v-generation

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

指定可能な値: V1, V2
--incremental

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

指定可能な値: false, true
--location -l

場所。 値の取得場所: 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 {Read, Write}]
                         [--file-format {VHD, VHDX}]
                         [--ids]
                         [--name]
                         [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                         [--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 --access-level

アクセス レベル。

指定可能な値: Read, Write
規定値: Read
--file-format

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

指定可能な値: VHD, VHDX
--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 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 {0, 1, f, false, n, no, t, true, y, yes}]
                   [--add]
                   [--architecture {Arm64, x64}]
                   [--disk-access]
                   [--disk-encryption-set]
                   [--encryption-type {EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey}]
                   [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                   [--ids]
                   [--name]
                   [--network-access-policy {AllowAll, AllowPrivate, DenyAll}]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--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 ディスク イメージがサポートされている場合、お客様はマネージド ディスクまたはスナップショットを設定して高速ネットワークを有効にすることができます。

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

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

--architecture

CPU アーキテクチャ。

指定可能な値: Arm64, x64
--disk-access

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

--disk-encryption-set

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

--encryption-type

暗号化の種類。

指定可能な値: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--force-string

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

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

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

--name --snapshot-name -n

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

--network-access-policy

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

指定可能な値: AllowAll, AllowPrivate, DenyAll
--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

指定可能な値: 0, 1, f, false, n, no, t, true, y, yes
--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

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 を使用します。