Partager via


Images Microsoft.Compute 2023-09-01

Définition de ressource Bicep

Le type de ressource d’images peut être déployé avec des opérations qui ciblent :

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@2023-09-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 :

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": "2023-09-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 '2023-09-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

Déployer sur Azure
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é

Déployer sur Azure
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

Déployer sur Azure
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

Déployer sur Azure
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@2023-09-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@2023-09-01 »

ResourceTags

Nom Description Valeur

Sous-ressource

Nom Description Valeur
id ID de ressource corde