Images Microsoft.Compute

Article
12/21/2024

Définition de ressource Bicep

Le type de ressource d’images 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/images, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Compute/images@2024-07-01' = {
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    hyperVGeneration: 'string'
    sourceVirtualMachine: {
      id: 'string'
    }
    storageProfile: {
      dataDisks: [
        {
          blobUri: 'string'
          caching: 'string'
          diskEncryptionSet: {
            id: 'string'
          }
          diskSizeGB: int
          lun: int
          managedDisk: {
            id: 'string'
          }
          snapshot: {
            id: 'string'
          }
          storageAccountType: 'string'
        }
      ]
      osDisk: {
        blobUri: 'string'
        caching: 'string'
        diskEncryptionSet: {
          id: 'string'
        }
        diskSizeGB: int
        managedDisk: {
          id: 'string'
        }
        osState: 'string'
        osType: 'string'
        snapshot: {
          id: 'string'
        }
        storageAccountType: 'string'
      }
      zoneResilient: bool
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Valeurs de propriété

DiskEncryptionSetParameters

Nom	Description	Valeur
id	ID de ressource	corde

ExtendedLocation

Nom	Description	Valeur
nom	Nom de l’emplacement étendu.	corde
type	Type de l’emplacement étendu.	'EdgeZone'

ImageDataDisk

Nom	Description	Valeur
blobUri	Disque dur virtuel.	corde
Cache	Spécifie les exigences de mise en cache. Les valeurs possibles sont : None,ReadOnly,ReadWrite. Les valeurs par défaut sont les suivantes : None pour le stockage Standard. ReadOnly pour le stockage Premium.	'None' 'ReadOnly' 'ReadWrite'
diskEncryptionSet	Spécifie l’ID de ressource du jeu de chiffrement de disque managé du client pour le disque d’image managée.	DiskEncryptionSetParameters
diskSizeGB	Spécifie la taille des disques de données vides en gigaoctets. Cet élément peut être utilisé pour remplacer le nom du disque dans une image de machine virtuelle. Cette valeur ne peut pas être supérieure à 1023 Go.	Int
lun	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é à une machine virtuelle.	int (obligatoire)
managedDisk	ManagedDisk.	SubResource
instantané	Capture instantanée.	SubResource
storageAccountType	Spécifie le type de compte de stockage pour le disque managé. REMARQUE : UltraSSD_LRS ne peut être utilisé qu’avec des disques de données, il ne peut pas être utilisé avec le disque du système d’exploitation.	'PremiumV2_LRS' 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' 'UltraSSD_LRS'

ImageOSDisk

Nom	Description	Valeur
blobUri	Disque dur virtuel.	corde
Cache	Spécifie les exigences de mise en cache. Les valeurs possibles sont : None,ReadOnly,ReadWrite. Les valeurs par défaut sont les suivantes : None pour le stockage Standard. ReadOnly pour le stockage Premium.	'None' 'ReadOnly' 'ReadWrite'
diskEncryptionSet	Spécifie l’ID de ressource du jeu de chiffrement de disque managé du client pour le disque d’image managée.	DiskEncryptionSetParameters
diskSizeGB	Spécifie la taille des disques de données vides en gigaoctets. Cet élément peut être utilisé pour remplacer le nom du disque dans une image de machine virtuelle. Cette valeur ne peut pas être supérieure à 1023 Go.	Int
managedDisk	ManagedDisk.	SubResource
osState	État du système d’exploitation. Pour les images managées, utilisez Généralisé.	'Généralisé' 'Specialized' (obligatoire)
osType	Cette propriété vous permet de spécifier le type du système d’exploitation inclus dans le disque si vous créez une machine virtuelle à partir d’une image personnalisée. Les valeurs possibles sont : Windows,Linux.	'Linux' 'Windows' (obligatoire)
instantané	Capture instantanée.	SubResource
storageAccountType	Spécifie le type de compte de stockage pour le disque managé. REMARQUE : UltraSSD_LRS ne peut être utilisé qu’avec des disques de données, il ne peut pas être utilisé avec le disque du système d’exploitation.	'PremiumV2_LRS' 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' 'UltraSSD_LRS'

ImageProperties

Nom	Description	Valeur
hyperVGeneration	Spécifie l’HyperVGenerationType de VirtualMachine créé à partir de l’image. À partir de l’API Version 2019-03-01 si la source d’image est un objet blob, nous avons besoin de l’utilisateur pour spécifier la valeur, si la source est une ressource gérée comme le disque ou l’instantané, nous pouvons demander à l’utilisateur de spécifier la propriété si nous ne pouvons pas la déduire de la ressource managée source.	'V1' 'V2'
sourceVirtualMachine	Machine virtuelle source à partir de laquelle l’image est créée.	SubResource
storageProfile	Spécifie les paramètres de stockage des disques de machine virtuelle.	ImageStorageProfile

ImageStorageProfile

Nom	Description	Valeur
dataDisks	Spécifie les paramètres utilisés pour ajouter un disque de données à une machine virtuelle. Pour plus d’informations sur les disques, consultez À propos des disques et des disques durs virtuels pour les machines virtuelles Azure.	ImageDataDisk[]
osDisk	Spécifie des informations sur le disque du système d’exploitation utilisé par la machine virtuelle. Pour plus d’informations sur les disques, consultez À propos des disques et des disques durs virtuels pour les machines virtuelles Azure.	ImageOSDisk
zoneResilient	Spécifie si une image est résiliente ou non à une zone. La valeur par défaut est false. Les images résilientes aux zones peuvent être créées uniquement dans les régions qui fournissent un stockage redondant interzone (ZRS).	Bool

Microsoft.Compute/images

Nom	Description	Valeur
extendedLocation	Emplacement étendu de l’image.	ExtendedLocation
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 image.	ImageProperties
étiquettes	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

ResourceTags

Nom	Description	Valeur

Sous-ressource

Nom	Description	Valeur
id	ID de ressource	corde

Définition de ressource de modèle ARM

Le type de ressource d’images 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/images, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.Compute/images",
  "apiVersion": "2024-07-01",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "location": "string",
  "properties": {
    "hyperVGeneration": "string",
    "sourceVirtualMachine": {
      "id": "string"
    },
    "storageProfile": {
      "dataDisks": [
        {
          "blobUri": "string",
          "caching": "string",
          "diskEncryptionSet": {
            "id": "string"
          },
          "diskSizeGB": "int",
          "lun": "int",
          "managedDisk": {
            "id": "string"
          },
          "snapshot": {
            "id": "string"
          },
          "storageAccountType": "string"
        }
      ],
      "osDisk": {
        "blobUri": "string",
        "caching": "string",
        "diskEncryptionSet": {
          "id": "string"
        },
        "diskSizeGB": "int",
        "managedDisk": {
          "id": "string"
        },
        "osState": "string",
        "osType": "string",
        "snapshot": {
          "id": "string"
        },
        "storageAccountType": "string"
      },
      "zoneResilient": "bool"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valeurs de propriété

DiskEncryptionSetParameters

Nom	Description	Valeur
id	ID de ressource	corde

ExtendedLocation

Nom	Description	Valeur
nom	Nom de l’emplacement étendu.	corde
type	Type de l’emplacement étendu.	'EdgeZone'

ImageDataDisk

Nom	Description	Valeur
blobUri	Disque dur virtuel.	corde
Cache	Spécifie les exigences de mise en cache. Les valeurs possibles sont : None,ReadOnly,ReadWrite. Les valeurs par défaut sont les suivantes : None pour le stockage Standard. ReadOnly pour le stockage Premium.	'None' 'ReadOnly' 'ReadWrite'
diskEncryptionSet	Spécifie l’ID de ressource du jeu de chiffrement de disque managé du client pour le disque d’image managée.	DiskEncryptionSetParameters
diskSizeGB	Spécifie la taille des disques de données vides en gigaoctets. Cet élément peut être utilisé pour remplacer le nom du disque dans une image de machine virtuelle. Cette valeur ne peut pas être supérieure à 1023 Go.	Int
lun	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é à une machine virtuelle.	int (obligatoire)
managedDisk	ManagedDisk.	SubResource
instantané	Capture instantanée.	SubResource
storageAccountType	Spécifie le type de compte de stockage pour le disque managé. REMARQUE : UltraSSD_LRS ne peut être utilisé qu’avec des disques de données, il ne peut pas être utilisé avec le disque du système d’exploitation.	'PremiumV2_LRS' 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' 'UltraSSD_LRS'

ImageOSDisk

Nom	Description	Valeur
blobUri	Disque dur virtuel.	corde
Cache	Spécifie les exigences de mise en cache. Les valeurs possibles sont : None,ReadOnly,ReadWrite. Les valeurs par défaut sont les suivantes : None pour le stockage Standard. ReadOnly pour le stockage Premium.	'None' 'ReadOnly' 'ReadWrite'
diskEncryptionSet	Spécifie l’ID de ressource du jeu de chiffrement de disque managé du client pour le disque d’image managée.	DiskEncryptionSetParameters
diskSizeGB	Spécifie la taille des disques de données vides en gigaoctets. Cet élément peut être utilisé pour remplacer le nom du disque dans une image de machine virtuelle. Cette valeur ne peut pas être supérieure à 1023 Go.	Int
managedDisk	ManagedDisk.	SubResource
osState	État du système d’exploitation. Pour les images managées, utilisez Généralisé.	'Généralisé' 'Specialized' (obligatoire)
osType	Cette propriété vous permet de spécifier le type du système d’exploitation inclus dans le disque si vous créez une machine virtuelle à partir d’une image personnalisée. Les valeurs possibles sont : Windows,Linux.	'Linux' 'Windows' (obligatoire)
instantané	Capture instantanée.	SubResource
storageAccountType	Spécifie le type de compte de stockage pour le disque managé. REMARQUE : UltraSSD_LRS ne peut être utilisé qu’avec des disques de données, il ne peut pas être utilisé avec le disque du système d’exploitation.	'PremiumV2_LRS' 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' 'UltraSSD_LRS'

ImageProperties

Nom	Description	Valeur
hyperVGeneration	Spécifie l’HyperVGenerationType de VirtualMachine créé à partir de l’image. À partir de l’API Version 2019-03-01 si la source d’image est un objet blob, nous avons besoin de l’utilisateur pour spécifier la valeur, si la source est une ressource gérée comme le disque ou l’instantané, nous pouvons demander à l’utilisateur de spécifier la propriété si nous ne pouvons pas la déduire de la ressource managée source.	'V1' 'V2'
sourceVirtualMachine	Machine virtuelle source à partir de laquelle l’image est créée.	SubResource
storageProfile	Spécifie les paramètres de stockage des disques de machine virtuelle.	ImageStorageProfile

ImageStorageProfile

Nom	Description	Valeur
dataDisks	Spécifie les paramètres utilisés pour ajouter un disque de données à une machine virtuelle. Pour plus d’informations sur les disques, consultez À propos des disques et des disques durs virtuels pour les machines virtuelles Azure.	ImageDataDisk[]
osDisk	Spécifie des informations sur le disque du système d’exploitation utilisé par la machine virtuelle. Pour plus d’informations sur les disques, consultez À propos des disques et des disques durs virtuels pour les machines virtuelles Azure.	ImageOSDisk
zoneResilient	Spécifie si une image est résiliente ou non à une zone. La valeur par défaut est false. Les images résilientes aux zones peuvent être créées uniquement dans les régions qui fournissent un stockage redondant interzone (ZRS).	Bool

Microsoft.Compute/images

Nom	Description	Valeur
apiVersion	Version de l’API	'2024-07-01'
extendedLocation	Emplacement étendu de l’image.	ExtendedLocation
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 image.	ImageProperties
é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/images'

ResourceTags

Nom	Description	Valeur

Sous-ressource

Nom	Description	Valeur
id	ID de ressource	corde

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 machine virtuelle à partir d’une image utilisateur	Ce modèle vous permet de créer une machine virtuelle à partir d’une image utilisateur. Ce modèle déploie également un réseau virtuel, des adresses IP publiques et une interface réseau.
Créer une machine virtuelle dans un réseau virtuel nouveau ou existant à partir d’un disque dur virtuel généralisé	Ce modèle crée une machine virtuelle à partir d’un disque dur virtuel généralisé et vous permet de le connecter à un réseau virtuel nouveau ou existant pouvant résider dans un autre groupe de ressources que la machine virtuelle.
Déployer un groupe de machines virtuelles identiques avec une image personnalisée Linux	Ce modèle vous permet de déployer une image Linux de machine virtuelle personnalisée à l’intérieur d’un groupe identique. Ces machines virtuelles se trouvent derrière un équilibreur de charge avec équilibrage de charge HTTP (par défaut sur le port 80). L’exemple utilise un script personnalisé pour effectuer le déploiement et la mise à jour de l’application, vous devrez peut-être fournir votre script personnalisé pour votre propre procédure de mise à jour. Vous devrez fournir une image généralisée de votre machine virtuelle dans le même abonnement et la même région où vous créez vmSS.
Déployer un groupe de machines virtuelles identiques avec une image personnalisée Windows	Ce modèle vous permet de déployer un groupe de machines virtuelles identiques simple qui utilise une image Windows personnalisée. Ces machines virtuelles se trouvent derrière un équilibreur de charge avec équilibrage de charge HTTP (par défaut sur le port 80)

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource d’images 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/images, ajoutez terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/images@2024-07-01"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      hyperVGeneration = "string"
      sourceVirtualMachine = {
        id = "string"
      }
      storageProfile = {
        dataDisks = [
          {
            blobUri = "string"
            caching = "string"
            diskEncryptionSet = {
              id = "string"
            }
            diskSizeGB = int
            lun = int
            managedDisk = {
              id = "string"
            }
            snapshot = {
              id = "string"
            }
            storageAccountType = "string"
          }
        ]
        osDisk = {
          blobUri = "string"
          caching = "string"
          diskEncryptionSet = {
            id = "string"
          }
          diskSizeGB = int
          managedDisk = {
            id = "string"
          }
          osState = "string"
          osType = "string"
          snapshot = {
            id = "string"
          }
          storageAccountType = "string"
        }
        zoneResilient = bool
      }
    }
  })
}

