az sig image-version
Примечание.
Эта группа команд содержит команды, определенные как в Azure CLI, так и в одном расширении. Установите каждое расширение, чтобы воспользоваться расширенными возможностями. Подробнее о расширениях.
Управление версией образа общей коллекции с помощью виртуальной машины.
Команды
Имя | Описание | Тип | Состояние |
---|---|---|---|
az sig image-version create |
Создание новой версии образа. |
Основные сведения | Общедоступная версия |
az sig image-version delete |
Удалите версию образа коллекции. |
Основные сведения | Общедоступная версия |
az sig image-version list |
Вывод списка версий образов коллекции в определении образа коллекции. |
Основные сведения | Общедоступная версия |
az sig image-version list-community |
Вывод списка версий образов виртуальной машины в сообществе коллекции. |
Основные сведения | Общедоступная версия |
az sig image-version list-community (image-gallery Расширение) |
Вывод списка версий образов виртуальных машин в сообществе коллекции (предварительная версия). |
Расширение | Экспериментальный |
az sig image-version list-shared |
Вывод списка версий образов виртуальных машин в коллекции, к которым предоставлен доступ непосредственно вашей подписке или клиенту. |
Основные сведения | Общедоступная версия |
az sig image-version show |
Извлекает сведения о версии образа коллекции. |
Основные сведения | Общедоступная версия |
az sig image-version show-community |
Получите версию образа коллекции сообщества. |
Основные сведения | Общедоступная версия |
az sig image-version show-community (image-gallery Расширение) |
Получение версии образа в сообществе коллекции (предварительная версия). |
Расширение | Экспериментальный |
az sig image-version show-shared |
Получите версию образа в коллекции, доступную непосредственно вашей подписке или клиенту. |
Основные сведения | Общедоступная версия |
az sig image-version undelete |
Восстановление обратимой удаленной версии образа. |
Основные сведения | Предварительный просмотр |
az sig image-version update |
Обновление версии образа общего ресурса. |
Основные сведения | Общедоступная версия |
az sig image-version wait |
Дождитесь операции, связанной с версией образа. |
Основные сведения | Общедоступная версия |
az sig image-version create
Создание новой версии образа.
Эта операция может занять много времени в зависимости от номера региона реплика te. Рекомендуется использовать "--no-wait".
az sig image-version create --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--allow-replicated-location-deletion {false, true}]
[--data-snapshot-luns]
[--data-snapshots]
[--data-vhds-luns]
[--data-vhds-sa]
[--data-vhds-uris]
[--end-of-life-date]
[--exclude-from-latest {false, true}]
[--image-version]
[--location]
[--managed-image]
[--no-wait]
[--os-snapshot]
[--os-vhd-storage-account]
[--os-vhd-uri]
[--replica-count]
[--replication-mode {Full, Shallow}]
[--storage-account-type {Premium_LRS, Standard_LRS, Standard_ZRS}]
[--tags]
[--target-edge-zone-encryption]
[--target-edge-zones]
[--target-region-cvm-encryption]
[--target-region-encryption]
[--target-regions]
[--virtual-machine]
Примеры
Добавление новой версии образа из виртуальной машины
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM
Добавление новой версии образа из управляемого образа
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--managed-image /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/images/MyManagedImage
Добавление новой версии образа из другой версии образа
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--image-version /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/galleries/MyGallery/images/MyImageDefinition/versions/1.0.0
Добавление новой версии образа с управляемого диска
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyOSDisk
Добавление новой версии образа с управляемого диска и добавление дополнительных дисков данных
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyOSDisk \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyDataDisk \
--data-snapshot-luns 0
Добавьте новую версию образа из моментального снимка диска ОС.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyOsDiskSnapshot
Добавление новой версии образа из моментального снимка диска ОС и добавление дополнительных моментальных снимков в качестве дисков данных
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyOsDiskSnapshot \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyDiskSnapshot \
--data-snapshot-luns 0
Добавьте новую версию образа из VHD диска ОС.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file
Добавление новой версии образа из VHD диска ОС и добавление дополнительных виртуальных жестких дисков в качестве дисков данных
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-vhds-sa /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/myotherstorageaccount \
--data-vhds-uris https://myotherstorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-vhds-luns 0
Для создания новой версии образа можно объединить моментальные снимки, управляемые диски и виртуальные жесткие диски. Добавьте новую версию образа с помощью виртуального жесткого диска в качестве диска ОС и управляемого диска и моментального снимка в качестве дисков данных.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyDataDisk subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyDiskSnapshot \
--data-snapshot-luns 0 1
Добавьте новую версию образа и скопируйте ее в дополнительные регионы. Домашнее расположение для источника версии образа должно быть включено в список целевых регионов. Для каждого дополнительного региона можно указать другой тип реплика счетчика и учетной записи хранения. В противном случае регион наследуется от глобального. Число реплика по умолчанию равно 1, а тип учетной записи хранения по умолчанию — standard LRS. В этом примере eastus2 будет иметь один реплика, хранящийся в хранилище Standard ZRS, ukwest будет иметь 3 реплика, хранящихся в хранилище Standard ZRS, southindia будет иметь один реплика храниться в хранилище Standard LRS, а бразилия будет иметь 2 реплика, хранящихся в хранилище LRS уровня "Стандартный".
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 --replica-count 1 \
--storage-account-type Standard_ZRS --managed-image image-name \
--target-regions eastus2 ukwest=3 southindia=standard_lrs \
brazilsouth=2=standard_lrs
Добавьте новую версию образа с шифрованием с помощью набора шифрования дисков. Шифрование применяется к каждому диску, который является частью версии образа.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--target-regions westus=2=standard eastus \
--target-region-encryption WestUSDiskEncryptionSet1,0,WestUSDiskEncryptionSet2 \
EastUSDiskEncryptionSet1,0,EastUSDiskEncryptionSet2
Добавьте новую версию образа и скопируйте ее в расширенные расположения.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 --replica-count 1 \
--storage-account-type Standard_ZRS --managed-image image-name \
--target-edge-zones westus=microsoftlosangeles1 eastus=microsoftlosangeles2=1 \
brazilsouth=2=standard_lrs
Добавьте новую версию образа и скопируйте ее в расширенные расположения с шифрованием с помощью набора шифрования дисков.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--target-edge-zones westus=microsoftlosangeles1 \
--target-edge-zone-encryption microsoftlosangeles1,WestUSDiskEncryptionSet1,0,WestUSDiskEncryptionSet2
Добавьте новую версию образа и не подождите. Позже можно вызвать команду az sig image-version wait, когда она готова к созданию виртуальной машины из версии образа коллекции.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--no-wait
Добавление новой версии образа, но удаление ее из рассмотрения в качестве последней версии в определении образа
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--exclude-from-latest true
Добавьте новую версию образа и задайте дату окончания срока действия. Версия образа по-прежнему может использоваться для создания виртуальной машины после окончания срока действия.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--end-of-life-date 2024-08-02T00:00:00+00:00
Обязательные параметры
Определение изображения коллекции.
Версия образа коллекции в шаблоне семантической версии. Допустимые символы — цифры и точки. Цифры должны находиться в диапазоне 32-разрядного целого числа, например <MajorVersion>.<MinorVersion>.<Patch>
.
Имя коллекции.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Необязательные параметры
Укажите, разрешено ли удаление этой версии образа коллекции из реплика регионов.
Логические номера единиц (разделенные пробелами) моментальных снимков диска данных.
Имена или идентификаторы (разделенные пробелами) моментальных снимков диска данных.
Логические номера единиц (разделенные пробелами) исходных URI VHD дисков данных.
Имена или идентификаторы (разделенные пробелами) учетных записей хранения исходных URI VHD дисков данных.
Исходные URI VHD (разделенные пробелами) дисков данных.
Дата окончания жизни, например "2020-12-31".
Флаг означает, что если задано значение true, пользователи, развертывающие виртуальные машины с опущенной версией, не будут использовать эту версию.
Идентификатор ресурса источника версии образа коллекции.
Location. Значения из az account list-locations
. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>
.
Имя изображения (если в той же группе ресурсов) или идентификатор ресурса.
Не ожидать завершения длительной операции.
Имя или идентификатор моментального снимка диска ОС.
Имя или идентификатор учетной записи хранения исходного URI VHD диска ОС.
Исходный URI VHD диска ОС.
Число реплика по умолчанию для каждого региона. Чтобы задать количество региональных реплика tions, используйте --target-регионы.
Необязательный параметр, указывающий режим, используемый для реплика. Это свойство не является обновляемым.
Тип учетной записи хранения по умолчанию для каждого региона. Чтобы задать типы учетных записей регионального хранения, используйте --target-регионы.
Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.
Разделенный пробелами список управляемых клиентом ключей для шифрования дисков ОС и данных в артефакте коллекции для каждого региона. Формат для каждой пограничной зоны: ,<os_des,lun1_des,lun2_des<>><>.
Разделенный пробелами список регионов, пограничных зон, реплика счетчиков и типов хранилища. Используйте =[=][=]] для дополнительного задания типа реплика счетчика и (или) учетной записи хранения для каждого региона. Если счетчик реплика не указан, будет использоваться значение реплика по умолчанию. Если тип учетной записи хранения не указан, будет использоваться тип учетной записи хранения по умолчанию. Если указан параметр --target-edge-zones None, то целевое расширенное расположение будет снято.
Разделенный пробелами список управляемых клиентом ключей для конфиденциальной виртуальной машины, шифрующей диск ОС в артефакте коллекции для каждого региона. Формат для каждого региона: <os_cvm_encryption_type>,<os_cvm_des>
Допустимые значения для os_cvm_encryption_type: EncryptedVMGuestStateOnlyWithPmk, EncryptedWithPmk, EncryptedWithCmk.
Разделенный пробелами список управляемых клиентом ключей для шифрования дисков ОС и данных в артефакте коллекции для каждого региона. Формат для каждого региона: <os_des>,<lun1>,<lun1_des>,<lun2>,<lun2_des>
Используйте значение NULL в качестве заполнителя.
Разделенный пробелами список регионов и их реплика счетчиков. Используется <region>[=<replica count>][=<storage account type>]
для задания типа реплика счетчика и (или) учетной записи хранения для каждого региона. Если счетчик реплика не указан, будет использоваться значение реплика по умолчанию. Если тип учетной записи хранения не указан, будет использоваться тип учетной записи хранения по умолчанию.
Идентификатор ресурса источника виртуальной машины.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az sig image-version delete
Удалите версию образа коллекции.
az sig image-version delete [--gallery-image-definition]
[--gallery-image-version]
[--gallery-name]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
Необязательные параметры
Имя определения образа коллекции, в котором находится версия образа.
Имя версии образа коллекции для удаления.
Имя Общая коллекция образов, в которой находится определение изображения.
Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.
Не ожидать завершения длительной операции.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az sig image-version list
Вывод списка версий образов коллекции в определении образа коллекции.
az sig image-version list --gallery-image-definition
--gallery-name
--resource-group
[--max-items]
[--next-token]
Обязательные параметры
Определение изображения коллекции.
Имя коллекции.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Необязательные параметры
Общее количество элементов, возвращаемых в выходных данных команды. Если общее количество доступных элементов превышает указанное значение, маркер предоставляется в выходных данных команды. Чтобы возобновить разбиение на страницы, укажите значение маркера в --next-token
аргументе последующей команды.
Маркер, чтобы указать, где начать разбиение на страницы. Это значение маркера из ранее усеченного ответа.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az sig image-version list-community
Вывод списка версий образов виртуальной машины в сообществе коллекции.
az sig image-version list-community [--gallery-image-definition]
[--ids]
[--location]
[--marker]
[--public-gallery-name]
[--show-next-marker]
[--subscription]
Примеры
Вывод списка версий изображений в сообществе коллекции.
az sig image-version list-community --public-gallery-name publicGalleryName \
--gallery-image-definition MyImage --location myLocation
Необязательные параметры
Имя определения образа коллекции сообщества, из которого должны быть перечислены версии образа.
Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.
Location. Значения из az account list-locations
. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>
.
Строковое значение, определяющее часть списка контейнеров, возвращаемую с помощью следующей операции перечисления. Операция возвращает значение NextMarker в теле ответа, если операция перечисления не вернула все контейнеры, оставшиеся в списке с текущей страницей. Если задано, этот генератор начнет возвращать результаты с точки, где остановлен предыдущий генератор.
Общедоступное имя коллекции сообщества.
Отображение nextMarker в результате при указании.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az sig image-version list-community (image-gallery Расширение)
Эта команда является экспериментальной и в стадии разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus
Вывод списка версий образов виртуальных машин в сообществе коллекции (предварительная версия).
Список версий образов виртуальной машины в сообществе коллекции (функция частной предварительной версии, обратитесь к группе коллекции образов сообщества по электронной почте [email protected] , чтобы зарегистрироваться для предварительной версии, если вы хотите использовать эту функцию).
az sig image-version list-community [--gallery-image-definition]
[--ids]
[--location]
[--marker]
[--public-gallery-name]
[--show-next-marker]
[--subscription]
Примеры
Вывод списка версий изображений в сообществе коллекции.
az sig image-version list-community --public-gallery-name publicGalleryName \
--gallery-image-definition MyImage --location myLocation
Необязательные параметры
Имя определения образа коллекции сообщества, из которого должны быть перечислены версии образа.
Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.
Location. Значения из az account list-locations
. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>
.
Строковое значение, определяющее часть списка контейнеров, возвращаемую с помощью следующей операции перечисления. Операция возвращает значение NextMarker в теле ответа, если операция перечисления не вернула все контейнеры, оставшиеся в списке с текущей страницей. Если задано, этот генератор начнет возвращать результаты с точки, где остановлен предыдущий генератор.
Общедоступное имя коллекции сообщества.
Отображение nextMarker в результате при указании.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az sig image-version list-shared
Вывод списка версий образов виртуальных машин в коллекции, к которым предоставлен доступ непосредственно вашей подписке или клиенту.
az sig image-version list-shared [--gallery-image-definition]
[--gallery-unique-name]
[--ids]
[--location]
[--marker]
[--shared-to {tenant}]
[--show-next-marker]
[--subscription]
Примеры
Вывод списка версий изображений в коллекции, общий доступ к подписке в заданном расположении и определении образа.
az sig image-version list-shared --gallery-unique-name galleryUniqueName \
--gallery-image-definition MyImage --location myLocation
Вывод списка версий изображений в коллекции, общий доступ к клиенту в заданном расположении и определении образа.
az sig image-version list-shared --gallery-unique-name galleryUniqueName \
--gallery-image-definition MyImage --location myLocation --shared-to tenant
Необязательные параметры
Имя определения образа общей коллекции, из которого должны быть перечислены версии образа.
Уникальное имя общей коллекции.
Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.
Location. Значения из az account list-locations
. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>
.
Строковое значение, определяющее часть списка контейнеров, возвращаемую с помощью следующей операции перечисления. Операция возвращает значение NextMarker в теле ответа, если операция перечисления не вернула все контейнеры, оставшиеся в списке с текущей страницей. Если задано, этот генератор начнет возвращать результаты с точки, где остановлен предыдущий генератор.
Параметр запроса, чтобы решить, какие общие коллекции следует получить при выполнении операций с перечислением. Если этот параметр не указан, список по идентификатору подписки.
Отображение nextMarker в результате при указании.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az sig image-version show
Извлекает сведения о версии образа коллекции.
az sig image-version show --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--expand]
Обязательные параметры
Определение изображения коллекции.
Версия образа коллекции в шаблоне семантической версии. Допустимые символы — цифры и точки. Цифры должны находиться в диапазоне 32-разрядного целого числа, например <MajorVersion>.<MinorVersion>.<Patch>
.
Имя коллекции.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Необязательные параметры
Выражение расширения, применяемое к операции, например ReplicationStatus.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az sig image-version show-community
Получите версию образа коллекции сообщества.
az sig image-version show-community [--gallery-image-definition]
[--gallery-image-version]
[--ids]
[--location]
[--public-gallery-name]
[--subscription]
Необязательные параметры
Имя определения образа коллекции сообщества, из которого должны быть перечислены версии образа.
Версия образа коллекции в шаблоне семантической версии. Допустимые символы — цифры и точки. Цифры должны находиться в диапазоне 32-разрядного целого числа, например <MajorVersion>.<MinorVersion>.<Patch>
.
Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.
Location. Значения из az account list-locations
. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>
.
Общедоступное имя коллекции сообщества.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az sig image-version show-community (image-gallery Расширение)
Эта команда является экспериментальной и в стадии разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus
Получение версии образа в сообществе коллекции (предварительная версия).
Получите версию образа в сообществе галереи (функция частной предварительной версии, обратитесь к группе коллекции образов сообщества по электронной почте [email protected] , чтобы зарегистрироваться для предварительной версии, если вы хотите использовать эту функцию).
az sig image-version show-community [--gallery-image-definition]
[--gallery-image-version]
[--ids]
[--location]
[--public-gallery-name]
[--subscription]
Примеры
Получите версию образа в сообществе коллекции в указанном расположении.
az sig image-version show-community --public-gallery-name publicGalleryName \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 --location myLocation
Необязательные параметры
Имя определения образа коллекции сообщества, из которого должны быть перечислены версии образа.
Имя создаваемой версии образа коллекции. Необходимо следовать шаблону имени семантической версии: допустимые символы являются цифрами и периодами. Цифры должны находиться в диапазоне 32-разрядного целого числа. Формат:...
Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.
Location. Значения из az account list-locations
. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>
.
Общедоступное имя коллекции сообщества.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az sig image-version show-shared
Получите версию образа в коллекции, доступную непосредственно вашей подписке или клиенту.
az sig image-version show-shared [--gallery-image-definition]
[--gallery-image-version]
[--gallery-unique-name]
[--ids]
[--location]
[--subscription]
Примеры
Получите версию образа в коллекции, доступную непосредственно вашей подписке или клиенту в указанном расположении.
az sig image-version show-shared --gallery-unique-name galleryUniqueName --gallery-image-definition MyImage --gallery-image-version 1.0.0 --location myLocation
Необязательные параметры
Имя определения образа общей коллекции, из которого должны быть перечислены версии образа.
Имя создаваемой версии образа коллекции. Необходимо следовать шаблону имени семантической версии: допустимые символы являются цифрами и периодами. Цифры должны находиться в диапазоне 32-разрядного целого числа. Формат:...
Уникальное имя общей коллекции.
Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.
Location. Значения из az account list-locations
. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>
.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az sig image-version undelete
Эта команда находится в предварительной версии и находится в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus
Восстановление обратимой удаленной версии образа.
Операция будет успешно выполнена, только если используется в коллекции с обратимым удалением.
az sig image-version undelete --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--allow-replicated-location-deletion {false, true}]
[--location]
[--no-wait]
[--tags]
Примеры
Восстановление обратимой удаленной версии образа
az sig image-version undelete --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.1.1
Обязательные параметры
Определение изображения коллекции.
Версия образа коллекции в шаблоне семантической версии. Допустимые символы — цифры и точки. Цифры должны находиться в диапазоне 32-разрядного целого числа, например <MajorVersion>.<MinorVersion>.<Patch>
.
Имя коллекции.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Необязательные параметры
Укажите, разрешено ли удаление этой версии образа коллекции из реплика регионов.
Location. Значения из az account list-locations
. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>
.
Не ожидать завершения длительной операции.
Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az sig image-version update
Обновление версии образа общего ресурса.
az sig image-version update --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--add]
[--allow-replicated-location-deletion {false, true}]
[--force-string]
[--no-wait]
[--remove]
[--replica-count]
[--set]
[--target-edge-zones]
[--target-regions]
Примеры
Изменение регионов реплика и счетчика реплика
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-regions westcentralus=2 eastus2
Изменение расширенных расположений реплика
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-edge-zones westus=microsoftlosangeles1 eastus=microsoftlosangeles2=1
Очистка расширенных расположений реплика
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-edge-zones None
Репликация в дополнительный регион. Необязательно, можно задать количество реплика для региона и исключить это изображение при использовании последней версии определения образа.
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--add publishingProfile.targetRegions name=westcentralus \
regionalReplicaCount=3 excludeFromLatest=true
Измените, следует ли включить изображение в учетную версию последней версии в определении образа. При задании этого значения значение true исключает изображение из рассмотрения и при задании этого значения значение false включает изображение для рассмотрения.
az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set publishingProfile.excludeFromLatest=true
Измените дату окончания срока жизни для версии образа. Образ по-прежнему можно использовать для создания виртуальных машин после окончания срока жизни.
az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set publishingProfile.endOfLifeDate=2024-08-02T00:00:00+00:00
Разрешить удалить версию образа коллекции из реплика регионов.
az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set safetyProfile.allowDeletionOfReplicatedLocations=true
Обязательные параметры
Определение изображения коллекции.
Версия образа коллекции в шаблоне семантической версии. Допустимые символы — цифры и точки. Цифры должны находиться в диапазоне 32-разрядного целого числа, например <MajorVersion>.<MinorVersion>.<Patch>
.
Имя коллекции.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Необязательные параметры
Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>
.
Укажите, разрешено ли удаление этой версии образа коллекции из реплика регионов.
При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.
Не ожидать завершения длительной операции.
Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
Число реплика по умолчанию для каждого региона. Чтобы задать количество региональных реплика tions, используйте --target-регионы.
Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>
.
Разделенный пробелами список регионов, пограничных зон, реплика счетчиков и типов хранилища. Используйте =[=][=]] для дополнительного задания типа реплика счетчика и (или) учетной записи хранения для каждого региона. Если счетчик реплика не указан, будет использоваться значение реплика по умолчанию. Если тип учетной записи хранения не указан, будет использоваться тип учетной записи хранения по умолчанию. Если указан параметр --target-edge-zones None, то целевое расширенное расположение будет снято.
Разделенный пробелами список регионов и их реплика счетчиков. Используется <region>[=<replica count>][=<storage account type>]
для задания типа реплика счетчика и (или) учетной записи хранения для каждого региона. Если счетчик реплика не указан, будет использоваться значение реплика по умолчанию. Если тип учетной записи хранения не указан, будет использоваться тип учетной записи хранения по умолчанию.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az sig image-version wait
Дождитесь операции, связанной с версией образа.
az sig image-version wait --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--created]
[--custom]
[--deleted]
[--exists]
[--expand]
[--interval]
[--timeout]
[--updated]
Примеры
Дождитесь обновления версии образа
az sig image-version wait --updated --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0
Дождитесь операции, связанной с версией образа. (автоматическое создание)
az sig image-version wait --created --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0
Обязательные параметры
Определение изображения коллекции.
Версия образа коллекции в шаблоне семантической версии. Допустимые символы — цифры и точки. Цифры должны находиться в диапазоне 32-разрядного целого числа, например <MajorVersion>.<MinorVersion>.<Patch>
.
Имя коллекции.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Необязательные параметры
Подождите, пока не будет создано с помощью provisioningState по адресу "Успешно".
Подождите, пока условие не будет удовлетворено пользовательским запросом JMESPath. Например, provisioningState!='InProgress', instanceView.statuses[?code='PowerState/running'].
Дождитесь удаления.
Подождите, пока ресурс не существует.
Выражение расширения, применяемое к операции. Значение по умолчанию "ReplicationStatus" — None.
Интервал опроса в секундах.
Максимальное ожидание в секундах.
Подождите, пока не будет обновлено с помощью provisioningState по адресу "Успешно".
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.