Galerías de Microsoft.Compute/images/versions

  • Artículo

Definición de recursos de Bicep

El tipo de recurso gallerys/images/versions 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/galleries/images/versions, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Compute/galleries/images/versions@2023-07-03' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    publishingProfile: {
      endOfLifeDate: 'string'
      excludeFromLatest: bool
      replicaCount: int
      replicationMode: 'string'
      storageAccountType: 'string'
      targetExtendedLocations: [
        {
          encryption: {
            dataDiskImages: [
              {
                diskEncryptionSetId: 'string'
                lun: int
              }
            ]
            osDiskImage: {
              diskEncryptionSetId: 'string'
              securityProfile: {
                confidentialVMEncryptionType: 'string'
                secureVMDiskEncryptionSetId: 'string'
              }
            }
          }
          extendedLocation: {
            name: 'string'
            type: 'string'
          }
          extendedLocationReplicaCount: int
          name: 'string'
          storageAccountType: 'string'
        }
      ]
      targetRegions: [
        {
          encryption: {
            dataDiskImages: [
              {
                diskEncryptionSetId: 'string'
                lun: int
              }
            ]
            osDiskImage: {
              diskEncryptionSetId: 'string'
              securityProfile: {
                confidentialVMEncryptionType: 'string'
                secureVMDiskEncryptionSetId: 'string'
              }
            }
          }
          excludeFromLatest: bool
          name: 'string'
          regionalReplicaCount: int
          storageAccountType: 'string'
        }
      ]
    }
    safetyProfile: {
      allowDeletionOfReplicatedLocations: bool
    }
    securityProfile: {
      uefiSettings: {
        additionalSignatures: {
          db: [
            {
              type: 'string'
              value: [
                'string'
              ]
            }
          ]
          dbx: [
            {
              type: 'string'
              value: [
                'string'
              ]
            }
          ]
          kek: [
            {
              type: 'string'
              value: [
                'string'
              ]
            }
          ]
          pk: {
            type: 'string'
            value: [
              'string'
            ]
          }
        }
        signatureTemplateNames: [
          'string'
        ]
      }
    }
    storageProfile: {
      dataDiskImages: [
        {
          hostCaching: 'string'
          lun: int
          source: {
            id: 'string'
            storageAccountId: 'string'
            uri: 'string'
          }
        }
      ]
      osDiskImage: {
        hostCaching: 'string'
        source: {
          id: 'string'
          storageAccountId: 'string'
          uri: 'string'
        }
      }
      source: {
        communityGalleryImageId: 'string'
        id: 'string'
        virtualMachineId: 'string'
      }
    }
  }
}

Valores de propiedad

galleries/images/versions

Nombre Descripción Value
name El nombre del recurso

Vea cómo establecer nombres y tipos para recursos secundarios en Bicep.		 string (obligatorio)

Límite de caracteres: entero de 32 bits

Caracteres válidos:
Números y puntos.
(Cada segmento se convierte en un valor int32. Por lo tanto, cada segmento tiene un valor máximo de 2.147.483.647.)
ubicación Ubicación de los recursos string (obligatorio)
etiquetas Etiquetas del recurso Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
primario En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para más información, consulte Recurso secundario fuera del recurso primario.		 Nombre simbólico del recurso de tipo: imágenes
properties Describe las propiedades de una versión de imagen de la galería. GalleryImageVersionProperties

GalleryImageVersionProperties

Nombre Descripción Valor
publishingProfile Perfil de publicación de una versión de imagen de la galería. GalleryImageVersionPublishingProfile
safetyProfile Este es el perfil de seguridad de la versión de la imagen de la galería. GalleryImageVersionSafetyProfile
securityProfile El perfil de seguridad de una versión de imagen de la galería ImageVersionSecurityProfile
storageProfile Este es el perfil de almacenamiento de una versión de imagen de la galería. GalleryImageVersionStorageProfile (obligatorio)

GalleryImageVersionPublishingProfile