Valeurs de propriété

DiskEncryptionSetParameters

Nom	Description	Valeur
id	ID de ressource	corde

ExtendedLocation

Nom	Description	Valeur
nom	Nom de l’emplacement étendu.	corde
type	Type de l’emplacement étendu.	'EdgeZone'

ImageDataDisk

Nom	Description	Valeur
blobUri	Disque dur virtuel.	corde
Cache	Spécifie les exigences de mise en cache. Les valeurs possibles sont : None,ReadOnly,ReadWrite. Les valeurs par défaut sont les suivantes : None pour le stockage Standard. ReadOnly pour le stockage Premium.	'None' 'ReadOnly' 'ReadWrite'
diskEncryptionSet	Spécifie l’ID de ressource du jeu de chiffrement de disque managé du client pour le disque d’image managée.	DiskEncryptionSetParameters
diskSizeGB	Spécifie la taille des disques de données vides en gigaoctets. Cet élément peut être utilisé pour remplacer le nom du disque dans une image de machine virtuelle. Cette valeur ne peut pas être supérieure à 1023 Go.	Int
lun	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é à une machine virtuelle.	int (obligatoire)
managedDisk	ManagedDisk.	SubResource
instantané	Capture instantanée.	SubResource
storageAccountType	Spécifie le type de compte de stockage pour le disque managé. REMARQUE : UltraSSD_LRS ne peut être utilisé qu’avec des disques de données, il ne peut pas être utilisé avec le disque du système d’exploitation.	'PremiumV2_LRS' 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' 'UltraSSD_LRS'

