Share via

Raccolte di Microsoft.Compute/images/versioni 2023-07-03

  • Articolo

Definizione di risorsa Bicep

Il tipo di risorsa raccolte/immagini/versioni può essere distribuito con operazioni destinate:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.Compute/gallerys/images/version, aggiungere il codice Bicep seguente al modello.

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

Valori delle proprietà

galleries/images/versions

Nome Descrizione valore
name Nome della risorsa

Vedere come impostare nomi e tipi per le risorse figlio in Bicep.		 stringa (obbligatoria)

Limite di caratteri: intero a 32 bit

Caratteri validi:
Numeri e punti.
Ogni segmento viene convertito in un int32. Quindi ogni segmento ha un valore massimo di 2.147.483.647.
posizione Posizione risorsa stringa (obbligatoria)
tags Tag delle risorse Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
padre In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere Risorsa figlio esterna alla risorsa padre.		 Nome simbolico per la risorsa di tipo: immagini
properties Descrive le proprietà di una versione dell'immagine della raccolta. GalleryImageVersionProperties

GalleryImageVersionProperties

Nome Descrizione Valore
publishingProfile Profilo di pubblicazione di un'immagine della raccolta Versione. GalleryImageVersionPublishingProfile
safetyProfile Si tratta del profilo di sicurezza della versione dell'immagine della raccolta. GalleryImageVersionSafetyProfile
securityProfile Profilo di sicurezza di una versione dell'immagine della raccolta ImageVersionSecurityProfile
storageProfile Si tratta del profilo di archiviazione di una versione dell'immagine della raccolta. GalleryImageVersionStorageProfile (obbligatorio)

GalleryImageVersionPublishingProfile

Nome Descrizione Valore
endOfLifeDate Data di vita della versione dell'immagine della raccolta. Questa proprietà può essere usata per scopi di rimozione. Questa proprietà è aggiornabile. string
excludeFromLatest Se impostato su true, Macchine virtuali distribuito dalla versione più recente della definizione immagine non userà questa versione dell'immagine. bool
replicaCount Numero di repliche della versione dell'immagine da creare per area. Questa proprietà ha effetto per un'area quando regionalReplicaCount non è specificato. Questa proprietà è aggiornabile. INT
replicationMode Parametro facoltativo che specifica la modalità da usare per la replica. Questa proprietà non è aggiornabile. 'Full'
'Superficiale'
storageAccountType Specifica il tipo di account di archiviazione da usare per archiviare l'immagine. Questa proprietà non è aggiornabile. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'
targetExtendedLocations Località estese di destinazione in cui verrà replicata la versione dell'immagine. Questa proprietà è aggiornabile. GalleryTargetExtendedLocation[]
targetRegions Le aree di destinazione in cui verrà replicata la versione dell'immagine. Questa proprietà è aggiornabile. TargetRegion[]

GalleryTargetExtendedLocation

Nome Descrizione Valore
Crittografia facoltativo. Consente agli utenti di fornire chiavi gestite dal cliente per crittografare il sistema operativo e i dischi dati nell'artefatto della raccolta. EncryptionImages
extendedLocation Nome della posizione estesa. GalleryExtendedLocation
extendedLocationReplicaCount Numero di repliche della versione dell'immagine da creare per ogni posizione estesa. Questa proprietà è aggiornabile. INT
name Il nome dell'area. string
storageAccountType Specifica il tipo di account di archiviazione da usare per archiviare l'immagine. Questa proprietà non è aggiornabile. 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'
'Standard_ZRS'

EncryptionImages

Nome Descrizione Valore
dataDiskImages Elenco delle specifiche di crittografia per le immagini del disco dati. DataDiskImageEncryption[]
osDiskImage Contiene le impostazioni di crittografia per un'immagine del disco del sistema operativo. OSDiskImageEncryption

DataDiskImageEncryption

Nome Descrizione Valore
diskEncryptionSetId URI relativo contenente l'ID risorsa del set di crittografia del disco. string
lun Questa proprietà specifica il numero di unità logica del disco dati. Questo valore viene usato per identificare i dischi dati all'interno della macchina virtuale e pertanto deve essere univoco per ogni disco dati collegato alla macchina virtuale. int (obbligatorio)