Nombre Descripción Valor
endOfLifeDate Fecha de finalización del ciclo de vida de la versión de la imagen de la galería. Esta propiedad se puede usar con fines de retirada. Esta propiedad es actualizable. string
excludeFromLatest Si se establece en true, Virtual Machines implementado desde la versión más reciente de la definición de imagen no usará esta versión de imagen. bool
replicaCount Número de réplicas de la versión de imagen que se va a crear por región. Esta propiedad surtiría efecto para una región cuando no se especifica regionalReplicaCount. Esta propiedad es actualizable. int
replicationMode Parámetro opcional que especifica el modo que se va a usar para la replicación. Esta propiedad no es actualizable. 'Full'
'Superficial'
storageAccountType Especifica el tipo de cuenta de almacenamiento que se usará para almacenar la imagen. Esta propiedad no es actualizable. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'
targetExtendedLocations Ubicaciones extendidas de destino en las que se va a replicar la versión de la imagen. Esta propiedad es actualizable. GalleryTargetExtendedLocation[]
targetRegions Regiones de destino en las que se va a replicar la versión de la imagen. Esta propiedad es actualizable. TargetRegion[]

GalleryTargetExtendedLocation

Nombre Descripción Valor
El cifrado Opcional. Permite a los usuarios proporcionar claves administradas por el cliente para cifrar los discos de datos y del sistema operativo en el artefacto de la galería. EncryptionImages
extendedLocation Nombre de la ubicación extendida. GalleryExtendedLocation
extendedLocationReplicaCount Número de réplicas de la versión de imagen que se va a crear por ubicación extendida. Esta propiedad es actualizable. int
name El nombre de la región. string
storageAccountType Especifica el tipo de cuenta de almacenamiento que se va a usar para almacenar la imagen. Esta propiedad no es actualizable. 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'
'Standard_ZRS'

EncryptionImages

Nombre Descripción Valor
dataDiskImages Lista de especificaciones de cifrado para imágenes de disco de datos. DataDiskImageEncryption[]
osDiskImage Contiene la configuración de cifrado de una imagen de disco del sistema operativo. OSDiskImageEncryption

DataDiskImageEncryption

Nombre Descripción Valor
diskEncryptionSetId Un URI relativo que contiene el identificador de recurso del conjunto de cifrado de disco. string
lun Esta propiedad 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 la máquina virtual. int (obligatorio)

OSDiskImageEncryption

Nombre Descripción Valor
diskEncryptionSetId Un URI relativo que contiene el identificador de recurso del conjunto de cifrado de disco. string
securityProfile Esta propiedad especifica el perfil de seguridad de una imagen de disco del sistema operativo. OSDiskImageSecurityProfile

OSDiskImageSecurityProfile

Nombre Descripción Valor
confidentialVMEncryptionType tipos de cifrado de máquina virtual confidencial 'EncryptedVMGuestStateOnlyWithPmk'
'EncryptedWithCmk'
'EncryptedWithPmk'
'NonPersistedTPM'
secureVMDiskEncryptionSetId identificador del conjunto de cifrado de disco de máquina virtual seguro string

GalleryExtendedLocation

Nombre Descripción Value
name string
type Es el tipo de la ubicación extendida. 'EdgeZone'
'Desconocido'

TargetRegion

Nombre Descripción Valor
El cifrado Opcional. Permite a los usuarios proporcionar claves administradas por el cliente para cifrar los discos de datos y del sistema operativo en el artefacto de la galería. EncryptionImages
excludeFromLatest Contiene la configuración de marca para ocultar una imagen cuando los usuarios especifican version='latest' bool
name El nombre de la región. string (obligatorio)
regionalReplicaCount Número de réplicas de la versión de imagen que se va a crear por región. Esta propiedad es actualizable. int
storageAccountType Especifica el tipo de cuenta de almacenamiento que se va a usar para almacenar la imagen. Esta propiedad no es actualizable. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

GalleryImageVersionSafetyProfile

Nombre Descripción Valor
allowDeletionOfReplicatedLocations Indica si se permite o no quitar esta versión de imagen de la galería de regiones replicadas. bool

ImageVersionSecurityProfile

Nombre Descripción Valor
uefiSettings Contiene la configuración de UEFI para la versión de la imagen. GalleryImageVersionUefiSettings

GalleryImageVersionUefiSettings