ImageOSDisk

Nom	Description	Valeur
blobUri	Disque dur virtuel.	corde
Cache	Spécifie les exigences de mise en cache. Les valeurs possibles sont : None,ReadOnly,ReadWrite. Les valeurs par défaut sont les suivantes : None pour le stockage Standard. ReadOnly pour le stockage Premium.	'None' 'ReadOnly' 'ReadWrite'
diskEncryptionSet	Spécifie l’ID de ressource du jeu de chiffrement de disque managé du client pour le disque d’image managée.	DiskEncryptionSetParameters
diskSizeGB	Spécifie la taille des disques de données vides en gigaoctets. Cet élément peut être utilisé pour remplacer le nom du disque dans une image de machine virtuelle. Cette valeur ne peut pas être supérieure à 1023 Go.	Int
managedDisk	ManagedDisk.	SubResource
osState	État du système d’exploitation. Pour les images managées, utilisez Généralisé.	'Généralisé' 'Specialized' (obligatoire)
osType	Cette propriété vous permet de spécifier le type du système d’exploitation inclus dans le disque si vous créez une machine virtuelle à partir d’une image personnalisée. Les valeurs possibles sont : Windows,Linux.	'Linux' 'Windows' (obligatoire)
instantané	Capture instantanée.	SubResource
storageAccountType	Spécifie le type de compte de stockage pour le disque managé. REMARQUE : UltraSSD_LRS ne peut être utilisé qu’avec des disques de données, il ne peut pas être utilisé avec le disque du système d’exploitation.	'PremiumV2_LRS' 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' 'UltraSSD_LRS'