OSDiskImageEncryption

Nome Descrizione Valore
diskEncryptionSetId URI relativo contenente l'ID risorsa del set di crittografia del disco. string
securityProfile Questa proprietà specifica il profilo di sicurezza di un'immagine del disco del sistema operativo. OSDiskImageSecurityProfile

OSDiskImageSecurityProfile

Nome Descrizione Valore
confidentialVMEncryptionType tipi di crittografia di macchine virtuali riservati 'EncryptedVMGuestStateOnlyWithPmk'
'EncryptedWithCmk'
'EncryptedWithPmk'
'NonPersistedTPM'
secureVMDiskEncryptionSetId ID del set di crittografia del disco della macchina virtuale sicura string

GalleryExtendedLocation

Nome Descrizione valore
name string
type È il tipo della posizione estesa. 'EdgeZone'
'Sconosciuto'

TargetRegion

Nome Descrizione Valore
Crittografia facoltativo. Consente agli utenti di fornire chiavi gestite dal cliente per crittografare il sistema operativo e i dischi dati nell'artefatto della raccolta. EncryptionImages
excludeFromLatest Contiene l'impostazione del flag per nascondere un'immagine quando gli utenti specificano version='latest' bool
name Il nome dell'area. stringa (obbligatorio)
regionalReplicaCount Numero di repliche della versione dell'immagine da creare per area. Questa proprietà è aggiornabile. INT
storageAccountType Specifica il tipo di account di archiviazione da usare per archiviare l'immagine. Questa proprietà non è aggiornabile. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

GalleryImageVersionSafetyProfile

Nome Descrizione Valore
allowDeletionOfReplicatedLocations Indica se è consentita o meno la rimozione di questa versione dell'immagine della raccolta dalle aree replicate. bool

ImageVersionSecurityProfile

Nome Descrizione Valore
uefiSettings Contiene le impostazioni UEFI per la versione dell'immagine. GalleryImageVersionUefiSettings

GalleryImageVersionUefiSettings

Nome Descrizione Valore
additionalSignatures Firme di chiave UEFI aggiuntive che verranno aggiunte all'immagine oltre ai modelli di firma UefiKeySignatures
signatureTemplateNames Nome dei modelli che contiene le firme di chiave UEFI predefinite che verranno aggiunte all'immagine. Matrice di stringhe contenente uno dei seguenti elementi:
'MicrosoftUefiCertificateAuthorityTemplate'
'MicrosoftWindowsTemplate'
'NoSignatureTemplate'

UefiKeySignatures

Nome Descrizione Valore
db Database delle chiavi UEFI per questa versione dell'immagine. UefiKey[]
Dbx Database delle chiavi UEFI revocate per questa versione dell'immagine. UefiKey[]
Kek Chiavi di crittografia delle chiavi di questa versione dell'immagine. UefiKey[]
pk Chiave della piattaforma di questa versione dell'immagine. UefiKey

UefiKey

Nome Descrizione Valore
tipo Tipo di firma della chiave. 'sha256'
'x509'
Valore Valore della firma della chiave. string[]

GalleryImageVersionStorageProfile

Nome Descrizione Valore
dataDiskImages Elenco di immagini del disco dati. GalleryDataDiskImage[]
osDiskImage Questa è l'immagine del disco del sistema operativo. GalleryOSDiskImage
source Origine della versione dell'artefatto della raccolta. GalleryArtifactVersionFullSource

GalleryDataDiskImage

Nome Descrizione Valore
hostCaching Memorizzazione nella cache dell'host del disco. I valori validi sono 'None', 'ReadOnly' e 'ReadWrite' 'Nessuno'
'ReadOnly'
'ReadWrite'
lun Questa proprietà specifica il numero di unità logica del disco dati. Questo valore viene usato per identificare i dischi dati all'interno della macchina virtuale e pertanto deve essere univoco per ogni disco dati collegato alla macchina virtuale. int (obbligatorio)
source Origine per l'immagine del disco. GalleryDiskImageSource

GalleryDiskImageSource