Nombre Descripción Valor
additionalSignatures Firmas de clave UEFI adicionales que se agregarán a la imagen además de las plantillas de firma UefiKeySignatures
signatureTemplateNames Nombre de las plantillas que contiene las firmas de clave UEFI predeterminadas que se agregarán a la imagen. Matriz de cadenas que contiene cualquiera de:
'MicrosoftUefiCertificateAuthorityTemplate'
"MicrosoftWindowsTemplate"
'NoSignatureTemplate'

UefiKeySignatures

Nombre Descripción Valor
db La base de datos de claves UEFI para esta versión de imagen. UefiKey[]
Dbx La base de datos de claves UEFI revocadas para esta versión de imagen. UefiKey[]
Kek Claves de cifrado de claves de esta versión de imagen. UefiKey[]
pk Clave de plataforma de esta versión de imagen. UefiKey

UefiKey

Nombre Descripción Value
type Tipo de firma de clave. 'sha256'
'x509'
value Valor de la firma de clave. string[]

GalleryImageVersionStorageProfile

Nombre Descripción Valor
dataDiskImages Una lista de imágenes de disco de datos. GalleryDataDiskImage[]
osDiskImage Esta es la imagen del disco del sistema operativo. GalleryOSDiskImage
source Origen de la versión del artefacto de la galería. GalleryArtifactVersionFullSource

GalleryDataDiskImage

Nombre Descripción Valor
hostCaching El almacenamiento en caché del host del disco. Los valores válidos son "None", "ReadOnly" y "ReadWrite". 'Ninguno'
'ReadOnly'
"ReadWrite"
lun Esta propiedad 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 la máquina virtual. int (obligatorio)
source Origen de la imagen de disco. GalleryDiskImageSource

GalleryDiskImageSource

Nombre Descripción Value
id Identificador del origen de la versión del artefacto de la galería. string
storageAccountId Identificador de la cuenta de almacenamiento que contiene el blob vhd que se usa como origen para esta versión del artefacto. string
uri URI del origen de la versión del artefacto de la galería. Actualmente se usa para especificar el origen de vhd/blob. string

GalleryOSDiskImage

Nombre Descripción Valor
hostCaching Almacenamiento en caché del host del disco. Los valores válidos son "None", "ReadOnly" y "ReadWrite". 'Ninguno'
'ReadOnly'
"ReadWrite"
source Origen de la imagen de disco. GalleryDiskImageSource

GalleryArtifactVersionFullSource

Nombre Descripción Valor
communityGalleryImageId Identificador de recurso de la imagen de la Galería de comunidad de origen. Solo es necesario cuando se usa Community Gallery Image como origen. string
id Identificador del origen de la versión del artefacto de la galería. string
virtualMachineId Identificador de recurso de la máquina virtual de origen. Solo es necesario al capturar una máquina virtual para obtener esta versión de imagen de galería. string

Plantillas de inicio rápido

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

Plantilla Descripción
Creación de una versión de imagen en una instancia de Azure Compute Gallery

Implementación en Azure		 Esta plantilla le permite crear una versión de imagen sencilla en una galería de proceso de Azure. Asegúrese de que ha ejecutado la plantilla de Azure Compute Gallery 101 y la plantilla Image Definition 101 antes de implementarla.

Definición de recursos de plantilla de ARM

El tipo de recurso gallerys/images/versions 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/gallerys/images/versions, agregue el siguiente json a la plantilla.

