Enumeración, actualización y eliminación de recursos de la galería

  • Artículo

Puede administrar los recursos de Azure Compute Gallery (anteriormente conocida como Shared Image Gallery) mediante la CLI de Azure o Azure PowerShell.

Enumerar galerías compartidas con el usuario

Enumere las galerías compartidas con la suscripción.

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

Enumere las galerías compartidas con el inquilino.

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

La salida contendrá el name y uniqueID público de la galería que se comparte con el usuario. Puede usar el nombre de la galería para consultar las imágenes que están disponibles a través de la galería.

A continuación se muestra una salida de ejemplo:

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

Actualización de recursos

Existen algunas limitaciones en lo que se puede actualizar. Se pueden actualizar los siguientes elementos:

Azure Compute Gallery:

  • Descripción

Definición de la imagen:

  • vCPU recomendadas:
  • Memoria recomendada
  • Descripción
  • Fecha final del ciclo de vida

Versión de la imagen:

  • Recuento de réplicas regionales
  • Regiones de destino
  • Exclusión de la versión más reciente
  • Fecha final del ciclo de vida

Actualice la descripción de una galería con az sig update.

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

Actualice la descripción de una definición de imagen con 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."

Actualice una versión de imagen para agregar una región para replicar con az sig image-version update. Este cambio tardará un poco, a medida que la imagen se replica en la nueva región.

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

En este ejemplo se muestra cómo usar az sig image-version update para impedir que esta versión de imagen se use como la imagen más reciente.

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

En este ejemplo se muestra cómo usar az sig image-version update para que esta versión de imagen se considere como imagen más reciente.

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

Eliminar recursos

Debe eliminar los recursos en orden inverso, eliminando primero la versión de imagen. Después de eliminar todas las versiones de imagen, puede eliminar la definición de imagen. Después de eliminar todas las definiciones de imagen, puede eliminar la galería.

Para poder eliminar una galería compartida de la comunidad, debe usar az sig share reset para dejar de compartir la galería públicamente.

Elimine una versión de imagen con 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

Elimine una definición de imagen con az sig image-definition delete.

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

Elimine una galería mediante az sig delete.

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

Galerías de la comunidad

Importante

El servicio Azure Compute Gallery: galerías de la comunidad está actualmente en versión preliminar y está sujeto a la Versión preliminar de los términos de Azure Compute Gallery: galería de la comunidad.

Para publicar una galería de la comunidad, deberá configurar las características en vista previa en la suscripción de Azure. La creación de máquinas virtuales desde imágenes de la galería de la comunidad está abierta a todos los usuarios de Azure.

Para mostrar sus propias galerías y generar los nombres públicos de las galerías de la comunidad:

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

Nota

Como usuario final, para obtener el nombre público de una galería de la comunidad, actualmente debe usar el portal. Vaya a Máquinas virtuales>Crear>Máquina virtual de Azure>Imagen>Ver todas las imágenes>Imágenes de la comunidad>Nombre público de la galería.

Para enumerar todas las definiciones de imagen que están disponibles en una galería de la comunidad utilice el comando az sig image-definition list-community.

En este ejemplo, se enumeran todas las imágenes de la galería ContosoImage en la región Oeste de EE. UU. y por nombre, el identificador único necesario para crear una máquina virtual, el sistema operativo y el estado del sistema operativo.

 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

Enumere las versiones de imágenes compartidas en una galería de la comunidad mediante az sig image-version list:

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

Galerías compartidas directas

Importante

Azure Compute Gallery: la galería compartida directa está actualmente en versión preliminar y sujeta a los Términos de versión preliminar de Azure Compute Gallery.

Para publicar imágenes en una galería compartida directa durante la versión preliminar, debe registrarse en https://aka.ms/directsharedgallery-preview. La creación de máquinas virtuales desde la galería de compartida está disponible para todos los usuarios de Azure.

Durante la versión preliminar, debe crear una nueva galería, con la propiedad sharingProfile.permissions establecida en Groups. Al usar la CLI para crear una galería, especifique el parámetro --permissions groups. No se puede usar una galería existente, la propiedad no se puede actualizar en este momento.

Para buscar el elemento uniqueID de una galería que se comparte con el usuario, use az sig list-shared. En este ejemplo, estamos buscando galerías en la región Oeste de EE. UU.

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

Enumere todas las definiciones de imagen que se comparten directamente con el usuario, use az sig image-definition list-shared.

En este ejemplo, se enumeran todas las imágenes de la galería en la región Oeste de EE. UU. y por nombre, el identificador único necesario para crear una máquina virtual, el sistema operativo y el estado del sistema operativo.

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

Enumere las versiones de imagen compartidas directamente con 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

Pasos siguientes