Galeries/images/versions Microsoft.Compute 2023-07-03
Définition de ressource Bicep
Le type de ressource galeries/images/versions peut être déployé avec des opérations qui ciblent :
- Groupes de ressources - Voir commandes de déploiement de groupes de ressources
Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.
Format des ressources
Pour créer une ressource Microsoft.Compute/galleries/images/versions, ajoutez le Bicep suivant à votre modèle.
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'
}
}
}
}
Valeurs de propriétés
galleries/images/versions
| Nom | Description | Valeur |
|---|---|---|
| name | Nom de la ressource Découvrez comment définir des noms et des types pour des ressources enfants dans Bicep. |
chaîne (obligatoire) Limite de caractères : entier 32 bits Caractères valides : Chiffres et points. (Chaque segment est converti en int32. Par conséquent, chaque segment a une valeur maximale de 2 147 483 647.) |
| location | Emplacement de la ressource | chaîne (obligatoire) |
| tags | Balises de ressource | Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles |
| parent | Dans Bicep, vous pouvez spécifier la ressource parente pour une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente. Pour plus d’informations, consultez Ressource enfant en dehors de la ressource parente. |
Nom symbolique de la ressource de type : images |
| properties | Décrit les propriétés d’une version d’image de galerie. | GalleryImageVersionProperties |
GalleryImageVersionProperties
| Nom | Description | Valeur |
|---|---|---|
| publishingProfile | Profil de publication d’une version d’image de galerie. | GalleryImageVersionPublishingProfile |
| safetyProfile | Il s’agit du profil de sécurité de la version de l’image de la galerie. | GalleryImageVersionSafetyProfile |
| securityProfile | Profil de sécurité d’une version d’image de galerie | ImageVersionSecurityProfile |
| storageProfile | Il s’agit du profil de stockage d’une version d’image de galerie. | GalleryImageVersionStorageProfile (obligatoire) |
GalleryImageVersionPublishingProfile
| Nom | Description | Valeur |
|---|---|---|
| endOfLifeDate | Date de fin de vie de la version de l’image de galerie. Cette propriété peut être utilisée à des fins de désaffectation. Cette propriété peut être mise à jour. | string |
| excludeFromLatest | Si la valeur est true, Machines Virtuelles déployée à partir de la dernière version de la définition d’image n’utilise pas cette version d’image. | bool |
| replicaCount | Nombre de réplicas de la version d’image à créer par région. Cette propriété prend effet pour une région lorsque regionalReplicaCount n’est pas spécifié. Cette propriété peut être mise à jour. | int |
| replicationMode | Paramètre facultatif qui spécifie le mode à utiliser pour la réplication. Cette propriété n’est pas modifiable. | 'Full' 'Superficiel' |
| storageAccountType | Spécifie le type de compte de stockage à utiliser pour stocker l’image. Cette propriété n’est pas modifiable. | 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
| targetExtendedLocations | Emplacements étendus cibles vers lesquels la version de l’image va être répliquée. Cette propriété peut être mise à jour. | GalleryTargetExtendedLocation[] |
| targetRegions | Régions cibles dans lesquelles la version de l’image va être répliquée. Cette propriété peut être mise à jour. | TargetRegion[] |
GalleryTargetExtendedLocation
| Nom | Description | Valeur |
|---|---|---|
| le chiffrement | facultatif. Permet aux utilisateurs de fournir des clés gérées par le client pour chiffrer le système d’exploitation et les disques de données dans l’artefact de la galerie. | EncryptionImages |
| extendedLocation | Nom de l’emplacement étendu. | GalleryExtendedLocation |
| extendedLocationReplicaCount | Nombre de réplicas de la version d’image à créer par emplacement étendu. Cette propriété peut être mise à jour. | int |
| name | Nom de la région. | string |
| storageAccountType | Spécifie le type de compte de stockage à utiliser pour stocker l’image. Cette propriété n’est pas modifiable. | 'Premium_LRS' 'StandardSSD_LRS' 'Standard_LRS' 'Standard_ZRS' |
EncryptionImages
| Nom | Description | Valeur |
|---|---|---|
| dataDiskImages | Liste des spécifications de chiffrement pour les images de disque de données. | DataDiskImageEncryption[] |
| osDiskImage | Contient les paramètres de chiffrement d’une image de disque de système d’exploitation. | OSDiskImageEncryption |
DataDiskImageEncryption
| Nom | Description | Valeur |
|---|---|---|
| diskEncryptionSetId | URI relatif contenant l’ID de ressource du jeu de chiffrement de disque. | string |
| lun | Cette propriété spécifie le numéro d’unité logique du disque de données. Cette valeur est utilisée pour identifier les disques de données au sein de la machine virtuelle et doit donc être unique pour chaque disque de données attaché à la machine virtuelle. | int (obligatoire) |
OSDiskImageEncryption
| Nom | Description | Valeur |
|---|---|---|
| diskEncryptionSetId | URI relatif contenant l’ID de ressource du jeu de chiffrement de disque. | string |
| securityProfile | Cette propriété spécifie le profil de sécurité d’une image de disque de système d’exploitation. | OSDiskImageSecurityProfile |
OSDiskImageSecurityProfile
| Nom | Description | Valeur |
|---|---|---|
| confidentialVMEncryptionType | types de chiffrement de machine virtuelle confidentielle | 'EncryptedVMGuestStateOnlyWithPmk' 'EncryptedWithCmk' 'EncryptedWithPmk' 'NonPersistedTPM' |
| secureVMDiskEncryptionSetId | ID de jeu de chiffrement de disque sécurisé de machine virtuelle | string |
GalleryExtendedLocation
| Nom | Description | Valeur |
|---|---|---|
| name | string | |
| type | Il s’agit du type de l’emplacement étendu. | 'EdgeZone' 'Unknown' |
TargetRegion
| Nom | Description | Valeur |
|---|---|---|
| le chiffrement | facultatif. Permet aux utilisateurs de fournir des clés gérées par le client pour chiffrer le système d’exploitation et les disques de données dans l’artefact de la galerie. | EncryptionImages |
| excludeFromLatest | Contient le paramètre d’indicateur pour masquer une image lorsque les utilisateurs spécifient version='latest' | bool |
| name | Nom de la région. | string (obligatoire) |
| regionalReplicaCount | Nombre de réplicas de la version d’image à créer par région. Cette propriété peut être mise à jour. | int |
| storageAccountType | Spécifie le type de compte de stockage à utiliser pour stocker l’image. Cette propriété n’est pas modifiable. | 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
GalleryImageVersionSafetyProfile
| Nom | Description | Valeur |
|---|---|---|
| allowDeletionOfReplicatedLocations | Indique si la suppression de cette version d’image de galerie des régions répliquées est autorisée. | bool |
ImageVersionSecurityProfile
| Nom | Description | Valeur |
|---|---|---|
| uefiSettings | Contient les paramètres UEFI pour la version de l’image. | GalleryImageVersionUefiSettings |
GalleryImageVersionUefiSettings
| Nom | Description | Valeur |
|---|---|---|
| additionalSignatures | Signatures de clés UEFI supplémentaires qui seront ajoutées à l’image en plus des modèles de signature | UefiKeySignatures |
| signatureTemplateNames | Nom du ou des modèles qui contiennent des signatures de clé UEFI par défaut qui seront ajoutées à l’image. | Tableau de chaînes contenant l’un des éléments suivants : 'MicrosoftUefiCertificateAuthorityTemplate' 'MicrosoftWindowsTemplate' 'NoSignatureTemplate' |
UefiKeySignatures
| Nom | Description | Valeur |
|---|---|---|
| db | Base de données de clés UEFI pour cette version d’image. | UefiKey[] |
| Dbx | Base de données de clés UEFI révoquées pour cette version d’image. | UefiKey[] |
| Kek | Clés de chiffrement de clé de cette version d’image. | UefiKey[] |
| pk | Clé de plateforme de cette version d’image. | UefiKey |
UefiKey
| Nom | Description | Valeur |
|---|---|---|
| type | Type de signature de clé. | 'sha256' 'x509' |
| value | Valeur de la signature de clé. | string[] |
GalleryImageVersionStorageProfile
| Nom | Description | Valeur |
|---|---|---|
| dataDiskImages | Liste d’images de disque de données. | GalleryDataDiskImage[] |
| osDiskImage | Il s’agit de l’image disque du système d’exploitation. | GalleryOSDiskImage |
| source | Source de la version de l’artefact de la galerie. | GalleryArtifactVersionFullSource |
GalleryDataDiskImage
| Nom | Description | Valeur |
|---|---|---|
| hostCaching | Mise en cache de l’hôte du disque. Les valeurs valides sont « None », « ReadOnly » et « ReadWrite » | 'None' 'ReadOnly' 'ReadWrite' |
| lun | Cette propriété spécifie le numéro d’unité logique du disque de données. Cette valeur est utilisée pour identifier les disques de données au sein de la machine virtuelle et doit donc être unique pour chaque disque de données attaché à la machine virtuelle. | int (obligatoire) |
| source | Source de l’image disque. | GalleryDiskImageSource |
GalleryDiskImageSource
| Nom | Description | Valeur |
|---|---|---|
| id | ID de la source de version de l’artefact de galerie. | string |
| storageAccountId | ID de compte de stockage qui contient l’objet blob vhd utilisé comme source pour cette version de l’artefact. | string |
| URI | URI de la source de version de l’artefact de la galerie. Actuellement utilisé pour spécifier la source vhd/blob. | string |
GalleryOSDiskImage
| Nom | Description | Valeur |
|---|---|---|
| hostCaching | Mise en cache de l’hôte du disque. Les valeurs valides sont « None », « ReadOnly » et « ReadWrite » | 'None' 'ReadOnly' 'ReadWrite' |
| source | Source de l’image disque. | GalleryDiskImageSource |
GalleryArtifactVersionFullSource
| Nom | Description | Valeur |
|---|---|---|
| communityGalleryImageId | ID de ressource de l’image de la galerie de la communauté source. Obligatoire uniquement lors de l’utilisation de Community Gallery Image en tant que source. | string |
| id | ID de la source de version de l’artefact de galerie. | string |
| virtualMachineId | ID de ressource de la machine virtuelle source. Requis uniquement lors de la capture d’une machine virtuelle pour sourcer cette version d’image de galerie. | string |
Modèles de démarrage rapide
Les modèles de démarrage rapide suivants déploient ce type de ressource.
| Modèle | Description |
|---|---|
Créer une version d’image dans azure Compute Gallery
|
Ce modèle vous permet de créer une version d’image simple dans une galerie de calcul Azure. Vérifiez que vous avez exécuté le modèle Azure Compute Gallery 101 et le modèle Image Definition 101 avant de le déployer. |
Définition de ressources de modèle ARM
Le type de ressource galeries/images/versions peut être déployé avec des opérations qui ciblent :
- Groupes de ressources - Voir commandes de déploiement de groupes de ressources
Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.
Format des ressources
Pour créer une ressource Microsoft.Compute/galleries/images/versions, ajoutez le JSON suivant à votre modèle.
{
"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"
}
}
}
}
Valeurs de propriétés
galleries/images/versions
| Nom | Description | Valeur |
|---|---|---|
| type | Type de ressource | « Microsoft.Compute/galleries/images/versions » |
| apiVersion | Version de l’API de ressource | '2023-07-03' |
| name | Nom de la ressource Découvrez comment définir des noms et des types pour des ressources enfants dans des modèles ARM JSON. |
chaîne (obligatoire) Limite de caractères : entier 32 bits Caractères valides : Chiffres et points. (Chaque segment est converti en int32. Par conséquent, chaque segment a une valeur maximale de 2 147 483 647.) |
| location | Emplacement de la ressource | chaîne (obligatoire) |
| tags | Balises de ressource | Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles |
| properties | Décrit les propriétés d’une version d’image de galerie. | GalleryImageVersionProperties |
GalleryImageVersionProperties
| Nom | Description | Valeur |
|---|---|---|
| publishingProfile | Profil de publication d’une version d’image de galerie. | GalleryImageVersionPublishingProfile |
| safetyProfile | Il s’agit du profil de sécurité de la version de l’image de la galerie. | GalleryImageVersionSafetyProfile |
| securityProfile | Profil de sécurité d’une version d’image de galerie | ImageVersionSecurityProfile |
| storageProfile | Il s’agit du profil de stockage d’une version d’image de galerie. | GalleryImageVersionStorageProfile (obligatoire) |
GalleryImageVersionPublishingProfile
| Nom | Description | Valeur |
|---|---|---|
| endOfLifeDate | Date de fin de vie de la version de l’image de galerie. Cette propriété peut être utilisée à des fins de désaffectation. Cette propriété peut être mise à jour. | string |
| excludeFromLatest | Si la valeur est true, Machines Virtuelles déployée à partir de la dernière version de la définition d’image n’utilise pas cette version d’image. | bool |
| replicaCount | Nombre de réplicas de la version d’image à créer par région. Cette propriété prend effet pour une région lorsque regionalReplicaCount n’est pas spécifié. Cette propriété peut être mise à jour. | int |
| replicationMode | Paramètre facultatif qui spécifie le mode à utiliser pour la réplication. Cette propriété n’est pas modifiable. | 'Full' 'Superficiel' |
| storageAccountType | Spécifie le type de compte de stockage à utiliser pour stocker l’image. Cette propriété n’est pas modifiable. | 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
| targetExtendedLocations | Emplacements étendus cibles vers lesquels la version de l’image va être répliquée. Cette propriété peut être mise à jour. | GalleryTargetExtendedLocation[] |
| targetRegions | Régions cibles dans lesquelles la version de l’image va être répliquée. Cette propriété peut être mise à jour. | TargetRegion[] |
GalleryTargetExtendedLocation
| Nom | Description | Valeur |
|---|---|---|
| le chiffrement | facultatif. Permet aux utilisateurs de fournir des clés gérées par le client pour chiffrer le système d’exploitation et les disques de données dans l’artefact de la galerie. | EncryptionImages |
| extendedLocation | Nom de l’emplacement étendu. | GalleryExtendedLocation |
| extendedLocationReplicaCount | Nombre de réplicas de la version d’image à créer par emplacement étendu. Cette propriété peut être mise à jour. | int |
| name | Nom de la région. | string |
| storageAccountType | Spécifie le type de compte de stockage à utiliser pour stocker l’image. Cette propriété n’est pas modifiable. | 'Premium_LRS' 'StandardSSD_LRS' 'Standard_LRS' 'Standard_ZRS' |
EncryptionImages
| Nom | Description | Valeur |
|---|---|---|
| dataDiskImages | Liste des spécifications de chiffrement pour les images de disque de données. | DataDiskImageEncryption[] |
| osDiskImage | Contient les paramètres de chiffrement d’une image disque du système d’exploitation. | OSDiskImageEncryption |
DataDiskImageEncryption
| Nom | Description | Valeur |
|---|---|---|
| diskEncryptionSetId | URI relatif contenant l’ID de ressource du jeu de chiffrement de disque. | string |
| lun | Cette propriété spécifie le numéro d’unité logique du disque de données. Cette valeur est utilisée pour identifier les disques de données au sein de la machine virtuelle et doit donc être unique pour chaque disque de données attaché à la machine virtuelle. | int (obligatoire) |
OSDiskImageEncryption
| Nom | Description | Valeur |
|---|---|---|
| diskEncryptionSetId | URI relatif contenant l’ID de ressource du jeu de chiffrement de disque. | string |
| securityProfile | Cette propriété spécifie le profil de sécurité d’une image disque du système d’exploitation. | OSDiskImageSecurityProfile |
OSDiskImageSecurityProfile
| Nom | Description | Valeur |
|---|---|---|
| confidentialVMEncryptionType | types de chiffrement de machine virtuelle confidentielle | 'EncryptedVMGuestStateOnlyWithPmk' 'EncryptedWithCmk' 'EncryptedWithPmk' 'NonPersistedTPM' |
| secureVMDiskEncryptionSetId | ID de jeu de chiffrement de disque de machine virtuelle sécurisée | string |
GalleryExtendedLocation
| Nom | Description | Valeur |
|---|---|---|
| name | string | |
| type | Il s’agit du type de l’emplacement étendu. | 'EdgeZone' 'Inconnu' |
TargetRegion
| Nom | Description | Valeur |
|---|---|---|
| le chiffrement | facultatif. Permet aux utilisateurs de fournir des clés gérées par le client pour chiffrer le système d’exploitation et les disques de données dans l’artefact de la galerie. | EncryptionImages |
| excludeFromLatest | Contient le paramètre d’indicateur pour masquer une image lorsque les utilisateurs spécifient version='latest' | bool |
| name | Nom de la région. | chaîne (obligatoire) |
| regionalReplicaCount | Nombre de réplicas de la version d’image à créer par région. Cette propriété peut être mise à jour. | int |
| storageAccountType | Spécifie le type de compte de stockage à utiliser pour stocker l’image. Cette propriété n’est pas modifiable. | 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
GalleryImageVersionSafetyProfile
| Nom | Description | Valeur |
|---|---|---|
| allowDeletionOfReplicatedLocations | Indique si la suppression de cette version d’image de galerie des régions répliquées est autorisée. | bool |
ImageVersionSecurityProfile
| Nom | Description | Valeur |
|---|---|---|
| uefiSettings | Contient les paramètres UEFI pour la version de l’image. | GalleryImageVersionUefiSettings |
GalleryImageVersionUefiSettings
| Nom | Description | Valeur |
|---|---|---|
| additionalSignatures | Signatures de clés UEFI supplémentaires qui seront ajoutées à l’image en plus des modèles de signature | UefiKeySignatures |
| signatureTemplateNames | Nom du ou des modèles qui contiennent des signatures de clé UEFI par défaut qui seront ajoutées à l’image. | Tableau de chaînes contenant l’un des éléments suivants : 'MicrosoftUefiCertificateAuthorityTemplate' 'MicrosoftWindowsTemplate' 'NoSignatureTemplate' |
UefiKeySignatures
| Nom | Description | Valeur |
|---|---|---|
| db | Base de données de clés UEFI pour cette version d’image. | UefiKey[] |
| Dbx | Base de données de clés UEFI révoquées pour cette version d’image. | UefiKey[] |
| Kek | Clés de chiffrement de clé de cette version d’image. | UefiKey[] |
| pk | Clé de plateforme de cette version d’image. | UefiKey |
UefiKey
| Nom | Description | Valeur |
|---|---|---|
| type | Type de signature de clé. | 'sha256' 'x509' |
| value | Valeur de la signature de clé. | string[] |
GalleryImageVersionStorageProfile
| Nom | Description | Valeur |
|---|---|---|
| dataDiskImages | Liste d’images de disque de données. | GalleryDataDiskImage[] |
| osDiskImage | Il s’agit de l’image disque du système d’exploitation. | GalleryOSDiskImage |
| source | Source de la version de l’artefact de la galerie. | GalleryArtifactVersionFullSource |
GalleryDataDiskImage
| Nom | Description | Valeur |
|---|---|---|
| hostCaching | Mise en cache de l’hôte du disque. Les valeurs valides sont « None », « ReadOnly » et « ReadWrite » | 'None' 'ReadOnly' 'ReadWrite' |
| lun | Cette propriété spécifie le numéro d’unité logique du disque de données. Cette valeur est utilisée pour identifier les disques de données au sein de la machine virtuelle et doit donc être unique pour chaque disque de données attaché à la machine virtuelle. | int (obligatoire) |
| source | Source de l’image disque. | GalleryDiskImageSource |
GalleryDiskImageSource
| Nom | Description | Valeur |
|---|---|---|
| id | ID de la source de version de l’artefact de galerie. | string |
| storageAccountId | ID de compte de stockage qui contient l’objet blob vhd utilisé comme source pour cette version de l’artefact. | string |
| URI | URI de la source de version de l’artefact de la galerie. Actuellement utilisé pour spécifier la source vhd/blob. | string |
GalleryOSDiskImage
| Nom | Description | Valeur |
|---|---|---|
| hostCaching | Mise en cache de l’hôte du disque. Les valeurs valides sont « None », « ReadOnly » et « ReadWrite » | 'None' 'ReadOnly' 'ReadWrite' |
| source | Source de l’image disque. | GalleryDiskImageSource |
GalleryArtifactVersionFullSource
| Nom | Description | Valeur |
|---|---|---|
| communityGalleryImageId | ID de ressource de l’image de la galerie de la communauté source. Obligatoire uniquement lors de l’utilisation de Community Gallery Image en tant que source. | string |
| id | ID de la source de version de l’artefact de galerie. | string |
| virtualMachineId | ID de ressource de la machine virtuelle source. Requis uniquement lors de la capture d’une machine virtuelle pour sourcer cette version d’image de galerie. | string |
Modèles de démarrage rapide
Les modèles de démarrage rapide suivants déploient ce type de ressource.
| Modèle | Description |
|---|---|
|
Créer une version d’image dans azure Compute Gallery
|
Ce modèle vous permet de créer une version d’image simple dans une galerie de calcul Azure. Vérifiez que vous avez exécuté le modèle Azure Compute Gallery 101 et le modèle Image Definition 101 avant de le déployer. |
Définition de ressource Terraform (fournisseur AzAPI)
Le type de ressource galeries/images/versions peut être déployé avec des opérations qui ciblent :
- Groupes de ressources
Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.
Format des ressources
Pour créer une ressource Microsoft.Compute/galleries/images/versions, ajoutez le Terraform suivant à votre modèle.
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"
}
}
}
})
}
Valeurs de propriétés
galleries/images/versions
| Nom | Description | Valeur |
|---|---|---|
| type | Type de ressource | « Microsoft.Compute/galleries/images/versions@2023-07-03 » |
| name | Nom de la ressource | chaîne (obligatoire) Limite de caractères : entier 32 bits Caractères valides : Chiffres et points. (Chaque segment est converti en int32. Par conséquent, chaque segment a une valeur maximale de 2 147 483 647.) |
| location | Emplacement de la ressource | chaîne (obligatoire) |
| parent_id | ID de la ressource qui est le parent de cette ressource. | ID de ressource de type : images |
| tags | Balises de ressource | Dictionnaire de noms et de valeurs d’étiquettes. |
| properties | Décrit les propriétés d’une version d’image de galerie. | GalleryImageVersionProperties |
GalleryImageVersionProperties
| Nom | Description | Valeur |
|---|---|---|
| publishingProfile | Profil de publication d’une version d’image de galerie. | GalleryImageVersionPublishingProfile |
| safetyProfile | Il s’agit du profil de sécurité de la version de l’image de la galerie. | GalleryImageVersionSafetyProfile |
| securityProfile | Profil de sécurité d’une version d’image de galerie | ImageVersionSecurityProfile |
| storageProfile | Il s’agit du profil de stockage d’une version d’image de galerie. | GalleryImageVersionStorageProfile (obligatoire) |
GalleryImageVersionPublishingProfile
| Nom | Description | Valeur |
|---|---|---|
| endOfLifeDate | Date de fin de vie de la version de l’image de galerie. Cette propriété peut être utilisée à des fins de désaffectation. Cette propriété peut être mise à jour. | string |
| excludeFromLatest | Si la valeur est true, Machines Virtuelles déployée à partir de la dernière version de la définition d’image n’utilise pas cette version d’image. | bool |
| replicaCount | Nombre de réplicas de la version d’image à créer par région. Cette propriété prend effet pour une région lorsque regionalReplicaCount n’est pas spécifié. Cette propriété peut être mise à jour. | int |
| replicationMode | Paramètre facultatif qui spécifie le mode à utiliser pour la réplication. Cette propriété n’est pas modifiable. | « Complet » « Superficiel » |
| storageAccountType | Spécifie le type de compte de stockage à utiliser pour stocker l’image. Cette propriété n’est pas modifiable. | « Premium_LRS » « Standard_LRS » « Standard_ZRS » |
| targetExtendedLocations | Emplacements étendus cibles vers lesquels la version de l’image va être répliquée. Cette propriété peut être mise à jour. | GalleryTargetExtendedLocation[] |
| targetRegions | Régions cibles dans lesquelles la version de l’image va être répliquée. Cette propriété peut être mise à jour. | TargetRegion[] |
GalleryTargetExtendedLocation
| Nom | Description | Valeur |
|---|---|---|
| le chiffrement | facultatif. Permet aux utilisateurs de fournir des clés gérées par le client pour chiffrer le système d’exploitation et les disques de données dans l’artefact de la galerie. | EncryptionImages |
| extendedLocation | Nom de l’emplacement étendu. | GalleryExtendedLocation |
| extendedLocationReplicaCount | Nombre de réplicas de la version d’image à créer par emplacement étendu. Cette propriété peut être mise à jour. | int |
| name | Nom de la région. | string |
| storageAccountType | Spécifie le type de compte de stockage à utiliser pour stocker l’image. Cette propriété n’est pas modifiable. | « Premium_LRS » « StandardSSD_LRS » « Standard_LRS » « Standard_ZRS » |
EncryptionImages
| Nom | Description | Valeur |
|---|---|---|
| dataDiskImages | Liste des spécifications de chiffrement pour les images de disque de données. | DataDiskImageEncryption[] |
| osDiskImage | Contient les paramètres de chiffrement d’une image disque du système d’exploitation. | OSDiskImageEncryption |
DataDiskImageEncryption
| Nom | Description | Valeur |
|---|---|---|
| diskEncryptionSetId | URI relatif contenant l’ID de ressource du jeu de chiffrement de disque. | string |
| lun | Cette propriété spécifie le numéro d’unité logique du disque de données. Cette valeur est utilisée pour identifier les disques de données au sein de la machine virtuelle et doit donc être unique pour chaque disque de données attaché à la machine virtuelle. | int (obligatoire) |
OSDiskImageEncryption
| Nom | Description | Valeur |
|---|---|---|
| diskEncryptionSetId | URI relatif contenant l’ID de ressource du jeu de chiffrement de disque. | string |
| securityProfile | Cette propriété spécifie le profil de sécurité d’une image disque du système d’exploitation. | OSDiskImageSecurityProfile |
OSDiskImageSecurityProfile
| Nom | Description | Valeur |
|---|---|---|
| confidentialVMEncryptionType | types de chiffrement de machine virtuelle confidentielle | « EncryptedVMGuestStateOnlyWithPmk » « EncryptedWithCmk » « EncryptedWithPmk » « NonPersistedTPM » |
| secureVMDiskEncryptionSetId | ID de jeu de chiffrement de disque sécurisé de machine virtuelle | string |
GalleryExtendedLocation
| Nom | Description | Valeur |
|---|---|---|
| name | string | |
| type | Il s’agit du type de l’emplacement étendu. | « EdgeZone » « Inconnu » |
TargetRegion
| Nom | Description | Valeur |
|---|---|---|
| le chiffrement | facultatif. Permet aux utilisateurs de fournir des clés gérées par le client pour chiffrer le système d’exploitation et les disques de données dans l’artefact de la galerie. | EncryptionImages |
| excludeFromLatest | Contient le paramètre d’indicateur pour masquer une image lorsque les utilisateurs spécifient version='latest' | bool |
| name | Nom de la région. | string (obligatoire) |
| regionalReplicaCount | Nombre de réplicas de la version d’image à créer par région. Cette propriété peut être mise à jour. | int |
| storageAccountType | Spécifie le type de compte de stockage à utiliser pour stocker l’image. Cette propriété n’est pas modifiable. | « Premium_LRS » « Standard_LRS » « Standard_ZRS » |
GalleryImageVersionSafetyProfile
| Nom | Description | Valeur |
|---|---|---|
| allowDeletionOfReplicatedLocations | Indique si la suppression de cette version d’image de galerie des régions répliquées est autorisée. | bool |
ImageVersionSecurityProfile
| Nom | Description | Valeur |
|---|---|---|
| uefiSettings | Contient les paramètres UEFI pour la version de l’image. | GalleryImageVersionUefiSettings |
GalleryImageVersionUefiSettings
| Nom | Description | Valeur |
|---|---|---|
| additionalSignatures | Signatures de clés UEFI supplémentaires qui seront ajoutées à l’image en plus des modèles de signature | UefiKeySignatures |
| signatureTemplateNames | Nom du ou des modèles qui contiennent des signatures de clé UEFI par défaut qui seront ajoutées à l’image. | Tableau de chaînes contenant l’un des éléments suivants : « MicrosoftUefiCertificateAuthorityTemplate » « MicrosoftWindowsTemplate » « NoSignatureTemplate » |
UefiKeySignatures
| Nom | Description | Valeur |
|---|---|---|
| db | Base de données des clés UEFI pour cette version d’image. | UefiKey[] |
| Dbx | Base de données des clés UEFI révoquées pour cette version d’image. | UefiKey[] |
| Kek | Clés de chiffrement de clé de cette version d’image. | UefiKey[] |
| pk | Clé de plateforme de cette version d’image. | UefiKey |
UefiKey
| Nom | Description | Valeur |
|---|---|---|
| type | Type de signature de clé. | « sha256 » « x509 » |
| value | Valeur de la signature de clé. | string[] |
GalleryImageVersionStorageProfile
| Nom | Description | Valeur |
|---|---|---|
| dataDiskImages | Liste d’images de disque de données. | GalleryDataDiskImage[] |
| osDiskImage | Il s’agit de l’image disque du système d’exploitation. | GalleryOSDiskImage |
| source | Source de la version de l’artefact de galerie. | GalleryArtifactVersionFullSource |
GalleryDataDiskImage
| Nom | Description | Valeur |
|---|---|---|
| hostCaching | Mise en cache de l’hôte du disque. Les valeurs valides sont « None », « ReadOnly » et « ReadWrite » | "None" « ReadOnly » « ReadWrite » |
| lun | Cette propriété spécifie le numéro d’unité logique du disque de données. Cette valeur est utilisée pour identifier les disques de données au sein de la machine virtuelle et doit donc être unique pour chaque disque de données attaché à la machine virtuelle. | int (obligatoire) |
| source | Source de l’image disque. | GalleryDiskImageSource |
GalleryDiskImageSource
| Nom | Description | Valeur |
|---|---|---|
| id | ID de la source de version de l’artefact de galerie. | string |
| storageAccountId | ID de compte de stockage qui contient l’objet blob de disque dur virtuel utilisé comme source pour cette version d’artefact. | string |
| URI | URI de la source de version de l’artefact de galerie. Actuellement utilisé pour spécifier la source vhd/blob. | string |
GalleryOSDiskImage
| Nom | Description | Valeur |
|---|---|---|
| hostCaching | Mise en cache de l’hôte du disque. Les valeurs valides sont « None », « ReadOnly » et « ReadWrite » | "None" « ReadOnly » « ReadWrite » |
| source | Source de l’image disque. | GalleryDiskImageSource |
GalleryArtifactVersionFullSource
| Nom | Description | Valeur |
|---|---|---|
| communityGalleryImageId | ID de ressource de l’image de la galerie de la communauté source. Obligatoire uniquement lors de l’utilisation de l’image de la galerie de la communauté en tant que source. | string |
| id | ID de la source de version de l’artefact de galerie. | string |
| virtualMachineId | ID de ressource de la machine virtuelle source. Obligatoire uniquement lors de la capture d’une machine virtuelle pour sourcer cette version d’image de galerie. | string |