{
  "type": "Microsoft.Compute/galleries/images/versions",
  "apiVersion": "2023-07-03",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "publishingProfile": {
      "endOfLifeDate": "string",
      "excludeFromLatest": "bool",
      "replicaCount": "int",
      "replicationMode": "string",
      "storageAccountType": "string",
      "targetExtendedLocations": [
        {
          "encryption": {
            "dataDiskImages": [
              {
                "diskEncryptionSetId": "string",
                "lun": "int"
              }
            ],
            "osDiskImage": {
              "diskEncryptionSetId": "string",
              "securityProfile": {
                "confidentialVMEncryptionType": "string",
                "secureVMDiskEncryptionSetId": "string"
              }
            }
          },
          "extendedLocation": {
            "name": "string",
            "type": "string"
          },
          "extendedLocationReplicaCount": "int",
          "name": "string",
          "storageAccountType": "string"
        }
      ],
      "targetRegions": [
        {
          "encryption": {
            "dataDiskImages": [
              {
                "diskEncryptionSetId": "string",
                "lun": "int"
              }
            ],
            "osDiskImage": {
              "diskEncryptionSetId": "string",
              "securityProfile": {
                "confidentialVMEncryptionType": "string",
                "secureVMDiskEncryptionSetId": "string"
              }
            }
          },
          "excludeFromLatest": "bool",
          "name": "string",
          "regionalReplicaCount": "int",
          "storageAccountType": "string"
        }
      ]
    },
    "safetyProfile": {
      "allowDeletionOfReplicatedLocations": "bool"
    },
    "securityProfile": {
      "uefiSettings": {
        "additionalSignatures": {
          "db": [
            {
              "type": "string",
              "value": [ "string" ]
            }
          ],
          "dbx": [
            {
              "type": "string",
              "value": [ "string" ]
            }
          ],
          "kek": [
            {
              "type": "string",
              "value": [ "string" ]
            }
          ],
          "pk": {
            "type": "string",
            "value": [ "string" ]
          }
        },
        "signatureTemplateNames": [ "string" ]
      }
    },
    "storageProfile": {
      "dataDiskImages": [
        {
          "hostCaching": "string",
          "lun": "int",
          "source": {
            "id": "string",
            "storageAccountId": "string",
            "uri": "string"
          }
        }
      ],
      "osDiskImage": {
        "hostCaching": "string",
        "source": {
          "id": "string",
          "storageAccountId": "string",
          "uri": "string"
        }
      },
      "source": {
        "communityGalleryImageId": "string",
        "id": "string",
        "virtualMachineId": "string"
      }
    }
  }
}

Valores de propiedad

galleries/images/versions

Nombre Descripción Value
type Tipo de recurso "Microsoft.Compute/gallerys/images/versions"
apiVersion La versión de la API de recursos '2023-07-03'
name El nombre del recurso

Vea cómo establecer nombres y tipos para recursos secundarios en plantillas de ARM JSON.		 string (obligatorio)

Límite de caracteres: entero de 32 bits

Caracteres válidos:
Números y puntos.
(Cada segmento se convierte en un valor int32. Por lo tanto, cada segmento tiene un valor máximo de 2.147.483.647.)
ubicación Ubicación de los recursos string (obligatorio)
etiquetas Etiquetas del recurso Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
properties Describe las propiedades de una versión de imagen de la galería. GalleryImageVersionProperties

GalleryImageVersionProperties

Nombre Descripción Valor
publishingProfile Perfil de publicación de una versión de imagen de galería. GalleryImageVersionPublishingProfile
safetyProfile Este es el perfil de seguridad de la versión de imagen de la galería. GalleryImageVersionSafetyProfile
securityProfile El perfil de seguridad de una versión de imagen de la galería ImageVersionSecurityProfile
storageProfile Este es el perfil de almacenamiento de una versión de imagen de la galería. GalleryImageVersionStorageProfile (obligatorio)

GalleryImageVersionPublishingProfile

Nombre Descripción Valor
endOfLifeDate Fecha de finalización del ciclo de vida de la versión de la imagen de la galería. Esta propiedad se puede usar con fines de retirada. Esta propiedad es actualizable. string
excludeFromLatest Si se establece en true, Virtual Machines implementado desde la versión más reciente de la definición de imagen no usará esta versión de imagen. bool
replicaCount Número de réplicas de la versión de imagen que se va a crear por región. Esta propiedad surtiría efecto para una región cuando no se especifica regionalReplicaCount. Esta propiedad es actualizable. int
replicationMode Parámetro opcional que especifica el modo que se va a usar para la replicación. Esta propiedad no es actualizable. 'Full'
'Superficial'
storageAccountType Especifica el tipo de cuenta de almacenamiento que se usará para almacenar la imagen. Esta propiedad no es actualizable. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'
targetExtendedLocations Ubicaciones extendidas de destino en las que se va a replicar la versión de la imagen. Esta propiedad es actualizable. GalleryTargetExtendedLocation[]
targetRegions Regiones de destino en las que se va a replicar la versión de la imagen. Esta propiedad es actualizable. TargetRegion[]

GalleryTargetExtendedLocation

