Imágenes de Microsoft.Compute 2023-07-01

Definición de recursos de Bicep

El tipo de recurso images se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Compute/images, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Compute/images@2023-07-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  extendedLocation: {
    name: 'string'
    type: 'EdgeZone'
  }
  properties: {
    hyperVGeneration: 'string'
    sourceVirtualMachine: {
      id: 'string'
    }
    storageProfile: {
      dataDisks: [
        {
          blobUri: 'string'
          caching: 'string'
          diskEncryptionSet: {
            id: 'string'
          }
          diskSizeGB: int
          lun: int
          managedDisk: {
            id: 'string'
          }
          snapshot: {
            id: 'string'
          }
          storageAccountType: 'string'
        }
      ]
      osDisk: {
        blobUri: 'string'
        caching: 'string'
        diskEncryptionSet: {
          id: 'string'
        }
        diskSizeGB: int
        managedDisk: {
          id: 'string'
        }
        osState: 'string'
        osType: 'string'
        snapshot: {
          id: 'string'
        }
        storageAccountType: 'string'
      }
      zoneResilient: bool
    }
  }
}

Valores de propiedad

images

Nombre Descripción Value
name El nombre del recurso string (obligatorio)

Límite de caracteres: 1-80

Caracteres válidos:
Caracteres alfanuméricos, de subrayado, puntos y guiones.

Comience con un carácter alfanumérico. Termine con un carácter alfanumérico o de subrayado.
ubicación Ubicación de los recursos string (obligatorio)
etiquetas Etiquetas del recurso Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
extendedLocation Ubicación extendida de la imagen. ExtendedLocation
properties Describe las propiedades de una imagen. ImageProperties

ExtendedLocation

Nombre Descripción Value
name Nombre de la ubicación extendida. string
type Tipo de la ubicación extendida. 'EdgeZone'

ImageProperties

Nombre Descripción Valor
hyperVGeneration Especifica el HyperVGenerationType del objeto VirtualMachine creado a partir de la imagen. Desde la versión de API 2019-03-01 si el origen de la imagen es un blob, es necesario que el usuario especifique el valor, si el origen es un recurso administrado como disco o instantánea, es posible que sea necesario que el usuario especifique la propiedad si no se puede deducir del recurso administrado de origen. 'V1'
'V2'
sourceVirtualMachine Máquina virtual de origen desde la que se crea la imagen. SubResource
storageProfile Especifica la configuración de almacenamiento de los discos de máquina virtual. ImageStorageProfile

SubResource

Nombre Descripción Value
id Id. de recurso string

ImageStorageProfile

Nombre Descripción Valor
dataDisks Especifica los parámetros que se usan para agregar un disco de datos a una máquina virtual.

Para más información sobre los discos, consulte Acerca de los discos y discos duros virtuales para máquinas virtuales de Azure.
ImageDataDisk[]
osDisk Especifica información sobre el disco del sistema operativo usado por la máquina virtual.

Para más información sobre los discos, consulte Acerca de los discos y discos duros virtuales para máquinas virtuales de Azure.
ImageOSDisk
zoneResilient Especifica si una imagen es resistente a zonas o no. El valor predeterminado es False. Las imágenes resistentes a zonas solo se pueden crear en regiones que proporcionan almacenamiento con redundancia de zona (ZRS). bool

ImageDataDisk

Nombre Descripción Valor
blobUri Disco duro virtual. string
el almacenamiento en caché Especifica los requisitos de almacenamiento en caché. Los valores posibles son: None,ReadOnly,ReadWrite. Los valores predeterminados son: Ninguno para el almacenamiento estándar. ReadOnly para Premium Storage. 'Ninguno'
'ReadOnly'
"ReadWrite"
diskEncryptionSet Especifica el identificador de recurso del conjunto de cifrado de disco administrado por el cliente para el disco de imagen administrada. DiskEncryptionSetParameters
diskSizeGB Especifica el tamaño de los discos de datos vacíos en gigabytes. Este elemento se puede usar para sobrescribir el nombre del disco en una imagen de máquina virtual. Este valor no puede ser mayor que 1023 GB. int
lun 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. int (obligatorio)
managedDisk ManagedDisk. SubResource
instantánea Instantánea. SubResource
storageAccountType Especifica el tipo de cuenta de almacenamiento para el disco administrado. NOTA: UltraSSD_LRS solo se puede usar con discos de datos, no se puede usar con el disco del sistema operativo. 'PremiumV2_LRS'
'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'
'UltraSSD_LRS'