Nome Descrizione Valore
id ID dell'origine della versione dell'artefatto della raccolta. string
storageAccountId ID dell'account di archiviazione che contiene il BLOB vhd usato come origine per questa versione dell'artefatto. string
Uri URI dell'origine della versione dell'artefatto della raccolta. Attualmente usato per specificare l'origine vhd/BLOB. string

GalleryOSDiskImage

Nome Descrizione Valore
hostCaching Memorizzazione nella cache dell'host del disco. I valori validi sono 'None', 'ReadOnly' e 'ReadWrite' 'Nessuno'
'ReadOnly'
'ReadWrite'
source Origine per l'immagine del disco. GalleryDiskImageSource

GalleryArtifactVersionFullSource

Nome Descrizione Valore
communityGalleryImageId ID risorsa dell'immagine della raccolta community di origine. Obbligatorio solo quando si usa l'immagine della raccolta community come origine. string
id ID dell'origine della versione dell'artefatto della raccolta. string
virtualMachineId ID risorsa della macchina virtuale di origine. È necessario solo quando si acquisisce una macchina virtuale per l'origine della versione dell'immagine della raccolta. string

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello Descrizione
Creare una versione dell'immagine in una raccolta di calcolo di Azure

Distribuisci in Azure		 Questo modello consente di creare una semplice versione dell'immagine in una raccolta di calcolo di Azure. Assicurarsi di aver eseguito il modello di Azure Compute Gallery 101 e il modello di definizione dell'immagine 101 prima di distribuirlo.

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa raccolte/immagini/versioni può essere distribuito con operazioni destinate:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.Compute/galleries/images/versions, aggiungere il codice JSON seguente al modello.

{
  "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"
      }
    }
  }
}

Valori delle proprietà

galleries/images/versions

Nome Descrizione Valore
tipo Tipo di risorsa 'Microsoft.Compute/galleries/images/versions'
apiVersion Versione dell'API della risorsa '2023-07-03'
name Nome della risorsa

Informazioni su come impostare nomi e tipi per le risorse figlio nei modelli di Resource Manager JSON.		 stringa (obbligatorio)

Limite di caratteri: numero intero a 32 bit

Caratteri validi:
Numeri e punti.
Ogni segmento viene convertito in un int32. Ogni segmento ha quindi un valore massimo pari a 2.147.483.647.
posizione Posizione risorsa stringa (obbligatorio)
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedere Tag nei modelli
properties Descrive le proprietà di una versione dell'immagine della raccolta. GalleryImageVersionProperties

GalleryImageVersionProperties

Nome Descrizione Valore
publishingProfile Profilo di pubblicazione di un'immagine della raccolta Version. GalleryImageVersionPublishingProfile
safetyProfile Si tratta del profilo di sicurezza della versione dell'immagine della raccolta. GalleryImageVersionSafetyProfile
securityProfile Profilo di sicurezza di una versione dell'immagine della raccolta ImageVersionSecurityProfile
storageProfile Si tratta del profilo di archiviazione di una versione dell'immagine della raccolta. GalleryImageVersionStorageProfile (obbligatorio)

GalleryImageVersionPublishingProfile

Nome Descrizione Valore
endOfLifeDate Data di fine vita della versione dell'immagine della raccolta. Questa proprietà può essere utilizzata per scopi di rimozione delle autorizzazioni. Questa proprietà è aggiornabile. string
excludeFromLatest Se impostato su true, Macchine virtuali distribuito dalla versione più recente della definizione dell'immagine non userà questa versione dell'immagine. bool
replicaCount Numero di repliche della versione dell'immagine da creare per area. Questa proprietà avrà effetto per un'area quando regionalReplicaCount non è specificato. Questa proprietà è aggiornabile. INT
replicationMode Parametro facoltativo che specifica la modalità da usare per la replica. Questa proprietà non è aggiornabile. 'Full'
'Superficiale'
storageAccountType Specifica il tipo di account di archiviazione da usare per archiviare l'immagine. Questa proprietà non è aggiornabile. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'
targetExtendedLocations Località estese di destinazione in cui verrà replicata la versione dell'immagine. Questa proprietà è aggiornabile. GalleryTargetExtendedLocation[]
targetRegions Le aree di destinazione in cui verrà replicata la versione dell'immagine. Questa proprietà è aggiornabile. TargetRegion[]