Nombre Descripción Valor
El cifrado Opcional. Permite a los usuarios proporcionar claves administradas por el cliente para cifrar el sistema operativo y los discos de datos en el artefacto de la galería. EncryptionImages
extendedLocation Nombre de la ubicación extendida. GalleryExtendedLocation
extendedLocationReplicaCount Número de réplicas de la versión de imagen que se va a crear por ubicación extendida. Esta propiedad es actualizable. int
name El nombre de la región. string
storageAccountType Especifica el tipo de cuenta de almacenamiento que se usará para almacenar la imagen. Esta propiedad no es actualizable. 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'
'Standard_ZRS'

EncryptionImages

Nombre Descripción Valor
dataDiskImages Lista de especificaciones de cifrado para imágenes de disco de datos. DataDiskImageEncryption[]
osDiskImage Contiene la configuración de cifrado de una imagen de disco del sistema operativo. OSDiskImageEncryption

DataDiskImageEncryption

Nombre Descripción Valor
diskEncryptionSetId Un URI relativo que contiene el identificador de recurso del conjunto de cifrado de disco. string
lun Esta propiedad 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 la máquina virtual. int (obligatorio)

OSDiskImageEncryption

Nombre Descripción Valor
diskEncryptionSetId Un URI relativo que contiene el identificador de recurso del conjunto de cifrado de disco. string
securityProfile Esta propiedad especifica el perfil de seguridad de una imagen de disco del sistema operativo. OSDiskImageSecurityProfile

OSDiskImageSecurityProfile

Nombre Descripción Valor
confidentialVMEncryptionType tipos de cifrado de máquina virtual confidencial 'EncryptedVMGuestStateOnlyWithPmk'
'EncryptedWithCmk'
'EncryptedWithPmk'
'NonPersistedTPM'
secureVMDiskEncryptionSetId identificador de conjunto de cifrado de disco de máquina virtual seguro string

GalleryExtendedLocation

Nombre Descripción Value
name string
type Es el tipo de la ubicación extendida. 'EdgeZone'
'Desconocido'

TargetRegion

Nombre Descripción Valor
El cifrado Opcional. Permite a los usuarios proporcionar claves administradas por el cliente para cifrar los discos de datos y del sistema operativo en el artefacto de la galería. EncryptionImages
excludeFromLatest Contiene la configuración de marca para ocultar una imagen cuando los usuarios especifican version='latest' bool
name El nombre de la región. string (obligatorio)
regionalReplicaCount Número de réplicas de la versión de imagen que se va a crear por región. Esta propiedad es actualizable. int
storageAccountType Especifica el tipo de cuenta de almacenamiento que se va a usar para almacenar la imagen. Esta propiedad no es actualizable. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

GalleryImageVersionSafetyProfile

Nombre Descripción Valor
allowDeletionOfReplicatedLocations Indica si se permite o no quitar esta versión de imagen de la galería de regiones replicadas. bool

ImageVersionSecurityProfile

Nombre Descripción Valor
uefiSettings Contiene la configuración de UEFI para la versión de la imagen. GalleryImageVersionUefiSettings

GalleryImageVersionUefiSettings

Nombre Descripción Valor
additionalSignatures Firmas de clave UEFI adicionales que se agregarán a la imagen además de las plantillas de firma UefiKeySignatures
signatureTemplateNames Nombre de las plantillas que contienen firmas de clave UEFI predeterminadas que se agregarán a la imagen. Matriz de cadenas que contiene cualquiera de:
'MicrosoftUefiCertificateAuthorityTemplate'
"MicrosoftWindowsTemplate"
'NoSignatureTemplate'

UefiKeySignatures

Nombre Descripción Valor
db Base de datos de claves UEFI para esta versión de imagen. UefiKey[]
Dbx Base de datos de claves UEFI revocadas para esta versión de imagen. UefiKey[]
Kek Claves de cifrado de claves de esta versión de imagen. UefiKey[]
pk Clave de plataforma de esta versión de imagen. UefiKey

UefiKey

Nombre Descripción Value
type Tipo de firma de clave. 'sha256'
'x509'
value Valor de la firma de clave. string[]

GalleryImageVersionStorageProfile

Nombre Descripción Valor
dataDiskImages Lista de imágenes de disco de datos. GalleryDataDiskImage[]
osDiskImage Esta es la imagen del disco del sistema operativo. GalleryOSDiskImage
source Origen de la versión del artefacto de la galería. GalleryArtifactVersionFullSource

