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	Поместите интерфейс командной строки в состояние ожидания, пока не будет выполнено условие.	Основные сведения	Общедоступная версия

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]

Примеры

Создайте моментальный снимок путем импорта из 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

Предварительный просмотр

Клиенты могут установить Управляемые диски или моментальные снимки, чтобы включить ускоренную сеть, если поддерживается образ диска ОС.

допустимые значения: false, true

--architecture

Архитектура ЦП.

допустимые значения: Arm64, x64

--bandwidth-copy-speed

Если это поле установлено на моментальном снимке и createOption — CopyStart, моментальный снимок будет скопирован быстрее.

допустимые значения: Enhanced, None

--copy-start

Создайте моментальный снимок с помощью процесса глубокого копирования, где создание ресурса считается завершенным только после копирования всех данных из источника.

допустимые значения: false, true

--disk-access

Имя или идентификатор ресурса доступа к диску для использования частных конечных точек на дисках.

--disk-encryption-set

Имя или идентификатор набора шифрования дисков, который используется для шифрования диска.

--edge-zone

Имя пограничной зоны.

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

Это идентификатор ARM исходного моментального снимка эластичного сан-тома.

--encryption-type

Тип шифрования. EncryptionAtRestWithPlatformKey: диск шифруется с помощью управляемого ключа XStore. Это тип шифрования по умолчанию. EncryptionAtRestWithCustomerKey: диск шифруется с помощью неактивных ключей, управляемых клиентом.

допустимые значения: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey

--for-upload

Создайте моментальный снимок для отправки больших двоичных объектов позже с помощью команд хранилища. Запустите команду az snapshot grant-access --access-level Write, чтобы получить маркер SAS моментального снимка.

допустимые значения: false, true

--hyper-v-generation

Создание гипервизора виртуальной машины. Применимо только к дискам ОС.

допустимые значения: 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

Размер в ГБ. Максимальный размер: 4095 ГБ (некоторые диски предварительной версии могут быть больше).

--sku

допустимые значения: Premium_LRS, Standard_LRS, Standard_ZRS

значение по умолчанию: Standard_LRS

--source

Источник для создания диска или моментального снимка, включая неуправляемый URI BLOB-объектов, идентификатор управляемого диска или имя, или идентификатор моментального снимка или имя.

--source-storage-account-id

Используется при использовании исходного большого двоичного объекта в другой подписке.

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

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью 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

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource 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

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью 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

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью 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

Используется для указания формата файла при запросе SAS на моментальный снимок формата VHDX-файла.

допустимые значения: VHD, VHDX

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.

--name -n

Имя моментального снимка.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью 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

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью 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

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью 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

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource 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

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью 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

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az snapshot show

Получение сведений о моментальном снимке.

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

Необязательные параметры

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.

--name --snapshot-name -n

Имя создаваемого моментального снимка. Имя невозможно изменить после создания моментального снимка. Поддерживаемые символы для имени: a-z, A-Z, 0-9, _ и -. Максимальная длина имени — 80 символов.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью 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

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью 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

Предварительный просмотр

Клиенты могут установить Управляемые диски или моментальные снимки, чтобы включить ускоренную сеть, если поддерживается образ диска ОС.

допустимые значения: false, true

--add

Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>.

значение по умолчанию: []

--architecture

Архитектура ЦП.

допустимые значения: Arm64, x64

--disk-access

Имя или идентификатор ресурса доступа к диску для использования частных конечных точек на дисках.

--disk-encryption-set

Имя или идентификатор набора шифрования дисков, который используется для шифрования диска.

--encryption-type

Тип шифрования. EncryptionAtRestWithPlatformKey: диск шифруется с помощью управляемого ключа XStore. Это тип шифрования по умолчанию. EncryptionAtRestWithCustomerKey: диск шифруется с помощью неактивных ключей, управляемых клиентом.

допустимые значения: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey

--force-string

При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.

значение по умолчанию: False

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource 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

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью 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

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az snapshot wait

Поместите интерфейс командной строки в состояние ожидания, пока не будет выполнено условие.

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

Необязательные параметры

--created

Подождите, пока не будет создано с помощью provisioningState по адресу "Успешно".

значение по умолчанию: False

--custom

Подождите, пока условие не будет удовлетворено пользовательским запросом JMESPath. Например, provisioningState!='InProgress', instanceView.statuses[?code='PowerState/running'].

--deleted

Дождитесь удаления.

значение по умолчанию: False

--exists

Подождите, пока ресурс не существует.

значение по умолчанию: False

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource 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

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--timeout

Максимальное ожидание в секундах.

значение по умолчанию: 3600

--updated

Подождите, пока не будет обновлено с помощью provisioningState по адресу "Успешно".

значение по умолчанию: False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.