GalleryTargetExtendedLocation

Nome Descrizione Valore
Crittografia facoltativo. Consente agli utenti di fornire chiavi gestite dal cliente per crittografare il sistema operativo e i dischi dati nell'artefatto della raccolta. EncryptionImages
extendedLocation Nome della posizione estesa. GalleryExtendedLocation
extendedLocationReplicaCount Numero di repliche della versione immagine da creare per percorso esteso. Questa proprietà è aggiornabile. INT
name Il nome dell'area. string
storageAccountType Specifica il tipo di account di archiviazione da usare per archiviare l'immagine. Questa proprietà non è aggiornabile. 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'
'Standard_ZRS'

EncryptionImages

Nome Descrizione Valore
dataDiskImages Elenco delle specifiche di crittografia per le immagini del disco dati. DataDiskImageEncryption[]
osDiskImage Contiene le impostazioni di crittografia per un'immagine del disco del sistema operativo. OSDiskImageEncryption

DataDiskImageEncryption

Nome Descrizione Valore
diskEncryptionSetId URI relativo contenente l'ID risorsa del set di crittografia del disco. string
lun Questa proprietà specifica il numero di unità logica del disco dati. Questo valore viene usato per identificare i dischi dati all'interno della macchina virtuale e pertanto deve essere univoco per ogni disco dati collegato alla macchina virtuale. int (obbligatorio)

OSDiskImageEncryption

Nome Descrizione Valore
diskEncryptionSetId URI relativo contenente l'ID risorsa del set di crittografia del disco. string
securityProfile Questa proprietà specifica il profilo di sicurezza di un'immagine del disco del sistema operativo. OSDiskImageSecurityProfile

OSDiskImageSecurityProfile

Nome Descrizione Valore
confidentialVMEncryptionType tipi di crittografia delle macchine virtuali riservate 'EncryptedVMGuestStateOnlyWithPmk'
'EncryptedWithCmk'
'EncryptedWithPmk'
'NonPersistedTPM'
secureVMDiskEncryptionSetId proteggere l'ID del set di set di crittografia del disco della macchina virtuale string

GalleryExtendedLocation

Nome Descrizione valore
name string
type È il tipo della posizione estesa. 'EdgeZone'
'Sconosciuto'

TargetRegion

Nome Descrizione Valore
Crittografia facoltativo. Consente agli utenti di fornire chiavi gestite dal cliente per crittografare il sistema operativo e i dischi dati nell'artefatto della raccolta. EncryptionImages
excludeFromLatest Contiene l'impostazione del flag per nascondere un'immagine quando gli utenti specificano version='latest' bool
name Il nome dell'area. stringa (obbligatorio)
regionalReplicaCount Numero di repliche della versione dell'immagine da creare per area. Questa proprietà è aggiornabile. INT
storageAccountType Specifica il tipo di account di archiviazione da usare per archiviare l'immagine. Questa proprietà non è aggiornabile. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

GalleryImageVersionSafetyProfile

Nome Descrizione Valore
allowDeletionOfReplicatedLocations Indica se è consentita o meno la rimozione di questa versione dell'immagine della raccolta dalle aree replicate. bool

ImageVersionSecurityProfile

Nome Descrizione Valore
uefiSettings Contiene le impostazioni UEFI per la versione dell'immagine. GalleryImageVersionUefiSettings

GalleryImageVersionUefiSettings

Nome Descrizione Valore
additionalSignatures Firme di chiave UEFI aggiuntive che verranno aggiunte all'immagine oltre ai modelli di firma UefiKeySignatures
signatureTemplateNames Nome dei modelli che contiene le firme di chiave UEFI predefinite che verranno aggiunte all'immagine. Matrice di stringhe contenente uno dei seguenti elementi:
'MicrosoftUefiCertificateAuthorityTemplate'
'MicrosoftWindowsTemplate'
'NoSignatureTemplate'