GalleryDataDiskImage

Nombre Descripción Valor
hostCaching Almacenamiento en caché del host del disco. Los valores válidos son "None", "ReadOnly" y "ReadWrite". 'Ninguno'
'ReadOnly'
"ReadWrite"
lun Esta propiedad 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 la máquina virtual. int (obligatorio)
source Origen de la imagen de disco. GalleryDiskImageSource

GalleryDiskImageSource

Nombre Descripción Value
id Identificador del origen de la versión del artefacto de la galería. string
storageAccountId Identificador de cuenta de almacenamiento que contiene el blob vhd que se usa como origen para esta versión de artefacto. string
uri El URI del origen de la versión del artefacto de la galería. Actualmente se usa para especificar el origen de vhd/blob. string

GalleryOSDiskImage

Nombre Descripción Valor
hostCaching Almacenamiento en caché del host del disco. Los valores válidos son "None", "ReadOnly" y "ReadWrite". 'Ninguno'
'ReadOnly'
"ReadWrite"
source Origen de la imagen de disco. GalleryDiskImageSource

GalleryArtifactVersionFullSource

Nombre Descripción Valor
communityGalleryImageId Identificador de recurso de la imagen de la Galería de comunidad de origen. Solo es necesario cuando se usa Community Gallery Image como origen. string
id Identificador del origen de la versión del artefacto de la galería. string
virtualMachineId Identificador de recurso de la máquina virtual de origen. Solo es necesario al capturar una máquina virtual para obtener esta versión de imagen de galería. string

Plantillas de inicio rápido

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

Plantilla Descripción
Creación de una versión de imagen en una instancia de Azure Compute Gallery

Implementación en Azure		 Esta plantilla le permite crear una versión de imagen sencilla en una galería de proceso de Azure. Asegúrese de que ha ejecutado la plantilla de Azure Compute Gallery 101 y la plantilla Image Definition 101 antes de implementarla.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso gallerys/images/versions 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/gallerys/images/versions, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/galleries/images/versions@2023-07-03"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      publishingProfile = {
        endOfLifeDate = "string"
        excludeFromLatest = bool
        replicaCount = int
        replicationMode = "string"
        storageAccountType = "string"
        targetExtendedLocations = [
          {
            encryption = {
              dataDiskImages = [
                {
                  diskEncryptionSetId = "string"
                  lun = int
                }
              ]
              osDiskImage = {
                diskEncryptionSetId = "string"
                securityProfile = {
                  confidentialVMEncryptionType = "string"
                  secureVMDiskEncryptionSetId = "string"
                }
              }
            }
            extendedLocation = {
              name = "string"
              type = "string"
            }
            extendedLocationReplicaCount = int
            name = "string"
            storageAccountType = "string"
          }
        ]
        targetRegions = [
          {
            encryption = {
              dataDiskImages = [
                {
                  diskEncryptionSetId = "string"
                  lun = int
                }
              ]
              osDiskImage = {
                diskEncryptionSetId = "string"
                securityProfile = {
                  confidentialVMEncryptionType = "string"
                  secureVMDiskEncryptionSetId = "string"
                }
              }
            }
            excludeFromLatest = bool
            name = "string"
            regionalReplicaCount = int
            storageAccountType = "string"
          }
        ]
      }
      safetyProfile = {
        allowDeletionOfReplicatedLocations = bool
      }
      securityProfile = {
        uefiSettings = {
          additionalSignatures = {
            db = [
              {
                type = "string"
                value = [
                  "string"
                ]
              }
            ]
            dbx = [
              {
                type = "string"
                value = [
                  "string"
                ]
              }
            ]
            kek = [
              {
                type = "string"
                value = [
                  "string"
                ]
              }
            ]
            pk = {
              type = "string"
              value = [
                "string"
              ]
            }
          }
          signatureTemplateNames = [
            "string"
          ]
        }
      }
      storageProfile = {
        dataDiskImages = [
          {
            hostCaching = "string"
            lun = int
            source = {
              id = "string"
              storageAccountId = "string"
              uri = "string"
            }
          }
        ]
        osDiskImage = {
          hostCaching = "string"
          source = {
            id = "string"
            storageAccountId = "string"
            uri = "string"
          }
        }
        source = {
          communityGalleryImageId = "string"
          id = "string"
          virtualMachineId = "string"
        }
      }
    }
  })
}

