Galeries Microsoft.Compute/applications/versions 2024-03-03
Définition de ressource Bicep
Le type de ressource galeries/applications/versions peut être déployé avec des opérations qui ciblent :
- groupes de ressources - Consultez 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 de ressource
Pour créer une ressource Microsoft.Compute/galeries/applications/versions, ajoutez le bicep suivant à votre modèle.
resource symbolicname 'Microsoft.Compute/galleries/applications/versions@2024-03-03' = {
parent: resourceSymbolicName
location: 'string'
name: 'string'
properties: {
publishingProfile: {
advancedSettings: {
{customized property}: 'string'
}
customActions: [
{
description: 'string'
name: 'string'
parameters: [
{
defaultValue: 'string'
description: 'string'
name: 'string'
required: bool
type: 'string'
}
]
script: 'string'
}
]
enableHealthCheck: bool
endOfLifeDate: 'string'
excludeFromLatest: bool
manageActions: {
install: 'string'
remove: 'string'
update: 'string'
}
replicaCount: int
replicationMode: 'string'
settings: {
configFileName: 'string'
packageFileName: 'string'
scriptBehaviorAfterReboot: 'string'
}
source: {
defaultConfigurationLink: 'string'
mediaLink: '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: [
{
additionalReplicaSets: [
{
regionalReplicaCount: int
storageAccountType: 'string'
}
]
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
}
}
tags: {
{customized property}: 'string'
}
}
Valeurs de propriété
AdditionalReplicaSet
| Nom | Description | Valeur |
|---|---|---|
| regionalReplicaCount | Nombre de réplicas de lecteur direct de la version d’image à créer. Cette propriété est pouvant être mise à jour | Int |
| storageAccountType | Spécifie le type de compte de stockage à utiliser pour créer les réplicas de lecteur direct | 'PremiumV2_LRS' 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
DataDiskImageEncryption
| Nom | Description | Valeur |
|---|---|---|
| diskEncryptionSetId | URI relatif contenant l’ID de ressource du jeu de chiffrement de disque. | corde |
| 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) |
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 |
GalleryApplicationCustomAction
| Nom | Description | Valeur |
|---|---|---|
| description | Description pour aider les utilisateurs à comprendre ce que fait cette action personnalisée. | corde |
| nom | Nom de l’action personnalisée. Doit être unique dans la version de l’application de la galerie. | chaîne (obligatoire) |
| Paramètres | Paramètres utilisés par cette action personnalisée | GalleryApplicationCustomActionParameter[] |
| script | Script à exécuter lors de l’exécution de cette action personnalisée. | chaîne (obligatoire) |
GalleryApplicationCustomActionParameter
| Nom | Description | Valeur |
|---|---|---|
| defaultValue | Valeur par défaut du paramètre. S’applique uniquement aux types de chaînes | corde |
| description | Description permettant aux utilisateurs de comprendre ce que signifie ce paramètre | corde |
| nom | Nom de l’action personnalisée. Doit être unique dans la version de l’application de la galerie. | chaîne (obligatoire) |
| Obligatoire | Indique si ce paramètre doit être passé lors de l’exécution de l’action personnalisée. | Bool |
| type | Spécifie le type du paramètre d’action personnalisée. Les valeurs possibles sont : String, ConfigurationDataBlob ou LogOutputBlob | 'ConfigurationDataBlob' 'LogOutputBlob' 'String' |
GalleryApplicationVersionProperties
| Nom | Description | Valeur |
|---|---|---|
| publishingProfile | Profil de publication d’une version d’image de galerie. | GalleryApplicationVersionPublishingProfile (obligatoire) |
| safetyProfile | Profil de sécurité de la version de l’application de la galerie. | GalleryApplicationVersionSafetyProfile |
GalleryApplicationVersionPublishingProfile
| Nom | Description | Valeur |
|---|---|---|
| advancedSettings | Optionnel. Paramètres supplémentaires à passer à l’extension vm-application-manager. Pour une utilisation avancée uniquement. | GalleryApplicationVersionPublishingProfileAdvancedSettings |
| customActions | Liste des actions personnalisées qui peuvent être effectuées avec cette version d’application de la galerie. | GalleryApplicationCustomAction[] |
| enableHealthCheck | Optionnel. Indique si cette application signale ou non l’intégrité. | Bool |
| endOfLifeDate | Date de fin de vie de la version de l’image de la galerie. Cette propriété peut être utilisée à des fins de désaffectation. Cette propriété est pouvant être mise à jour. | corde |
| excludeFromLatest | Si la valeur est true, les machines virtuelles déployées à partir de la dernière version de la définition d’image n’utilisent pas cette version d’image. | Bool |
| manageActions | UserArtifactManage | |
| 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é est pouvant ê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' 'Peu profond' |
| Paramètres | Paramètres supplémentaires pour l’application de machine virtuelle qui contient le package cible et le nom du fichier de configuration lorsqu’il est déployé sur une machine virtuelle cible ou un groupe identique de machines virtuelles. | UserArtifactSettings |
| source | Image source à partir de laquelle la version de l’image va être créée. | userArtifactSource (obligatoire) |
| storageAccountType | Spécifie le type de compte de stockage à utiliser pour stocker l’image. Cette propriété n’est pas modifiable. | 'PremiumV2_LRS' 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
| targetExtendedLocations | Emplacements étendus cibles vers lesquels la version de l’image doit être répliquée. Cette propriété est pouvant être mise à jour. | GalleryTargetExtendedLocation[] |
| targetRegions | Régions cibles vers lesquelles la version de l’image sera répliquée. Cette propriété est pouvant être mise à jour. | TargetRegion[] |
GalleryApplicationVersionPublishingProfileAdvancedSettings
| Nom | Description | Valeur |
|---|
GalleryApplicationVersionSafetyProfile
| Nom | Description | Valeur |
|---|---|---|
| allowDeletionOfReplicatedLocations | Indique si la suppression ou non de cette version d’image de galerie des régions répliquées est autorisée. | Bool |
GalleryExtendedLocation
| Nom | Description | Valeur |
|---|---|---|
| nom | corde | |
| type | Il s’agit du type de l’emplacement étendu. | 'EdgeZone' 'Inconnu' |
GalleryTargetExtendedLocation
| Nom | Description | Valeur |
|---|---|---|
| chiffrement | Optionnel. 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é est pouvant être mise à jour. | Int |
| nom | Nom de la région. | corde |
| 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' |
Microsoft.Compute/galeries/applications/versions
| Nom | Description | Valeur |
|---|---|---|
| emplacement | Emplacement des ressources | chaîne (obligatoire) |
| nom | Nom de la ressource | chaîne (obligatoire) |
| parent | Dans Bicep, vous pouvez spécifier la ressource parente d’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 : galeries/applications |
| Propriétés | Décrit les propriétés d’une version d’image de galerie. | GalleryApplicationVersionProperties |
| étiquettes | Balises de ressource | Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles |
OSDiskImageEncryption
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é | corde |
ResourceTags
| Nom | Description | Valeur |
|---|
TargetRegion
| Nom | Description | Valeur |
|---|---|---|
| additionalReplicaSets | Liste des références SKU de stockage avec nombre de réplicas pour créer des réplicas de lecteur direct. | additionalReplicaSet[] |
| chiffrement | Optionnel. 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 |
| nom | 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é est pouvant ê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. | 'PremiumV2_LRS' 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
UserArtifactManage
| Nom | Description | Valeur |
|---|---|---|
| installer | Obligatoire. Chemin d’accès et arguments pour installer l’application de la galerie. Cela est limité à 4 096 caractères. | chaîne (obligatoire) |
| enlever | Obligatoire. Chemin d’accès et arguments pour supprimer l’application de la galerie. Cela est limité à 4 096 caractères. | chaîne (obligatoire) |
| mettre à jour | Optionnel. Chemin d’accès et arguments pour mettre à jour l’application de galerie. Si elle n’est pas présente, l’opération de mise à jour appelle la commande remove sur la version précédente et installe la commande sur la version actuelle de l’application de la galerie. Cela est limité à 4 096 caractères. | corde |
UserArtifactSettings
| Nom | Description | Valeur |
|---|---|---|
| configFileName | Optionnel. Nom à attribuer le fichier de configuration téléchargé sur la machine virtuelle. Cela est limité à 4 096 caractères. S’il n’est pas spécifié, le fichier de configuration est nommé le nom de l’application de la galerie ajouté avec « _config ». | corde |
| packageFileName | Optionnel. Nom à attribuer le fichier de package téléchargé sur la machine virtuelle. Cela est limité à 4 096 caractères. S’il n’est pas spécifié, le fichier de package est nommé identique au nom de l’application de la galerie. | corde |
| scriptBehaviorAfterReboot | Optionnel. Action à entreprendre en ce qui concerne l’installation/la mise à jour/suppression de l’application de galerie en cas de redémarrage. | 'None' 'Réexécuter' |
UserArtifactSource
| Nom | Description | Valeur |
|---|---|---|
| defaultConfigurationLink | Optionnel. DefaultConfigurationLink de l’artefact doit être un objet blob de pages de stockage lisible. | corde |
| mediaLink | Obligatoire. MediaLink de l’artefact doit être un objet blob de pages de stockage lisible. | chaîne (obligatoire) |
Définition de ressource de modèle ARM
Le type de ressource galeries/applications/versions peut être déployé avec des opérations qui ciblent :
- groupes de ressources - Consultez 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 de ressource
Pour créer une ressource Microsoft.Compute/galeries/applications/versions, ajoutez le code JSON suivant à votre modèle.
{
"type": "Microsoft.Compute/galleries/applications/versions",
"apiVersion": "2024-03-03",
"name": "string",
"location": "string",
"properties": {
"publishingProfile": {
"advancedSettings": {
"{customized property}": "string"
},
"customActions": [
{
"description": "string",
"name": "string",
"parameters": [
{
"defaultValue": "string",
"description": "string",
"name": "string",
"required": "bool",
"type": "string"
}
],
"script": "string"
}
],
"enableHealthCheck": "bool",
"endOfLifeDate": "string",
"excludeFromLatest": "bool",
"manageActions": {
"install": "string",
"remove": "string",
"update": "string"
},
"replicaCount": "int",
"replicationMode": "string",
"settings": {
"configFileName": "string",
"packageFileName": "string",
"scriptBehaviorAfterReboot": "string"
},
"source": {
"defaultConfigurationLink": "string",
"mediaLink": "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": [
{
"additionalReplicaSets": [
{
"regionalReplicaCount": "int",
"storageAccountType": "string"
}
],
"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"
}
},
"tags": {
"{customized property}": "string"
}
}
Valeurs de propriété
AdditionalReplicaSet
| Nom | Description | Valeur |
|---|---|---|
| regionalReplicaCount | Nombre de réplicas de lecteur direct de la version d’image à créer. Cette propriété est pouvant être mise à jour | Int |
| storageAccountType | Spécifie le type de compte de stockage à utiliser pour créer les réplicas de lecteur direct | 'PremiumV2_LRS' 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
DataDiskImageEncryption
| Nom | Description | Valeur |
|---|---|---|
| diskEncryptionSetId | URI relatif contenant l’ID de ressource du jeu de chiffrement de disque. | corde |
| 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) |
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 |
GalleryApplicationCustomAction
| Nom | Description | Valeur |
|---|---|---|
| description | Description pour aider les utilisateurs à comprendre ce que fait cette action personnalisée. | corde |
| nom | Nom de l’action personnalisée. Doit être unique dans la version de l’application de la galerie. | chaîne (obligatoire) |
| Paramètres | Paramètres utilisés par cette action personnalisée | GalleryApplicationCustomActionParameter[] |
| script | Script à exécuter lors de l’exécution de cette action personnalisée. | chaîne (obligatoire) |
GalleryApplicationCustomActionParameter
| Nom | Description | Valeur |
|---|---|---|
| defaultValue | Valeur par défaut du paramètre. S’applique uniquement aux types de chaînes | corde |
| description | Description permettant aux utilisateurs de comprendre ce que signifie ce paramètre | corde |
| nom | Nom de l’action personnalisée. Doit être unique dans la version de l’application de la galerie. | chaîne (obligatoire) |
| Obligatoire | Indique si ce paramètre doit être passé lors de l’exécution de l’action personnalisée. | Bool |
| type | Spécifie le type du paramètre d’action personnalisée. Les valeurs possibles sont : String, ConfigurationDataBlob ou LogOutputBlob | 'ConfigurationDataBlob' 'LogOutputBlob' 'String' |
GalleryApplicationVersionProperties
| Nom | Description | Valeur |
|---|---|---|
| publishingProfile | Profil de publication d’une version d’image de galerie. | GalleryApplicationVersionPublishingProfile (obligatoire) |
| safetyProfile | Profil de sécurité de la version de l’application de la galerie. | GalleryApplicationVersionSafetyProfile |
GalleryApplicationVersionPublishingProfile
| Nom | Description | Valeur |
|---|---|---|
| advancedSettings | Optionnel. Paramètres supplémentaires à passer à l’extension vm-application-manager. Pour une utilisation avancée uniquement. | GalleryApplicationVersionPublishingProfileAdvancedSettings |
| customActions | Liste des actions personnalisées qui peuvent être effectuées avec cette version d’application de la galerie. | GalleryApplicationCustomAction[] |
| enableHealthCheck | Optionnel. Indique si cette application signale ou non l’intégrité. | Bool |
| endOfLifeDate | Date de fin de vie de la version de l’image de la galerie. Cette propriété peut être utilisée à des fins de désaffectation. Cette propriété est pouvant être mise à jour. | corde |
| excludeFromLatest | Si la valeur est true, les machines virtuelles déployées à partir de la dernière version de la définition d’image n’utilisent pas cette version d’image. | Bool |
| manageActions | UserArtifactManage | |
| 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é est pouvant ê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' 'Peu profond' |
| Paramètres | Paramètres supplémentaires pour l’application de machine virtuelle qui contient le package cible et le nom du fichier de configuration lorsqu’il est déployé sur une machine virtuelle cible ou un groupe identique de machines virtuelles. | UserArtifactSettings |
| source | Image source à partir de laquelle la version de l’image va être créée. | userArtifactSource (obligatoire) |
| storageAccountType | Spécifie le type de compte de stockage à utiliser pour stocker l’image. Cette propriété n’est pas modifiable. | 'PremiumV2_LRS' 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
| targetExtendedLocations | Emplacements étendus cibles vers lesquels la version de l’image doit être répliquée. Cette propriété est pouvant être mise à jour. | GalleryTargetExtendedLocation[] |
| targetRegions | Régions cibles vers lesquelles la version de l’image sera répliquée. Cette propriété est pouvant être mise à jour. | TargetRegion[] |
GalleryApplicationVersionPublishingProfileAdvancedSettings
| Nom | Description | Valeur |
|---|
GalleryApplicationVersionSafetyProfile
| Nom | Description | Valeur |
|---|---|---|
| allowDeletionOfReplicatedLocations | Indique si la suppression ou non de cette version d’image de galerie des régions répliquées est autorisée. | Bool |
GalleryExtendedLocation
| Nom | Description | Valeur |
|---|---|---|
| nom | corde | |
| type | Il s’agit du type de l’emplacement étendu. | 'EdgeZone' 'Inconnu' |
GalleryTargetExtendedLocation
| Nom | Description | Valeur |
|---|---|---|
| chiffrement | Optionnel. 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é est pouvant être mise à jour. | Int |
| nom | Nom de la région. | corde |
| 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' |
Microsoft.Compute/galeries/applications/versions
| Nom | Description | Valeur |
|---|---|---|
| apiVersion | Version de l’API | '2024-03-03' |
| emplacement | Emplacement des ressources | chaîne (obligatoire) |
| nom | Nom de la ressource | chaîne (obligatoire) |
| Propriétés | Décrit les propriétés d’une version d’image de galerie. | GalleryApplicationVersionProperties |
| étiquettes | Balises de ressource | Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles |
| type | Type de ressource | 'Microsoft.Compute/galleries/applications/versions' |
OSDiskImageEncryption
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é | corde |
ResourceTags
| Nom | Description | Valeur |
|---|
TargetRegion
| Nom | Description | Valeur |
|---|---|---|
| additionalReplicaSets | Liste des références SKU de stockage avec nombre de réplicas pour créer des réplicas de lecteur direct. | additionalReplicaSet[] |
| chiffrement | Optionnel. 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 |
| nom | 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é est pouvant ê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. | 'PremiumV2_LRS' 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
UserArtifactManage
| Nom | Description | Valeur |
|---|---|---|
| installer | Obligatoire. Chemin d’accès et arguments pour installer l’application de la galerie. Cela est limité à 4 096 caractères. | chaîne (obligatoire) |
| enlever | Obligatoire. Chemin d’accès et arguments pour supprimer l’application de la galerie. Cela est limité à 4 096 caractères. | chaîne (obligatoire) |
| mettre à jour | Optionnel. Chemin d’accès et arguments pour mettre à jour l’application de galerie. Si elle n’est pas présente, l’opération de mise à jour appelle la commande remove sur la version précédente et installe la commande sur la version actuelle de l’application de la galerie. Cela est limité à 4 096 caractères. | corde |
UserArtifactSettings
| Nom | Description | Valeur |
|---|---|---|
| configFileName | Optionnel. Nom à attribuer le fichier de configuration téléchargé sur la machine virtuelle. Cela est limité à 4 096 caractères. S’il n’est pas spécifié, le fichier de configuration est nommé le nom de l’application de la galerie ajouté avec « _config ». | corde |
| packageFileName | Optionnel. Nom à attribuer le fichier de package téléchargé sur la machine virtuelle. Cela est limité à 4 096 caractères. S’il n’est pas spécifié, le fichier de package est nommé identique au nom de l’application de la galerie. | corde |
| scriptBehaviorAfterReboot | Optionnel. Action à entreprendre en ce qui concerne l’installation/la mise à jour/suppression de l’application de galerie en cas de redémarrage. | 'None' 'Réexécuter' |
UserArtifactSource
| Nom | Description | Valeur |
|---|---|---|
| defaultConfigurationLink | Optionnel. DefaultConfigurationLink de l’artefact doit être un objet blob de pages de stockage lisible. | corde |
| mediaLink | Obligatoire. MediaLink de l’artefact doit être un objet blob de pages de stockage lisible. | chaîne (obligatoire) |
Définition de ressource Terraform (fournisseur AzAPI)
Le type de ressource galeries/applications/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 de ressource
Pour créer une ressource Microsoft.Compute/galeries/applications/versions, ajoutez terraform suivant à votre modèle.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/galleries/applications/versions@2024-03-03"
name = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
publishingProfile = {
advancedSettings = {
{customized property} = "string"
}
customActions = [
{
description = "string"
name = "string"
parameters = [
{
defaultValue = "string"
description = "string"
name = "string"
required = bool
type = "string"
}
]
script = "string"
}
]
enableHealthCheck = bool
endOfLifeDate = "string"
excludeFromLatest = bool
manageActions = {
install = "string"
remove = "string"
update = "string"
}
replicaCount = int
replicationMode = "string"
settings = {
configFileName = "string"
packageFileName = "string"
scriptBehaviorAfterReboot = "string"
}
source = {
defaultConfigurationLink = "string"
mediaLink = "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 = [
{
additionalReplicaSets = [
{
regionalReplicaCount = int
storageAccountType = "string"
}
]
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
}
}
})
}
Valeurs de propriété
AdditionalReplicaSet
| Nom | Description | Valeur |
|---|---|---|
| regionalReplicaCount | Nombre de réplicas de lecteur direct de la version d’image à créer. Cette propriété est pouvant être mise à jour | Int |
| storageAccountType | Spécifie le type de compte de stockage à utiliser pour créer les réplicas de lecteur direct | 'PremiumV2_LRS' 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
DataDiskImageEncryption
| Nom | Description | Valeur |
|---|---|---|
| diskEncryptionSetId | URI relatif contenant l’ID de ressource du jeu de chiffrement de disque. | corde |
| 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) |
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 |
GalleryApplicationCustomAction
| Nom | Description | Valeur |
|---|---|---|
| description | Description pour aider les utilisateurs à comprendre ce que fait cette action personnalisée. | corde |
| nom | Nom de l’action personnalisée. Doit être unique dans la version de l’application de la galerie. | chaîne (obligatoire) |
| Paramètres | Paramètres utilisés par cette action personnalisée | GalleryApplicationCustomActionParameter[] |
| script | Script à exécuter lors de l’exécution de cette action personnalisée. | chaîne (obligatoire) |
GalleryApplicationCustomActionParameter
| Nom | Description | Valeur |
|---|---|---|
| defaultValue | Valeur par défaut du paramètre. S’applique uniquement aux types de chaînes | corde |
| description | Description permettant aux utilisateurs de comprendre ce que signifie ce paramètre | corde |
| nom | Nom de l’action personnalisée. Doit être unique dans la version de l’application de la galerie. | chaîne (obligatoire) |
| Obligatoire | Indique si ce paramètre doit être passé lors de l’exécution de l’action personnalisée. | Bool |
| type | Spécifie le type du paramètre d’action personnalisée. Les valeurs possibles sont : String, ConfigurationDataBlob ou LogOutputBlob | 'ConfigurationDataBlob' 'LogOutputBlob' 'String' |
GalleryApplicationVersionProperties
| Nom | Description | Valeur |
|---|---|---|
| publishingProfile | Profil de publication d’une version d’image de galerie. | GalleryApplicationVersionPublishingProfile (obligatoire) |
| safetyProfile | Profil de sécurité de la version de l’application de la galerie. | GalleryApplicationVersionSafetyProfile |
GalleryApplicationVersionPublishingProfile
| Nom | Description | Valeur |
|---|---|---|
| advancedSettings | Optionnel. Paramètres supplémentaires à passer à l’extension vm-application-manager. Pour une utilisation avancée uniquement. | GalleryApplicationVersionPublishingProfileAdvancedSettings |
| customActions | Liste des actions personnalisées qui peuvent être effectuées avec cette version d’application de la galerie. | GalleryApplicationCustomAction[] |
| enableHealthCheck | Optionnel. Indique si cette application signale ou non l’intégrité. | Bool |
| endOfLifeDate | Date de fin de vie de la version de l’image de la galerie. Cette propriété peut être utilisée à des fins de désaffectation. Cette propriété est pouvant être mise à jour. | corde |
| excludeFromLatest | Si la valeur est true, les machines virtuelles déployées à partir de la dernière version de la définition d’image n’utilisent pas cette version d’image. | Bool |
| manageActions | UserArtifactManage | |
| 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é est pouvant ê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' 'Peu profond' |
| Paramètres | Paramètres supplémentaires pour l’application de machine virtuelle qui contient le package cible et le nom du fichier de configuration lorsqu’il est déployé sur une machine virtuelle cible ou un groupe identique de machines virtuelles. | UserArtifactSettings |
| source | Image source à partir de laquelle la version de l’image va être créée. | userArtifactSource (obligatoire) |
| storageAccountType | Spécifie le type de compte de stockage à utiliser pour stocker l’image. Cette propriété n’est pas modifiable. | 'PremiumV2_LRS' 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
| targetExtendedLocations | Emplacements étendus cibles vers lesquels la version de l’image doit être répliquée. Cette propriété est pouvant être mise à jour. | GalleryTargetExtendedLocation[] |
| targetRegions | Régions cibles vers lesquelles la version de l’image sera répliquée. Cette propriété est pouvant être mise à jour. | TargetRegion[] |
GalleryApplicationVersionPublishingProfileAdvancedSettings
| Nom | Description | Valeur |
|---|
GalleryApplicationVersionSafetyProfile
| Nom | Description | Valeur |
|---|---|---|
| allowDeletionOfReplicatedLocations | Indique si la suppression ou non de cette version d’image de galerie des régions répliquées est autorisée. | Bool |
GalleryExtendedLocation
| Nom | Description | Valeur |
|---|---|---|
| nom | corde | |
| type | Il s’agit du type de l’emplacement étendu. | 'EdgeZone' 'Inconnu' |
GalleryTargetExtendedLocation
| Nom | Description | Valeur |
|---|---|---|
| chiffrement | Optionnel. 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é est pouvant être mise à jour. | Int |
| nom | Nom de la région. | corde |
| 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' |
Microsoft.Compute/galeries/applications/versions
| Nom | Description | Valeur |
|---|---|---|
| emplacement | Emplacement des ressources | chaîne (obligatoire) |
| nom | Nom de la ressource | chaîne (obligatoire) |
| parent_id | ID de la ressource qui est le parent de cette ressource. | ID de ressource de type : galeries/applications |
| Propriétés | Décrit les propriétés d’une version d’image de galerie. | GalleryApplicationVersionProperties |
| étiquettes | Balises de ressource | Dictionnaire de noms et de valeurs d’étiquettes. |
| type | Type de ressource | « Microsoft.Compute/galeries/applications/versions@2024-03-03 » |
OSDiskImageEncryption
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é | corde |
ResourceTags
| Nom | Description | Valeur |
|---|
TargetRegion
| Nom | Description | Valeur |
|---|---|---|
| additionalReplicaSets | Liste des références SKU de stockage avec nombre de réplicas pour créer des réplicas de lecteur direct. | additionalReplicaSet[] |
| chiffrement | Optionnel. 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 |
| nom | 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é est pouvant ê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. | 'PremiumV2_LRS' 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
UserArtifactManage
| Nom | Description | Valeur |
|---|---|---|
| installer | Obligatoire. Chemin d’accès et arguments pour installer l’application de la galerie. Cela est limité à 4 096 caractères. | chaîne (obligatoire) |
| enlever | Obligatoire. Chemin d’accès et arguments pour supprimer l’application de la galerie. Cela est limité à 4 096 caractères. | chaîne (obligatoire) |
| mettre à jour | Optionnel. Chemin d’accès et arguments pour mettre à jour l’application de galerie. Si elle n’est pas présente, l’opération de mise à jour appelle la commande remove sur la version précédente et installe la commande sur la version actuelle de l’application de la galerie. Cela est limité à 4 096 caractères. | corde |
UserArtifactSettings
| Nom | Description | Valeur |
|---|---|---|
| configFileName | Optionnel. Nom à attribuer le fichier de configuration téléchargé sur la machine virtuelle. Cela est limité à 4 096 caractères. S’il n’est pas spécifié, le fichier de configuration est nommé le nom de l’application de la galerie ajouté avec « _config ». | corde |
| packageFileName | Optionnel. Nom à attribuer le fichier de package téléchargé sur la machine virtuelle. Cela est limité à 4 096 caractères. S’il n’est pas spécifié, le fichier de package est nommé identique au nom de l’application de la galerie. | corde |
| scriptBehaviorAfterReboot | Optionnel. Action à entreprendre en ce qui concerne l’installation/la mise à jour/suppression de l’application de galerie en cas de redémarrage. | 'None' 'Réexécuter' |
UserArtifactSource
| Nom | Description | Valeur |
|---|---|---|
| defaultConfigurationLink | Optionnel. DefaultConfigurationLink de l’artefact doit être un objet blob de pages de stockage lisible. | corde |
| mediaLink | Obligatoire. MediaLink de l’artefact doit être un objet blob de pages de stockage lisible. | chaîne (obligatoire) |