UefiKeySignatures

Nome Descrizione Valore
db Database delle chiavi UEFI per questa versione dell'immagine. UefiKey[]
Dbx Database delle chiavi UEFI revocate per questa versione dell'immagine. UefiKey[]
Kek Chiavi di crittografia delle chiavi di questa versione dell'immagine. UefiKey[]
pk Chiave della piattaforma di questa versione dell'immagine. UefiKey

UefiKey

Nome Descrizione Valore
tipo Tipo di firma della chiave. 'sha256'
'x509'
Valore Valore della firma della chiave. string[]

GalleryImageVersionStorageProfile

Nome Descrizione Valore
dataDiskImages Elenco di immagini del disco dati. GalleryDataDiskImage[]
osDiskImage Questa è l'immagine del disco del sistema operativo. GalleryOSDiskImage
source Origine della versione dell'artefatto della raccolta. GalleryArtifactVersionFullSource

GalleryDataDiskImage

Nome Descrizione Valore
hostCaching Memorizzazione nella cache dell'host del disco. I valori validi sono 'None', 'ReadOnly' e 'ReadWrite' 'Nessuno'
'ReadOnly'
'ReadWrite'
lun Questa proprietà specifica il numero di unità logica del disco dati. Questo valore viene usato per identificare i dischi dati all'interno della macchina virtuale e pertanto deve essere univoco per ogni disco dati collegato alla macchina virtuale. int (obbligatorio)
source Origine dell'immagine del disco. GalleryDiskImageSource

GalleryDiskImageSource

Nome Descrizione Valore
id ID dell'origine dell'artefatto della raccolta. string
storageAccountId ID account di archiviazione che contiene il BLOB vhd usato come origine per questa versione dell'artefatto. string
Uri URI dell'origine dell'artefatto della raccolta. Attualmente usato per specificare l'origine vhd/BLOB. string

GalleryOSDiskImage

Nome Descrizione Valore
hostCaching Memorizzazione nella cache host del disco. I valori validi sono 'Nessuno', 'ReadOnly' e 'ReadWrite' 'Nessuno'
'ReadOnly'
'ReadWrite'
source Origine dell'immagine del disco. GalleryDiskImageSource

GalleryArtifactVersionFullSource

Nome Descrizione Valore
communityGalleryImageId ID risorsa dell'immagine della raccolta community di origine. Obbligatorio solo quando si usa l'immagine di Community Gallery come origine. string
id ID dell'origine dell'artefatto della raccolta. string
virtualMachineId ID risorsa della macchina virtuale di origine. È necessario solo quando si acquisisce una macchina virtuale per l'origine di questa versione dell'immagine della raccolta. string

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello Descrizione
Creare una versione di immagine in una raccolta di calcolo di Azure

Distribuisci in Azure		 Questo modello consente di creare una semplice versione immagine in una raccolta di calcolo di Azure. Assicurarsi di aver eseguito il modello di Azure Compute Gallery 101 e il modello di definizione dell'immagine 101 prima di distribuirlo.

Definizione della risorsa Terraform (provider AzAPI)

Il tipo di risorsa raccolte/immagini/versioni può essere distribuito con operazioni destinate:

  • Gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.Compute/gallerys/images/version, aggiungere il codice Terraform seguente al modello.

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"
        }
      }
    }
  })
}

Valori delle proprietà

galleries/images/versions

Nome Descrizione Valore
tipo Tipo di risorsa "Microsoft.Compute/gallerys/images/versions@2023-07-03"
name Nome della risorsa stringa (obbligatoria)

Limite di caratteri: intero a 32 bit

Caratteri validi:
Numeri e punti.
Ogni segmento viene convertito in un int32. Quindi ogni segmento ha un valore massimo di 2.147.483.647.
posizione Posizione risorsa stringa (obbligatoria)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: immagini
tags Tag delle risorse Dizionario dei nomi e dei valori dei tag.
properties Descrive le proprietà di una versione dell'immagine della raccolta. GalleryImageVersionProperties

GalleryImageVersionProperties