Valores de propiedad

galleries/images/versions

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

Límite de caracteres: entero de 32 bits

Caracteres válidos:
Números y puntos.
(Cada segmento se convierte en un valor int32. Por lo tanto, cada segmento tiene un valor máximo de 2.147.483.647.)
ubicación Ubicación de los recursos string (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: imágenes
etiquetas Etiquetas del recurso Diccionario de nombres y valores de etiqueta.
properties Describe las propiedades de una versión de imagen de la galería. GalleryImageVersionProperties

GalleryImageVersionProperties

Nombre Descripción Valor
publishingProfile Perfil de publicación de una versión de imagen de galería. GalleryImageVersionPublishingProfile
safetyProfile Este es el perfil de seguridad de la versión de imagen de la galería. GalleryImageVersionSafetyProfile
securityProfile El perfil de seguridad de una versión de imagen de la galería ImageVersionSecurityProfile
storageProfile Este es el perfil de almacenamiento de una versión de imagen de la galería. GalleryImageVersionStorageProfile (obligatorio)

GalleryImageVersionPublishingProfile

Nombre Descripción Valor
endOfLifeDate Fecha de finalización del ciclo de vida de la versión de la imagen de la galería. Esta propiedad se puede usar con fines de retirada. Esta propiedad es actualizable. string
excludeFromLatest Si se establece en true, Virtual Machines implementado desde la versión más reciente de la definición de imagen no usará esta versión de imagen. bool
replicaCount Número de réplicas de la versión de imagen que se va a crear por región. Esta propiedad surtiría efecto para una región cuando no se especifica regionalReplicaCount. Esta propiedad es actualizable. int
replicationMode Parámetro opcional que especifica el modo que se va a usar para la replicación. Esta propiedad no es actualizable. "Lleno"
"Superficial"
storageAccountType Especifica el tipo de cuenta de almacenamiento que se va a usar para almacenar la imagen. Esta propiedad no es actualizable. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"
targetExtendedLocations Ubicaciones extendidas de destino en las que se va a replicar la versión de la imagen. Esta propiedad es actualizable. GalleryTargetExtendedLocation[]
targetRegions Regiones de destino en las que se va a replicar la versión de la imagen. Esta propiedad es actualizable. TargetRegion[]

GalleryTargetExtendedLocation

Nombre Descripción Valor
El cifrado Opcional. Permite a los usuarios proporcionar claves administradas por el cliente para cifrar los discos de datos y del sistema operativo en el artefacto de la galería. EncryptionImages
extendedLocation Nombre de la ubicación extendida. GalleryExtendedLocation
extendedLocationReplicaCount Número de réplicas de la versión de imagen que se va a crear por ubicación extendida. Esta propiedad es actualizable. int
name El nombre de la región. string
storageAccountType Especifica el tipo de cuenta de almacenamiento que se va a usar para almacenar la imagen. Esta propiedad no es actualizable. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"
"Standard_ZRS"

EncryptionImages

Nombre Descripción Valor
dataDiskImages Lista de especificaciones de cifrado para imágenes de disco de datos. DataDiskImageEncryption[]
osDiskImage Contiene la configuración de cifrado de una imagen de disco del sistema operativo. OSDiskImageEncryption

DataDiskImageEncryption

Nombre Descripción Valor
diskEncryptionSetId Un URI relativo que contiene el identificador de recurso del conjunto de cifrado de disco. string
lun Esta propiedad 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 la máquina virtual. int (obligatorio)

OSDiskImageEncryption

Nombre Descripción Valor
diskEncryptionSetId Un URI relativo que contiene el identificador de recurso del conjunto de cifrado de disco. string
securityProfile Esta propiedad especifica el perfil de seguridad de una imagen de disco del sistema operativo. OSDiskImageSecurityProfile

OSDiskImageSecurityProfile

Nombre Descripción Valor
confidentialVMEncryptionType tipos de cifrado de máquina virtual confidencial "EncryptedVMGuestStateOnlyWithPmk"
"EncryptedWithCmk"
"EncryptedWithPmk"
"NonPersistedTPM"
secureVMDiskEncryptionSetId identificador del conjunto de cifrado de disco de máquina virtual seguro string

GalleryExtendedLocation

Nombre Descripción Value
name string
type Es el tipo de la ubicación extendida. "EdgeZone"
"Desconocido"

TargetRegion

Nombre Descripción Valor
El cifrado Opcional. Permite a los usuarios proporcionar claves administradas por el cliente para cifrar los discos de datos y del sistema operativo en el artefacto de la galería. EncryptionImages
excludeFromLatest Contiene la configuración de marca para ocultar una imagen cuando los usuarios especifican version='latest' bool
name El nombre de la región. string (obligatorio)
regionalReplicaCount Número de réplicas de la versión de imagen que se va a crear por región. Esta propiedad es actualizable. int
storageAccountType Especifica el tipo de cuenta de almacenamiento que se va a usar para almacenar la imagen. Esta propiedad no es actualizable. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

GalleryImageVersionSafetyProfile

Nombre Descripción Valor
allowDeletionOfReplicatedLocations Indica si se permite o no quitar esta versión de imagen de la galería de regiones replicadas. bool

ImageVersionSecurityProfile

Nombre Descripción Valor
uefiSettings Contiene la configuración de UEFI para la versión de la imagen. GalleryImageVersionUefiSettings

GalleryImageVersionUefiSettings

Nombre Descripción Valor
additionalSignatures Firmas de clave UEFI adicionales que se agregarán a la imagen además de las plantillas de firma UefiKeySignatures
signatureTemplateNames Nombre de las plantillas que contienen firmas de clave UEFI predeterminadas que se agregarán a la imagen. Matriz de cadenas que contiene cualquiera de:
"MicrosoftUefiCertificateAuthorityTemplate"
"MicrosoftWindowsTemplate"
"NoSignatureTemplate"

UefiKeySignatures

Nombre Descripción Valor
db Base de datos de claves UEFI para esta versión de imagen. UefiKey[]
Dbx Base de datos de claves UEFI revocadas para esta versión de imagen. UefiKey[]
Kek Claves de cifrado de claves de esta versión de imagen. UefiKey[]
pk Clave de plataforma de esta versión de imagen. UefiKey

UefiKey

Nombre Descripción Value
type Tipo de firma de clave. "sha256"
"x509"
value Valor de la firma de clave. string[]

GalleryImageVersionStorageProfile

Nombre Descripción Valor
dataDiskImages Lista de imágenes de disco de datos. GalleryDataDiskImage[]
osDiskImage Esta es la imagen del disco del sistema operativo. GalleryOSDiskImage
source Origen de la versión del artefacto de la galería. GalleryArtifactVersionFullSource

GalleryDataDiskImage

Nombre Descripción Valor
hostCaching Almacenamiento en caché del host del disco. Los valores válidos son "None", "ReadOnly" y "ReadWrite". "None"
"ReadOnly"
"ReadWrite"
lun Esta propiedad 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 la máquina virtual. int (obligatorio)
source Origen de la imagen de disco. GalleryDiskImageSource

GalleryDiskImageSource

Nombre Descripción Value
id Identificador del origen de la versión del artefacto de la galería. string
storageAccountId Identificador de cuenta de almacenamiento que contiene el blob vhd que se usa como origen para esta versión de artefacto. string
uri El URI del origen de la versión del artefacto de la galería. Actualmente se usa para especificar el origen de vhd/blob. string

GalleryOSDiskImage

Nombre Descripción Valor
hostCaching Almacenamiento en caché del host del disco. Los valores válidos son "None", "ReadOnly" y "ReadWrite". "None"
"ReadOnly"
"ReadWrite"
source Origen de la imagen de disco. GalleryDiskImageSource

GalleryArtifactVersionFullSource

Nombre Descripción Valor
communityGalleryImageId Identificador de recurso de la imagen de la Galería de comunidad de origen. Solo es necesario cuando se usa Community Gallery Image como origen. string
id Identificador del origen de la versión del artefacto de la galería. string
virtualMachineId Identificador de recurso de la máquina virtual de origen. Solo es necesario al capturar una máquina virtual para obtener esta versión de imagen de galería. string