Поделиться через

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

Местоположение. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>. Если расположение не указано и расположение по умолчанию не указано, расположение будет автоматически задано так же, как и группа ресурсов.

--network-access-policy

Политика доступа к диску через сеть.

Допустимые значения: AllowAll, AllowPrivate, DenyAll
--no-wait

Не ожидать завершения длительной операции.

Default value: False
--public-network-access
Предварительный просмотр

Клиенты могут настроить Управляемые диски или моментальные снимки для управления политикой экспорта на диске.

Допустимые значения: Disabled, Enabled
--size-gb -z

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

--sku
Допустимые значения: Premium_LRS, Standard_LRS, Standard_ZRS
Default value: 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
Default value: 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
Default value: 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 {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
Default value: Read
--file-format

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

Допустимые значения: VHD, VHDX
--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
Default value: 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
Default value: 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
Default value: 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
Default value: json
--query

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

--subscription

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

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

Допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--add

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

--architecture

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

Допустимые значения: Arm64, x64
--disk-access

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

--disk-encryption-set

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

--encryption-type

Тип шифрования.

Допустимые значения: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--force-string

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

Допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--ids

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

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

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

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

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

--output -o

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

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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 по адресу "Успешно".

Default value: False
--custom

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

--deleted

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

Default value: False
--exists

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

Default value: False
--ids

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

--interval

Интервал опроса в секундах.

Default value: 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

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

Default value: 3600
--updated

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

Default value: False
Глобальные параметры
--debug

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

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

--output -o

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

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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