Shared Gallery Images - Get

Servicio:: Compute

Versión de la API:: 2024-03-03

Obtenga una imagen de galería compartida por identificador de suscripción o identificador de inquilino.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/sharedGalleries/{galleryUniqueName}/images/{galleryImageName}?api-version=2024-03-03

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
galleryImageName	path	True	string	El nombre de la definición de imagen de la galería compartida desde la que se van a enumerar las versiones de imagen.
galleryUniqueName	path	True	string	El nombre único de la Galería Compartida.
location	path	True	string minLength: 1	Nombre de la región de Azure.
subscriptionId	path	True	string minLength: 1	Identificador de la suscripción de destino.
api-version	query	True	string minLength: 1	Versión de API que se usará para la operación.

Respuestas

Nombre	Tipo	Description
200 OK	SharedGalleryImage	La operación de Azure se completó correctamente.
Other Status Codes	CloudError	Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

Get a shared gallery image.

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/myLocation/sharedGalleries/galleryUniqueName/images/myGalleryImageName?api-version=2024-03-03

Respuesta de muestra

status code:: 200

{
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    },
    "eula": "https://www.microsoft.com/en-us/",
    "artifactTags": {
      "ShareTag-Official1PGallery": "Official1PGallery"
    }
  },
  "location": "myLocation",
  "name": "myGalleryImageName",
  "identifier": {
    "uniqueId": "/SharedGalleries/galleryUniqueName/Images/myGalleryImageName"
  }
}

Definiciones

Nombre	Description
ApiError	Error de API.
ApiErrorBase	Base de errores de API.
Architecture	Arquitectura de la imagen. Solo se aplica a los discos del sistema operativo.
CloudError	Una respuesta de error del servicio de proceso.
Disallowed	Describe los tipos de disco no permitidos.
GalleryImageFeature	Una característica para la imagen de la galería.
GalleryImageIdentifier	Este es el identificador de definición de imagen de la galería.
HyperVGeneration	Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo.
ImagePurchasePlan	Describe el plan de compra de la definición de imagen de la galería. Esto lo usan las imágenes de Marketplace.
InnerError	Detalles del error interno.
OperatingSystemStateTypes	Esta propiedad permite al usuario especificar si las máquinas virtuales creadas en esta imagen son "Generalizadas" o "Especializadas".
OperatingSystemTypes	Esta propiedad permite especificar el tipo del sistema operativo que se incluye en el disco al crear una máquina virtual a partir de una imagen administrada. Los valores posibles son: Windows,Linux.
RecommendedMachineConfiguration	Las propiedades describen la configuración de máquina recomendada para esta definición de imagen. Estas propiedades son actualizables.
ResourceRange	Describe el intervalo de recursos.
SharedGalleryImage	Especifica información sobre la definición de imagen de galería que desea crear o actualizar.

ApiError

Objeto

Error de API.

Nombre	Tipo	Description
code	string	Código de error.
details	ApiErrorBase[]	Detalles del error de la API
innererror	InnerError	El error interno de la API
message	string	El mensaje de error.
target	string	Destino del error concreto.

ApiErrorBase

Objeto

Base de errores de API.

Nombre	Tipo	Description
code	string	Código de error.
message	string	El mensaje de error.
target	string	Destino del error concreto.

Architecture

Enumeración

Arquitectura de la imagen. Solo se aplica a los discos del sistema operativo.

Valor	Description
x64
Arm64

CloudError

Objeto

Una respuesta de error del servicio de proceso.

Nombre	Tipo	Description
error	ApiError	Error de API.

Disallowed

Objeto

Describe los tipos de disco no permitidos.

Nombre	Tipo	Description
diskTypes	string[]	Lista de tipos de disco.

GalleryImageFeature

Objeto

Una característica para la imagen de la galería.

Nombre	Tipo	Description
name	string	Nombre de la característica de imagen de la galería.
startsAtVersion	string	Versión mínima de la imagen de la galería que admite esta característica.
value	string	Valor de la característica de imagen de la galería.

GalleryImageIdentifier

Objeto

Este es el identificador de definición de imagen de la galería.

Nombre	Tipo	Description
offer	string	Nombre de la oferta de definición de imagen de la galería.
publisher	string	Nombre del publicador de definiciones de imágenes de la galería.
sku	string	Nombre de la SKU de definición de imagen de la galería.

HyperVGeneration

Enumeración

Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo.

Valor	Description
V1
V2

ImagePurchasePlan

Objeto

Describe el plan de compra de la definición de imagen de la galería. Esto lo usan las imágenes de Marketplace.

Nombre	Tipo	Description
name	string	Identificador del plan.
product	string	Identificador del producto.
publisher	string	Identificador del publicador.

InnerError

Objeto

Detalles del error interno.

Nombre	Tipo	Description
errordetail	string	El mensaje de error interno o el volcado de excepción.
exceptiontype	string	El tipo de excepción.

OperatingSystemStateTypes

Enumeración

Esta propiedad permite al usuario especificar si las máquinas virtuales creadas en esta imagen son "Generalizadas" o "Especializadas".

Valor	Description
Generalized	Imagen generalizada. Debe aprovisionarse durante el tiempo de implementación.
Specialized	Imagen especializada. Contiene el disco del sistema operativo ya aprovisionado.

OperatingSystemTypes

Enumeración

Esta propiedad permite especificar el tipo del sistema operativo que se incluye en el disco al crear una máquina virtual a partir de una imagen administrada. Los valores posibles son: Windows,Linux.

Valor	Description
Windows
Linux

RecommendedMachineConfiguration

Objeto

Las propiedades describen la configuración de máquina recomendada para esta definición de imagen. Estas propiedades son actualizables.

Nombre	Tipo	Description
memory	ResourceRange	Describe el intervalo de recursos.
vCPUs	ResourceRange	Describe el intervalo de recursos.

ResourceRange

Objeto

Describe el intervalo de recursos.

Nombre	Tipo	Description
max	integer (int32)	Número máximo del recurso.
min	integer (int32)	Número mínimo del recurso.