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=2024-07-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
location
path True

string

Nombre de una región de Azure admitida.

offer
path True

string

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

publisherName
path True

string

Publicador de imágenes válido.

skus
path True

string

Una SKU de imagen válida.

subscriptionId
path True

string

Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI de cada llamada de servicio.

version
path True

string

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

api-version
query True

string

Versión de api de cliente.

Respuestas

Nombre Tipo Description
200 OK

VirtualMachineImage

De acuerdo

Other Status Codes

CloudError

Respuesta de error que describe por qué se produjo un error en la operación.

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=2024-07-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=2024-07-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

Respuesta de error del servicio Compute.

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

Tipo de la ubicación extendida.

HyperVGenerationTypes

Especifica el tipo 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

Sistema operativo de osDiskImage.

OSDiskImage

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

PurchasePlan

Se usa 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 funcionalidades adicionales admitidas por la imagen

VmDiskTypes

Tipos de disco de máquina virtual que no se permiten.

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 opción alternativo 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 api

innererror

InnerError

Error interno de api

message

string

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

Mensaje de error.

target

string

Destino del error concreto.

ArchitectureTypes

Especifica el tipo de arquitectura.

Valor Description
Arm64
x64

AutomaticOSUpgradeProperties

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

Nombre Tipo Description
automaticOSUpgradeSupported

boolean

Especifica si se admite la actualización automática del sistema operativo en la imagen.

CloudError

Respuesta de error del servicio Compute.

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

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 se permiten.

ExtendedLocation

Tipo complejo de la ubicación extendida.

Nombre Tipo Description
name

string

Nombre de la ubicación extendida.

type

ExtendedLocationTypes

Tipo de la ubicación extendida.

ExtendedLocationTypes

Tipo de la ubicación extendida.

Valor Description
EdgeZone

HyperVGenerationTypes

Especifica el tipo 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

El momento, en el futuro, en el que esta imagen se marcará como en desuso. El publicador elige esta hora programada.

ImageState

Describe el estado de la imagen.

Valor Description
Active
Deprecated
ScheduledForDeprecation

InnerError

Detalles del error interno.

Nombre Tipo Description
errordetail

string

Mensaje de error interno o volcado de memoria de excepciones.

exceptiontype

string

Tipo de excepción.

OperatingSystemTypes

Sistema operativo de osDiskImage.

Valor Description
Linux
Windows

OSDiskImage

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

Nombre Tipo Description
operatingSystem

OperatingSystemTypes

Sistema operativo de osDiskImage.

PurchasePlan

Se usa 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

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[]

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

properties.disallowed

DisallowedConfiguration

Especifica la configuración no permitida para la máquina virtual creada a partir de la imagen.

properties.features

VirtualMachineImageFeature[]

Especifica funcionalidades adicionales admitidas por la imagen

properties.hyperVGeneration

HyperVGenerationTypes

Especifica el tipo 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 del disco del sistema operativo.

properties.plan

PurchasePlan

Se usa 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 más información sobre el uso de etiquetas, consulte Uso de etiquetas para organizar los recursos de Azure.

VirtualMachineImageFeature

Especifica funcionalidades adicionales admitidas por la imagen

Nombre Tipo Description
name

string

Nombre de la característica.

value

string

Valor correspondiente de la característica.

VmDiskTypes

Tipos de disco de máquina virtual que no se permiten.

Valor Description
None
Unmanaged