ImageProperties

Nom	Description	Valeur
hyperVGeneration	Spécifie l’HyperVGenerationType de VirtualMachine créé à partir de l’image. À partir de l’API Version 2019-03-01 si la source d’image est un objet blob, nous avons besoin de l’utilisateur pour spécifier la valeur, si la source est une ressource gérée comme le disque ou l’instantané, nous pouvons demander à l’utilisateur de spécifier la propriété si nous ne pouvons pas la déduire de la ressource managée source.	'V1' 'V2'
sourceVirtualMachine	Machine virtuelle source à partir de laquelle l’image est créée.	SubResource
storageProfile	Spécifie les paramètres de stockage des disques de machine virtuelle.	ImageStorageProfile

ImageStorageProfile

Nom	Description	Valeur
dataDisks	Spécifie les paramètres utilisés pour ajouter un disque de données à une machine virtuelle. Pour plus d’informations sur les disques, consultez À propos des disques et des disques durs virtuels pour les machines virtuelles Azure.	ImageDataDisk[]
osDisk	Spécifie des informations sur le disque du système d’exploitation utilisé par la machine virtuelle. Pour plus d’informations sur les disques, consultez À propos des disques et des disques durs virtuels pour les machines virtuelles Azure.	ImageOSDisk
zoneResilient	Spécifie si une image est résiliente ou non à une zone. La valeur par défaut est false. Les images résilientes aux zones peuvent être créées uniquement dans les régions qui fournissent un stockage redondant interzone (ZRS).	Bool

