Compartir a través de


Virtual Machine Images - Get

Obtiene una imagen de máquina virtual.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/publishers/{publisherName}/artifacttypes/vmimage/offers/{offer}/skus/{skus}/versions/{version}?api-version=2025-04-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
location
path True

string

minLength: 1

Nombre de la región de Azure.

offer
path True

string

Una oferta válida del editor de imágenes.

publisherName
path True

string

Un editor de imágenes válido.

skus
path True

string

Una SKU de imagen válida.

subscriptionId
path True

string

minLength: 1

Identificador de la suscripción de destino.

version
path True

string

Una versión válida de SKU de imagen.

api-version
query True

string

minLength: 1

Versión de API que se usará para la operación.

Respuestas

Nombre Tipo Description
200 OK

VirtualMachineImage

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

VirtualMachineImage_Get_MaximumSet_Gen
VirtualMachineImage_Get_MinimumSet_Gen

VirtualMachineImage_Get_MaximumSet_Gen

Solicitud de ejemplo

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/aaaaaa/publishers/aaa/artifacttypes/vmimage/offers/aaaaaaaaaaaaaaaaaaaaaaaaaaaaa/skus/aaaaaaaaaaaaaaaaaaaaaaaaaaa/versions/aaaaaaaaaaaaaaaaaaa?api-version=2025-04-01

Respuesta de muestra

{
  "properties": {
    "plan": {
      "publisher": "aaaaaaaaaaaaaaaaaaa",
      "name": "aaaaaaaaa",
      "product": "aaaaaaaaaaaaaa"
    },
    "osDiskImage": {
      "operatingSystem": "Windows"
    },
    "dataDiskImages": [
      {
        "lun": 17
      }
    ],
    "automaticOSUpgradeProperties": {
      "automaticOSUpgradeSupported": true
    },
    "hyperVGeneration": "V1",
    "disallowed": {
      "vmDiskType": "None"
    },
    "features": [
      {
        "name": "aaaaaaaaaaaaaaaaaaaaa",
        "value": "aaaaaaaaaaaaaaaaaaaa"
      }
    ],
    "imageDeprecationStatus": {
      "imageState": "ScheduledForDeprecation",
      "scheduledDeprecationTime": "2023-01-13T00:00:00+00:00",
      "alternativeOption": {
        "type": "Offer",
        "value": "aaaaaaa"
      }
    }
  },
  "name": "aaaaaaaaa",
  "location": "aaaaa",
  "tags": {
    "key6817": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  },
  "extendedLocation": {
    "name": "aaaaaaaaaaaaaaaaaaaaa",
    "type": "EdgeZone"
  },
  "id": "aaaaaaaaaaa"
}

VirtualMachineImage_Get_MinimumSet_Gen

Solicitud de ejemplo

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/aaaaaaaaaaaa/publishers/aaaaaaaaaaa/artifacttypes/vmimage/offers/aa/skus/aaaaaaaaa/versions/aaaaaaaaaaaaaaaaaaaaaaaaaaaaa?api-version=2025-04-01

Respuesta de muestra

{
  "name": "aaaaaaaaa",
  "location": "aaaaa",
  "id": "aaaaaaaaaaa"
}

Definiciones

Nombre Description
AlternativeOption

Describe la opción alternativa especificada por el publicador para esta imagen cuando esta imagen está en desuso.

AlternativeType

Describe el tipo de la opción alternativa.

ApiError

Error de API.

ApiErrorBase

Base de errores de API.

ArchitectureTypes

Especifica el tipo de arquitectura

AutomaticOSUpgradeProperties

Describe las propiedades de actualización automática del sistema operativo en la imagen.

CloudError

Una respuesta de error del servicio de proceso.

DataDiskImage

Contiene la información de las imágenes de disco de datos.

DisallowedConfiguration

Especifica la configuración no permitida para una imagen de máquina virtual.

ExtendedLocation

Tipo complejo de la ubicación extendida.

ExtendedLocationTypes

El tipo de la ubicación extendida.

HyperVGenerationTypes

Especifica el tipo de HyperVGeneration

ImageDeprecationStatus

Describe las propiedades de estado de desuso de la imagen en la imagen.

ImageState

Describe el estado de la imagen.

InnerError

Detalles del error interno.

OperatingSystemTypes

Esta propiedad permite especificar el tipo del sistema operativo que se incluye en el disco si crea una máquina virtual a partir de una imagen de usuario o un VHD especializado. Los valores posibles son: Windows,Linux.

OSDiskImage

Contiene la información de la imagen de disco del sistema operativo.

PurchasePlan

Se utiliza para establecer el contexto de compra de cualquier artefacto de terceros a través de MarketPlace.

VirtualMachineImage

Describe una imagen de máquina virtual.

VirtualMachineImageFeature

Especifica capacidades adicionales admitidas por la imagen

VmDiskTypes

Tipos de disco de máquina virtual que no están permitidos.

AlternativeOption

Describe la opción alternativa especificada por el publicador para esta imagen cuando esta imagen está en desuso.

Nombre Tipo Description
type

