Отображение списка, обновление и удаление ресурсов в коллекции

  • Статья

Вы можете управлять ресурсами Коллекции вычислений Azure (ранее — Общая коллекция образов) с помощью Azure CLI или Azure PowerShell.

Список коллекций, к которым вам предоставлен доступ

Список коллекций, к которым предоставлен доступ по вашей подписке.

region=westus
az sig list-shared --location $region

Список коллекций, к которым предоставлен доступ вашему арендатору.

region=westus
az sig list-shared --location $region --shared-to tenant

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

Ниже приведен пример выходных данных:

[
  {
    "location": "westus",
    "name": "1231b567-8a99-1a2b-1a23-123456789abc-MYDIRECTSHARED",
    "uniqueId": "/SharedGalleries/1231b567-8a99-1a2b-1a23-123456789abc-MYDIRECTSHARED"
  }
]

Обновление ресурсов

Существуют некоторые ограничения на то, что можно обновить. Можно обновить следующие элементы:

Коллекция вычислений Azure:

  • Описание

Определение образа

  • Рекомендуемое число виртуальных ЦП
  • Рекомендуемая память
  • Описание
  • Дата окончания жизненного цикла

Версия образа

  • Количество региональных реплик
  • Целевые регионы
  • Исключения из последней версии
  • Дата окончания жизненного цикла

Обновите описание коллекции с помощью команды (az sig update.

az sig update \
   --gallery-name myGallery \
   --resource-group myGalleryRG \
   --set description="My updated description."

Обновите описание определения образа с помощью команды az sig image-definition update.

az sig image-definition update \
   --gallery-name myGallery\
   --resource-group myGalleryRG \
   --gallery-image-definition myImageDefinition \
   --set description="My updated description."

Обновите версию образа, чтобы добавить регион для репликации, с помощью команды az sig image-version update. Это изменение займет некоторое время, так как образ реплицируется в новый регион.

az sig image-version update \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --add publishingProfile.targetRegions  name=eastus

В этом примере показано, как использовать команду az sig image-version, чтобы исключить эту версию образа из использования в качестве последнего образа.

az sig image-version update \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --set publishingProfile.excludeFromLatest=true

В этом примере показано, как использовать команду az sig image-version, чтобы включить эту версию образа в качестве последнего образа.

az sig image-version update \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --set publishingProfile.excludeFromLatest=false

Удаление ресурсов

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

Прежде чем удалить общую коллекцию сообщества, необходимо выполнить команду az sig share reset, чтобы прекратить общий доступ к коллекции.

Чтобы удалить идентификатор версии образа, выполните команду az sig image-version delete.

az sig image-version delete \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0

Удалите определение образа с помощью команды az sig image-definition delete.

az sig image-definition delete \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition

Удалите коллекцию, используя команду az sig delete.

az sig delete \
   --resource-group myGalleryRG \
   --gallery-name myGallery

Коллекции сообщества

Важно!

Коллекция вычислений Azure — это коллекции сообщества, которые в настоящее время находятся в предварительной версии и распространяются на условиях предварительной версии коллекции вычислений Azure для коллекции сообщества.

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

Чтобы отобразить список собственных коллекций и вывести общедоступные имена для ваших коллекций сообщества:

az sig list --query [*]."{Name:name,PublicName:sharingProfile.communityGalleryInfo.publicNames}"

Примечание

Чтобы получить общедоступное имя коллекции сообщества, конечный пользователь в настоящее время должен использовать портал. Выберите Виртуальные машины>Создать>Виртуальная машина Azure>Образ>Просмотреть все образы>Образы сообщества>Имя общедоступной коллекции.

Чтобы отобразить список всех определений образов, доступных в коллекции сообщества, выполните команду az sig image-definition list-community.

В этом примере мы отобразим список всех образов в коллекции ContosoImage в западной части США, а также по имени, уникальный идентификатор, необходимый для создания виртуальной машины, операционную систему и состояние ОС.

 az sig image-definition list-community \
   --public-gallery-name "ContosoImages-1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f" \
   --location westus \
   --query [*]."{Name:name,ID:uniqueId,OS:osType,State:osState}" -o table

Чтобы отобразить список версий общедоступных образов в коллекции сообщества, используйте команду az sig image-version list-community:

az sig image-version list-community \
   --location westus \
   --public-gallery-name "ContosoImages-1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f" \
   --gallery-image-definition myImageDefinition \
   --query [*]."{Name:name,UniqueId:uniqueId}" \
   -o table

Коллекции, к которым предоставлен прямой доступ

Важно!

Коллекция вычислений Azure — это общая коллекция, которая в настоящее время работает в режиме предварительной версии и распространяется на условиях предварительной версии коллекции вычислений Azure.

Чтобы опубликовать образы в коллекции, к которой предоставлен прямой доступ, на этапе предварительной версии, необходимо зарегистрироваться на странице https://aka.ms/directsharedgallery-preview. Создавать виртуальные машины из коллекции, к которой предоставлен прямой доступ, могут все пользователи Azure.

На этапе предварительной версии необходимо создать коллекцию со свойством sharingProfile.permissions со значением Groups. При использовании CLI для создания коллекции воспользуйтесь параметром --permissions groups. Нельзя использовать имеющуюся коллекцию, на данный момент свойство невозможно обновить.

Чтобы найти uniqueID коллекции, к которой вам предоставлен общий доступ, используйте az sig list-shared. В этом примере мы ищем коллекции в западном регионе США.

region=westus
az sig list-shared --location $region --query "[].uniqueId" -o tsv

Перечислите все определения изображений, к которым вам предоставлен доступ напрямую, используйте az sig image-definition list-shared.

В этом примере мы отобразим список всех образов в коллекции в западной части США, а также по имени, уникальный идентификатор, необходимый для создания виртуальной машины, операционную систему и состояние ОС.

name="1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f-myDirectShared"
 az sig image-definition list-shared \
   --gallery-unique-name $name
   --location $region \
   --query [*]."{Name:name,ID:uniqueId,OS:osType,State:osState}" -o table

Список версий изображений, к которым вам предоставили прямой доступ, с помощью az sig image-version list-shared:

imgDef="myImageDefinition"
az sig image-version list-shared \
   --location $region \
   --public-gallery-name $name \
   --gallery-image-definition $imgDef \
   --query [*]."{Name:name,UniqueId:uniqueId}" \
   -o table

Дальнейшие действия