DiskEncryptionSetParameters

Nombre Descripción Value
id Id. de recurso string

ImageOSDisk

Nombre Descripción Valor
blobUri Disco duro virtual. string
el almacenamiento en caché Especifica los requisitos de almacenamiento en caché. Los valores posibles son: None,ReadOnly,ReadWrite. Los valores predeterminados son: Ninguno para el almacenamiento estándar. ReadOnly para Premium Storage. 'Ninguno'
'ReadOnly'
"ReadWrite"
diskEncryptionSet Especifica el identificador de recurso del conjunto de cifrado de disco administrado por el cliente para el disco de imagen administrada. DiskEncryptionSetParameters
diskSizeGB Especifica el tamaño de los discos de datos vacíos en gigabytes. Este elemento se puede usar para sobrescribir el nombre del disco en una imagen de máquina virtual. Este valor no puede ser mayor que 1023 GB. int
managedDisk ManagedDisk. SubResource
osState Estado del sistema operativo. En el caso de las imágenes administradas, use Generalizado. "Generalizado"
'Specialized' (obligatorio)
osType 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 personalizada. Los valores posibles son: Windows,Linux. "Linux"
'Windows' (obligatorio)
instantánea Instantánea. SubResource
storageAccountType Especifica el tipo de cuenta de almacenamiento para el disco administrado. NOTA: UltraSSD_LRS solo se puede usar con discos de datos, no se puede usar con el disco del sistema operativo. 'PremiumV2_LRS'
'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'
'UltraSSD_LRS'

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Creación de una máquina virtual a partir de una imagen de usuario

Implementación en Azure
Esta plantilla permite crear una Virtual Machines a partir de una imagen de usuario. Esta plantilla también implementa una Virtual Network, direcciones IP públicas y una interfaz de red.
Creación de una máquina virtual en una red virtual nueva o existente a partir de un VHD generalizado

Implementación en Azure
Esta plantilla crea una máquina virtual a partir de un VHD generalizado y le permite conectarla a una red virtual nueva o existente que pueda residir en otro grupo de recursos que la máquina virtual.
Implementación de un conjunto de escalado de máquinas virtuales con una imagen personalizada de Linux

Implementación en Azure
Esta plantilla permite implementar una imagen de Linux de máquina virtual personalizada dentro de un conjunto de escalado. Estas máquinas virtuales están detrás de un equilibrador de carga con equilibrio de carga HTTP (de forma predeterminada en el puerto 80). En el ejemplo se usa un script personalizado para realizar la implementación y actualización de la aplicación, es posible que tenga que proporcionar el script personalizado para su propio procedimiento de actualización. Tendrá que proporcionar una imagen generalizada de la máquina virtual en la misma suscripción y región donde cree vmSS.
Implementación de un conjunto de escalado de máquinas virtuales con una imagen personalizada de Windows

Implementación en Azure
Esta plantilla permite implementar un conjunto de escalado de máquinas virtuales simple mediante una imagen personalizada de Windows. Estas máquinas virtuales están detrás de un equilibrador de carga con equilibrio de carga HTTP (de forma predeterminada en el puerto 80).

Definición de recursos de plantilla de ARM

El tipo de recurso images se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Compute/images, agregue el siguiente json a la plantilla.

{
  "type": "Microsoft.Compute/images",
  "apiVersion": "2023-07-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "extendedLocation": {
    "name": "string",
    "type": "EdgeZone"
  },
  "properties": {
    "hyperVGeneration": "string",
    "sourceVirtualMachine": {
      "id": "string"
    },
    "storageProfile": {
      "dataDisks": [
        {
          "blobUri": "string",
          "caching": "string",
          "diskEncryptionSet": {
            "id": "string"
          },
          "diskSizeGB": "int",
          "lun": "int",
          "managedDisk": {
            "id": "string"
          },
          "snapshot": {
            "id": "string"
          },
          "storageAccountType": "string"
        }
      ],
      "osDisk": {
        "blobUri": "string",
        "caching": "string",
        "diskEncryptionSet": {
          "id": "string"
        },
        "diskSizeGB": "int",
        "managedDisk": {
          "id": "string"
        },
        "osState": "string",
        "osType": "string",
        "snapshot": {
          "id": "string"
        },
        "storageAccountType": "string"
      },
      "zoneResilient": "bool"
    }
  }
}