Nome Descrizione Valore
publishingProfile Profilo di pubblicazione di un'immagine della raccolta Versione. GalleryImageVersionPublishingProfile
safetyProfile Si tratta del profilo di sicurezza della versione dell'immagine della raccolta. GalleryImageVersionSafetyProfile
securityProfile Profilo di sicurezza di una versione dell'immagine della raccolta ImageVersionSecurityProfile
storageProfile Si tratta del profilo di archiviazione di una versione dell'immagine della raccolta. GalleryImageVersionStorageProfile (obbligatorio)

GalleryImageVersionPublishingProfile

Nome Descrizione Valore
endOfLifeDate Data di fine vita della versione dell'immagine della raccolta. Questa proprietà può essere utilizzata per scopi di rimozione delle autorizzazioni. Questa proprietà è aggiornabile. string
excludeFromLatest Se impostato su true, Macchine virtuali distribuito dalla versione più recente della definizione dell'immagine non userà questa versione dell'immagine. bool
replicaCount Numero di repliche della versione dell'immagine da creare per area. Questa proprietà avrà effetto per un'area quando regionalReplicaCount non è specificato. Questa proprietà è aggiornabile. INT
replicationMode Parametro facoltativo che specifica la modalità da usare per la replica. Questa proprietà non è aggiornabile. "Full"
"Superficiale"
storageAccountType Specifica il tipo di account di archiviazione da usare per archiviare l'immagine. Questa proprietà non è aggiornabile. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"
targetExtendedLocations Percorsi estesi di destinazione in cui verrà replicata la versione dell'immagine. Questa proprietà è aggiornabile. GalleryTargetExtendedLocation[]
targetRegions Le aree di destinazione in cui verrà replicata la versione dell'immagine. Questa proprietà è aggiornabile. TargetRegion[]

GalleryTargetExtendedLocation

Nome Descrizione Valore
Crittografia facoltativo. Consente agli utenti di fornire chiavi gestite dal cliente per crittografare il sistema operativo e i dischi dati nell'artefatto della raccolta. EncryptionImages
extendedLocation Nome della posizione estesa. GalleryExtendedLocation
extendedLocationReplicaCount Numero di repliche della versione dell'immagine da creare per ogni posizione estesa. Questa proprietà è aggiornabile. INT
name Il nome dell'area. string
storageAccountType Specifica il tipo di account di archiviazione da usare per archiviare l'immagine. Questa proprietà non è aggiornabile. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"
"Standard_ZRS"

EncryptionImages

Nome Descrizione Valore
dataDiskImages Elenco delle specifiche di crittografia per le immagini del disco dati. DataDiskImageEncryption[]
osDiskImage Contiene le impostazioni di crittografia per un'immagine del disco del sistema operativo. OSDiskImageEncryption

DataDiskImageEncryption

Nome Descrizione Valore
diskEncryptionSetId URI relativo contenente l'ID risorsa del set di crittografia del disco. string
lun Questa proprietà specifica il numero di unità logica del disco dati. Questo valore viene usato per identificare i dischi dati all'interno della macchina virtuale e pertanto deve essere univoco per ogni disco dati collegato alla macchina virtuale. int (obbligatorio)

OSDiskImageEncryption

Nome Descrizione Valore
diskEncryptionSetId URI relativo contenente l'ID risorsa del set di crittografia del disco. string
securityProfile Questa proprietà specifica il profilo di sicurezza di un'immagine del disco del sistema operativo. OSDiskImageSecurityProfile

OSDiskImageSecurityProfile

Nome Descrizione Valore
confidentialVMEncryptionType tipi di crittografia delle macchine virtuali riservate "EncryptedVMGuestStateOnlyWithPmk"
"EncryptedWithCmk"
"EncryptedWithPmk"
"NonPersistedTPM"
secureVMDiskEncryptionSetId proteggere l'ID del set di set di crittografia del disco della macchina virtuale string

GalleryExtendedLocation

Nome Descrizione valore
name string
type È il tipo della posizione estesa. "EdgeZone"
"Sconosciuto"

TargetRegion

