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

az snapshot

  • Ссылка

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

Команды

Имя Описание Тип Состояние
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> ИЛИ --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 для полных журналов отладки.