Valores de propiedad

images

Nombre Descripción Value
type Tipo de recurso "Microsoft.Compute/images"
apiVersion La versión de la API de recursos '2023-07-01'
name El nombre del recurso string (obligatorio)

Límite de caracteres: 1-80

Caracteres válidos:
Caracteres alfanuméricos, de subrayado, puntos y guiones.

Comience con un carácter alfanumérico. Termine con un carácter alfanumérico o de subrayado.
ubicación Ubicación de los recursos string (obligatorio)
etiquetas Etiquetas del recurso Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
extendedLocation Ubicación extendida de la imagen. ExtendedLocation
properties Describe las propiedades de una imagen. ImageProperties

ExtendedLocation

Nombre Descripción Value
name Nombre de la ubicación extendida. string
type Tipo de la ubicación extendida. 'EdgeZone'

ImageProperties

Nombre Descripción Valor
hyperVGeneration Especifica el HyperVGenerationType del virtualMachine creado a partir de la imagen. Desde la versión de API 2019-03-01 si el origen de la imagen es un blob, necesitamos que el usuario especifique el valor, si el origen es un recurso administrado como disco o instantánea, es posible que sea necesario que el usuario especifique la propiedad si no se puede deducir del recurso administrado de origen. 'V1'
'V2'
sourceVirtualMachine Máquina virtual de origen a partir de la que se crea la imagen. SubResource
storageProfile Especifica la configuración de almacenamiento de los discos de máquina virtual. ImageStorageProfile

SubResource

Nombre Descripción Value
id Id. de recurso string

ImageStorageProfile

Nombre Descripción Valor
dataDisks Especifica los parámetros que se usan para agregar un disco de datos a una máquina virtual.

Para más información sobre los discos, consulte Acerca de los discos y discos duros virtuales para máquinas virtuales de Azure.
ImageDataDisk[]
osDisk Especifica información sobre el disco del sistema operativo utilizado por la máquina virtual.

Para más información sobre los discos, consulte Acerca de los discos y discos duros virtuales para máquinas virtuales de Azure.
ImageOSDisk
zoneResilient Especifica si una imagen es resistente a la zona o no. El valor predeterminado es False. Las imágenes resistentes a zonas solo se pueden crear en regiones que proporcionan almacenamiento con redundancia de zona (ZRS). bool

ImageDataDisk

Nombre Descripción Valor
blobUri Disco duro virtual. string
el almacenamiento en caché Especifica los requisitos de almacenamiento en caché. Los valores posibles son: None,ReadOnly,ReadWrite. Los valores predeterminados son: None para standard storage. ReadOnly para Premium Storage. 'Ninguno'
'ReadOnly'
"ReadWrite"
diskEncryptionSet Especifica el identificador de recurso del conjunto de cifrado de disco administrado por el cliente para el disco de imagen administrada. DiskEncryptionSetParameters
diskSizeGB Especifica el tamaño de los discos de datos vacíos en gigabytes. Este elemento se puede usar para sobrescribir el nombre del disco en una imagen de máquina virtual. Este valor no puede ser mayor que 1023 GB. int
lun 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. int (obligatorio)
managedDisk ManagedDisk. SubResource
instantánea Instantánea. SubResource
storageAccountType Especifica el tipo de cuenta de almacenamiento para el disco administrado. NOTA: UltraSSD_LRS solo se puede usar con discos de datos, no se puede usar con disco del sistema operativo. 'PremiumV2_LRS'
'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'
'UltraSSD_LRS'

DiskEncryptionSetParameters

Nombre Descripción Value
id Id. de recurso string

ImageOSDisk