Microsoft.Compute/images

Nom	Description	Valeur
extendedLocation	Emplacement étendu de l’image.	ExtendedLocation
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 image.	ImageProperties
étiquettes	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes.
type	Type de ressource	« Microsoft.Compute/images@2024-07-01 »

ResourceTags

Nom	Description	Valeur

Sous-ressource

Nom	Description	Valeur
id	ID de ressource	corde

Partager via

Images Microsoft.Compute

Définition de ressource Bicep

Format de ressource

Valeurs de propriété

DiskEncryptionSetParameters

ExtendedLocation

ImageDataDisk

ImageOSDisk

ImageProperties

ImageStorageProfile

Microsoft.Compute/images

ResourceTags

Sous-ressource

Définition de ressource de modèle ARM

Format de ressource

Valeurs de propriété

DiskEncryptionSetParameters

ExtendedLocation

ImageDataDisk

ImageOSDisk

ImageProperties

ImageStorageProfile

Microsoft.Compute/images

ResourceTags

Sous-ressource

Modèles de démarrage rapide

Définition de ressource Terraform (fournisseur AzAPI)

Format de ressource

Valeurs de propriété

DiskEncryptionSetParameters

ExtendedLocation

ImageDataDisk

ImageOSDisk

ImageProperties

ImageStorageProfile

Microsoft.Compute/images

ResourceTags

Sous-ressource

Commentaires

Ressources supplémentaires