Nome Descrizione Valore
Crittografia facoltativo. Consente agli utenti di fornire chiavi gestite dal cliente per crittografare il sistema operativo e i dischi dati nell'artefatto della raccolta. EncryptionImages
excludeFromLatest Contiene l'impostazione del flag per nascondere un'immagine quando gli utenti specificano version='latest' bool
name Il nome dell'area. stringa (obbligatoria)
regionalReplicaCount Numero di repliche della versione dell'immagine da creare per area. Questa proprietà è aggiornabile. INT
storageAccountType Specifica il tipo di account di archiviazione da usare per archiviare l'immagine. Questa proprietà non è aggiornabile. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

GalleryImageVersionSafetyProfile

Nome Descrizione Valore
allowDeletionOfReplicatedLocations Indica se è consentita o meno la rimozione di questa versione dell'immagine della raccolta da aree replicate. bool

ImageVersionSecurityProfile

Nome Descrizione Valore
uefiSettings Contiene le impostazioni UEFI per la versione dell'immagine. GalleryImageVersionUefiSettings

GalleryImageVersionUefiSettings

Nome Descrizione Valore
aggiuntiveSignatures Firme chiave UEFI aggiuntive che verranno aggiunte all'immagine oltre ai modelli di firma UefiKeySignatures
signatureTemplateNames Nome dei modelli che contiene le firme chiave UEFI predefinite che verranno aggiunte all'immagine. Matrice di stringhe contenente uno qualsiasi di:
"MicrosoftUefiCertificateAuthorityTemplate"
"MicrosoftWindowsTemplate"
"NoSignatureTemplate"

UefiKeySignatures

Nome Descrizione Valore
db Database delle chiavi UEFI per questa versione dell'immagine. UefiKey[]
Dbx Database delle chiavi UEFI revocate per questa versione dell'immagine. UefiKey[]
Kek Chiavi di crittografia delle chiavi di questa versione dell'immagine. UefiKey[]
pk Chiave della piattaforma di questa versione dell'immagine. UefiKey

UefiKey

Nome Descrizione Valore
tipo Tipo di firma chiave. "sha256"
"x509"
Valore Valore della firma della chiave. string[]

GalleryImageVersionStorageProfile

Nome Descrizione Valore
dataDiskImages Elenco delle immagini del disco dati. GalleryDataDiskImage[]
osDiskImage Si tratta dell'immagine del disco del sistema operativo. GalleryOSDiskImage
source Origine della versione dell'artefatto della raccolta. GalleryArtifactVersionFullSource

GalleryDataDiskImage

Nome Descrizione Valore
hostCaching Memorizzazione nella cache host del disco. I valori validi sono 'Nessuno', 'ReadOnly' e 'ReadWrite' "None"
"ReadOnly"
"ReadWrite"
lun Questa proprietà specifica il numero di unità logica del disco dati. Questo valore viene usato per identificare i dischi dati all'interno della macchina virtuale e pertanto deve essere univoco per ogni disco dati collegato alla macchina virtuale. int (obbligatorio)
source Origine dell'immagine del disco. GalleryDiskImageSource

GalleryDiskImageSource

Nome Descrizione Valore
id ID dell'origine dell'artefatto della raccolta. string
storageAccountId ID account di archiviazione che contiene il BLOB vhd usato come origine per questa versione dell'artefatto. string
Uri URI dell'origine dell'artefatto della raccolta. Attualmente usato per specificare l'origine vhd/BLOB. string

GalleryOSDiskImage

Nome Descrizione Valore
hostCaching Memorizzazione nella cache host del disco. I valori validi sono 'Nessuno', 'ReadOnly' e 'ReadWrite' "None"
"ReadOnly"
"ReadWrite"
source Origine dell'immagine del disco. GalleryDiskImageSource

GalleryArtifactVersionFullSource

Nome Descrizione Valore
communityGalleryImageId ID risorsa dell'immagine della raccolta community di origine. Obbligatorio solo quando si usa l'immagine di Community Gallery come origine. string
id ID dell'origine dell'artefatto della raccolta. string
virtualMachineId ID risorsa della macchina virtuale di origine. È necessario solo quando si acquisisce una macchina virtuale per l'origine di questa versione dell'immagine della raccolta. string