Nombre Descripción Valor
blobUri Disco duro virtual. string
el almacenamiento en caché Especifica los requisitos de almacenamiento en caché. Los valores posibles son: None,ReadOnly,ReadWrite. Los valores predeterminados son: None para standard storage. ReadOnly para Premium Storage. 'Ninguno'
'ReadOnly'
"ReadWrite"
diskEncryptionSet Especifica el identificador de recurso del conjunto de cifrado de disco administrado por el cliente para el disco de imagen administrada. DiskEncryptionSetParameters
diskSizeGB Especifica el tamaño de los discos de datos vacíos en gigabytes. Este elemento se puede usar para sobrescribir el nombre del disco en una imagen de máquina virtual. Este valor no puede ser mayor que 1023 GB. int
managedDisk ManagedDisk. SubResource
osState Estado del sistema operativo. En el caso de las imágenes administradas, use Generalizado. 'Generalizado'
'Specialized' (obligatorio)
osType 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 personalizada. Los valores posibles son: Windows,Linux. 'Linux'
'Windows' (obligatorio)
instantánea Instantánea. SubResource
storageAccountType Especifica el tipo de cuenta de almacenamiento para el disco administrado. NOTA: UltraSSD_LRS solo se puede usar con discos de datos, no se puede usar con disco del sistema operativo. 'PremiumV2_LRS'
'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'
'UltraSSD_LRS'

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Creación de una máquina virtual a partir de una imagen de usuario

Implementación en Azure
Esta plantilla le permite crear un Virtual Machines a partir de una imagen de usuario. Esta plantilla también implementa una Virtual Network, direcciones IP públicas y una interfaz de red.
Creación de una máquina virtual en una red virtual nueva o existente a partir de un VHD generalizado

Implementación en Azure
Esta plantilla crea una máquina virtual a partir de un VHD generalizado y le permite conectarla a una red virtual nueva o existente que pueda residir en otro grupo de recursos que la máquina virtual.
Implementación de un conjunto de escalado de máquinas virtuales con una imagen personalizada de Linux

Implementación en Azure
Esta plantilla le permite implementar una imagen de Linux de máquina virtual personalizada dentro de un conjunto de escalado. Estas máquinas virtuales están detrás de un equilibrador de carga con equilibrio de carga HTTP (de forma predeterminada en el puerto 80). En el ejemplo se usa un script personalizado para realizar la implementación y actualización de la aplicación, es posible que tenga que proporcionar el script personalizado para su propio procedimiento de actualización. Tendrá que proporcionar una imagen generalizada de la máquina virtual en la misma suscripción y región en la que cree el VMSS.
Implementación de un conjunto de escalado de máquinas virtuales con una imagen personalizada de Windows

Implementación en Azure
Esta plantilla le permite implementar un conjunto de escalado de máquinas virtuales simple mediante una imagen personalizada de Windows. Estas máquinas virtuales están detrás de un equilibrador de carga con equilibrio de carga HTTP (de forma predeterminada en el puerto 80)

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso images se puede implementar con operaciones destinadas a:

  • Grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Compute/images, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/images@2023-07-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      hyperVGeneration = "string"
      sourceVirtualMachine = {
        id = "string"
      }
      storageProfile = {
        dataDisks = [
          {
            blobUri = "string"
            caching = "string"
            diskEncryptionSet = {
              id = "string"
            }
            diskSizeGB = int
            lun = int
            managedDisk = {
              id = "string"
            }
            snapshot = {
              id = "string"
            }
            storageAccountType = "string"
          }
        ]
        osDisk = {
          blobUri = "string"
          caching = "string"
          diskEncryptionSet = {
            id = "string"
          }
          diskSizeGB = int
          managedDisk = {
            id = "string"
          }
          osState = "string"
          osType = "string"
          snapshot = {
            id = "string"
          }
          storageAccountType = "string"
        }
        zoneResilient = bool
      }
    }
    extendedLocation = {
      name = "string"
      type = "EdgeZone"
    }
  })
}

Valores de propiedad

images

Nombre Descripción Value
type Tipo de recurso "Microsoft.Compute/images@2023-07-01"
name El nombre del recurso string (obligatorio)

Límite de caracteres: 1-80

Caracteres válidos:
Caracteres alfanuméricos, de subrayado, puntos y guiones.

Comience con un carácter alfanumérico. Termine con un carácter alfanumérico o de subrayado.
ubicación Ubicación de los recursos string (obligatorio)
parent_id Para realizar la implementación en un grupo de recursos, use el identificador de ese grupo de recursos. string (obligatorio)
etiquetas Etiquetas del recurso Diccionario de nombres y valores de etiqueta.
extendedLocation Ubicación extendida de la imagen. ExtendedLocation
properties Describe las propiedades de una imagen. ImageProperties