AlternativeType

Describe el tipo de la opción alternativa.

value

string

Indica el valor de la opción alternativa especificado por el publicador. Este es el nombre de la oferta cuando el tipo es Oferta o el nombre del plan cuando el tipo es Plan.

AlternativeType

Describe el tipo de la opción alternativa.

Valor Description
None
Offer
Plan

ApiError

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

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.

ArchitectureTypes

Especifica el tipo de arquitectura

Valor Description
x64
Arm64

AutomaticOSUpgradeProperties

Describe las propiedades de actualización automática del sistema operativo en la imagen.

Nombre Tipo Description
automaticOSUpgradeSupported

boolean

Especifica si la actualización automática del sistema operativo es compatible con la imagen.

CloudError

Una respuesta de error del servicio de proceso.

Nombre Tipo Description
error

ApiError

Error de API.

DataDiskImage

Contiene la información de las imágenes de disco de datos.

Nombre Tipo Description
lun

integer (int32)

Especifica el número de unidad lógica del disco de datos. Este valor se usa para identificar discos de datos dentro de la máquina virtual y, por tanto, debe ser único para cada disco de datos conectado a una máquina virtual.

DisallowedConfiguration

Especifica la configuración no permitida para una imagen de máquina virtual.

Nombre Tipo Description
vmDiskType

VmDiskTypes

Tipos de disco de máquina virtual que no están permitidos.

ExtendedLocation

Tipo complejo de la ubicación extendida.

Nombre Tipo Description
name

string

Nombre de la ubicación extendida.

type

ExtendedLocationTypes

El tipo de la ubicación extendida.

ExtendedLocationTypes

El tipo de la ubicación extendida.

Valor Description
EdgeZone

HyperVGenerationTypes

Especifica el tipo de HyperVGeneration

Valor Description
V1
V2

ImageDeprecationStatus

Describe las propiedades de estado de desuso de la imagen en la imagen.

Nombre Tipo Description
alternativeOption

AlternativeOption

Describe la opción alternativa especificada por el publicador para esta imagen cuando esta imagen está en desuso.

imageState

ImageState

Describe el estado de la imagen.

scheduledDeprecationTime

string (date-time)

El momento, en el futuro, en el que esta imagen se marcará como obsoleta. Esta hora programada es elegida por el publicador.

ImageState

Describe el estado de la imagen.

Valor Description
Active
ScheduledForDeprecation
Deprecated

InnerError

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.

OperatingSystemTypes

Esta propiedad permite especificar el tipo del sistema operativo que se incluye en el disco si crea una máquina virtual a partir de una imagen de usuario o un VHD especializado. Los valores posibles son: Windows,Linux.

Valor Description
Windows
Linux

OSDiskImage

Contiene la información de la imagen de disco del sistema operativo.

Nombre Tipo Description
operatingSystem

OperatingSystemTypes

El sistema operativo de osDiskImage.

PurchasePlan

Se utiliza para establecer el contexto de compra de cualquier artefacto de terceros a través de MarketPlace.

Nombre Tipo Description
name

string

Identificador del plan.

product

string

Especifica el producto de la imagen de Marketplace. Este es el mismo valor que Offer en el elemento imageReference.

publisher

string

Identificador del publicador.

VirtualMachineImage

Describe una imagen de máquina virtual.

Nombre Tipo Description
extendedLocation

ExtendedLocation

Ubicación extendida de la máquina virtual.

id

string

Identificador de recurso

location

string

La ubicación de Azure admitida del recurso.

name

string

Nombre del recurso.

properties.architecture

ArchitectureTypes

Especifica el tipo de arquitectura

properties.automaticOSUpgradeProperties

AutomaticOSUpgradeProperties

Describe las propiedades de actualización automática del sistema operativo en la imagen.

properties.dataDiskImages

DataDiskImage[]

La lista de información de imágenes de disco de datos.

properties.disallowed

DisallowedConfiguration

Especifica la configuración no permitida para la VirtualMachine creada a partir de la imagen

properties.features

VirtualMachineImageFeature[]

Especifica capacidades adicionales admitidas por la imagen

properties.hyperVGeneration

HyperVGenerationTypes

Especifica el tipo de HyperVGeneration

properties.imageDeprecationStatus

ImageDeprecationStatus

Describe las propiedades de estado de desuso de la imagen en la imagen.

properties.osDiskImage

OSDiskImage

Contiene la información de la imagen de disco del sistema operativo.

properties.plan

PurchasePlan

Se utiliza para establecer el contexto de compra de cualquier artefacto de terceros a través de MarketPlace.

tags

object

Especifica las etiquetas asignadas a la máquina virtual. Para obtener más información sobre el uso de etiquetas, consulte Uso de etiquetas para organizar los recursos de Azure.

VirtualMachineImageFeature

Especifica capacidades adicionales admitidas por la imagen

Nombre Tipo Description
name

string

Nombre de la característica.

value

string

El valor correspondiente para la entidad.

VmDiskTypes

Tipos de disco de máquina virtual que no están permitidos.

Valor Description
None
Unmanaged