Compartir a través de


Imágenes de Microsoft.Compute 2023-09-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 recurso

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

resource symbolicname 'Microsoft.Compute/images@2023-09-01' = {
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  location: 'string'
  name: 'string'
  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
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propiedad

DiskEncryptionSetParameters

Nombre Descripción Valor
identificación Identificador de recurso cuerda

ExtendedLocation

Nombre Descripción Valor
nombre Nombre de la ubicación extendida. cuerda
tipo Tipo de la ubicación extendida. 'EdgeZone'

ImageDataDisk

Nombre Descripción Valor
blobUri Disco duro virtual. cuerda
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 del 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"

ImageOSDisk

Nombre Descripción Valor
blobUri Disco duro virtual. cuerda
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 del 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 disco del sistema operativo. "PremiumV2_LRS"
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"

ImageProperties

Nombre Descripción Valor
hyperVGeneration Especifica el HyperVGenerationType de virtualMachine creado a partir de la imagen. En 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 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

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

Microsoft.Compute/images

Nombre Descripción Valor
extendedLocation Ubicación extendida de la imagen. ExtendedLocation
ubicación Ubicación del recurso string (obligatorio)
nombre El nombre del recurso string (obligatorio)
Propiedades Describe las propiedades de una imagen. ImageProperties
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

ResourceTags

Nombre Descripción Valor

SubResource

Nombre Descripción Valor
identificación Identificador de recurso cuerda

Definición de recursos de plantilla de ARM

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 recurso

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

{
  "type": "Microsoft.Compute/images",
  "apiVersion": "2023-09-01",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "location": "string",
  "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"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propiedad

DiskEncryptionSetParameters

Nombre Descripción Valor
identificación Identificador de recurso cuerda

ExtendedLocation

Nombre Descripción Valor
nombre Nombre de la ubicación extendida. cuerda
tipo Tipo de la ubicación extendida. 'EdgeZone'

ImageDataDisk

Nombre Descripción Valor
blobUri Disco duro virtual. cuerda
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 del 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"

ImageOSDisk

Nombre Descripción Valor
blobUri Disco duro virtual. cuerda
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 del 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 disco del sistema operativo. "PremiumV2_LRS"
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"

ImageProperties

Nombre Descripción Valor
hyperVGeneration Especifica el HyperVGenerationType de virtualMachine creado a partir de la imagen. En 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 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

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

Microsoft.Compute/images

Nombre Descripción Valor
apiVersion La versión de api '2023-09-01'
extendedLocation Ubicación extendida de la imagen. ExtendedLocation
ubicación Ubicación del recurso string (obligatorio)
nombre El nombre del recurso string (obligatorio)
Propiedades Describe las propiedades de una imagen. ImageProperties
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo El tipo de recurso "Microsoft.Compute/images"

ResourceTags

Nombre Descripción Valor

SubResource

Nombre Descripción Valor
identificación Identificador de recurso cuerda

Plantillas de inicio rápido

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

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

Implementación en Azure
Esta plantilla permite crear máquinas virtuales a partir de una imagen de usuario. Esta plantilla también implementa una red virtual, direcciones IP públicas y una interfaz de red.
Crear 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 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 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 de

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

Formato de recurso

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/images@2023-09-01"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    extendedLocation = {
      name = "string"
      type = "string"
    }
    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

DiskEncryptionSetParameters

Nombre Descripción Valor
identificación Identificador de recurso cuerda

ExtendedLocation

Nombre Descripción Valor
nombre Nombre de la ubicación extendida. cuerda
tipo Tipo de la ubicación extendida. 'EdgeZone'

ImageDataDisk

Nombre Descripción Valor
blobUri Disco duro virtual. cuerda
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 del 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"

ImageOSDisk

Nombre Descripción Valor
blobUri Disco duro virtual. cuerda
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 del 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 disco del sistema operativo. "PremiumV2_LRS"
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"

ImageProperties

Nombre Descripción Valor
hyperVGeneration Especifica el HyperVGenerationType de virtualMachine creado a partir de la imagen. En 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 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

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

Microsoft.Compute/images

Nombre Descripción Valor
extendedLocation Ubicación extendida de la imagen. ExtendedLocation
ubicación Ubicación del recurso string (obligatorio)
nombre El nombre del recurso string (obligatorio)
Propiedades Describe las propiedades de una imagen. ImageProperties
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
tipo El tipo de recurso "Microsoft.Compute/images@2023-09-01"

ResourceTags

Nombre Descripción Valor

SubResource

Nombre Descripción Valor
identificación Identificador de recurso cuerda