ExtendedLocation

Nombre Descripción Value
name Nombre de la ubicación extendida. string
type Tipo de la ubicación extendida. "EdgeZone"

ImageProperties

Nombre Descripción Valor
hyperVGeneration Especifica el HyperVGenerationType del objeto VirtualMachine creado a partir de la imagen. Desde la versión de API 2019-03-01 si el origen de la imagen es un blob, es necesario que el usuario especifique el valor, si el origen es un recurso administrado como disco o instantánea, es posible que sea necesario que el usuario especifique la propiedad si no se puede deducir del recurso administrado de origen. "V1"
"V2"
sourceVirtualMachine Máquina virtual de origen desde la que se crea la imagen. SubResource
storageProfile Especifica la configuración de almacenamiento de los discos de máquina virtual. ImageStorageProfile

SubResource

Nombre Descripción Value
id Id. de recurso string

ImageStorageProfile

Nombre Descripción Valor
dataDisks Especifica los parámetros que se usan para agregar un disco de datos a una máquina virtual.

Para más información sobre los discos, consulte Acerca de los discos y discos duros virtuales para máquinas virtuales de Azure.
ImageDataDisk[]
osDisk Especifica información sobre el disco del sistema operativo usado por la máquina virtual.

Para más información sobre los discos, consulte Acerca de los discos y discos duros virtuales para máquinas virtuales de Azure.
ImageOSDisk
zoneResilient Especifica si una imagen es resistente a zonas o no. El valor predeterminado es False. Las imágenes resistentes a zonas solo se pueden crear en regiones que proporcionan almacenamiento con redundancia de zona (ZRS). bool

ImageDataDisk

Nombre Descripción Valor
blobUri Disco duro virtual. string
el almacenamiento en caché Especifica los requisitos de almacenamiento en caché. Los valores posibles son: None,ReadOnly,ReadWrite. Los valores predeterminados son: Ninguno para el almacenamiento estándar. ReadOnly para Premium Storage. "None"
"ReadOnly"
"ReadWrite"
diskEncryptionSet Especifica el identificador de recurso del conjunto de cifrado de disco administrado por el cliente para el disco de imagen administrada. DiskEncryptionSetParameters
diskSizeGB Especifica el tamaño de los discos de datos vacíos en gigabytes. Este elemento se puede usar para sobrescribir el nombre del disco en una imagen de máquina virtual. Este valor no puede ser mayor que 1023 GB. int
lun 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. int (obligatorio)
managedDisk ManagedDisk. SubResource
instantánea Instantánea. SubResource
storageAccountType Especifica el tipo de cuenta de almacenamiento para el disco administrado. NOTA: UltraSSD_LRS solo se puede usar con discos de datos, no se puede usar con el disco del sistema operativo. "PremiumV2_LRS"
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"

DiskEncryptionSetParameters

Nombre Descripción Value
id Id. de recurso string

ImageOSDisk

Nombre Descripción Valor
blobUri Disco duro virtual. string
el almacenamiento en caché Especifica los requisitos de almacenamiento en caché. Los valores posibles son: None,ReadOnly,ReadWrite. Los valores predeterminados son: Ninguno para el almacenamiento estándar. ReadOnly para Premium Storage. "None"
"ReadOnly"
"ReadWrite"
diskEncryptionSet Especifica el identificador de recurso del conjunto de cifrado de disco administrado por el cliente para el disco de imagen administrada. DiskEncryptionSetParameters
diskSizeGB Especifica el tamaño de los discos de datos vacíos en gigabytes. Este elemento se puede usar para sobrescribir el nombre del disco en una imagen de máquina virtual. Este valor no puede ser mayor que 1023 GB. int
managedDisk ManagedDisk. SubResource
osState Estado del sistema operativo. En el caso de las imágenes administradas, use Generalizado. "Generalizado"
"Especializado" (obligatorio)
osType 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 personalizada. Los valores posibles son: Windows,Linux. "Linux"
"Windows" (obligatorio)
instantánea Instantánea. SubResource
storageAccountType Especifica el tipo de cuenta de almacenamiento para el disco administrado. NOTA: UltraSSD_LRS solo se puede usar con discos de datos, no se puede usar con el disco del sistema operativo. "PremiumV2_LRS"
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"