Partager via


Images Microsoft.Compute 2021-04-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@2021-04-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  extendedLocation: {
    name: 'string'
    type: 'EdgeZone'
  }
  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é

Images

Nom Description Valeur
nom Nom de la ressource chaîne (obligatoire)

Limite de caractères : 1 à 80

Caractères valides :
Alphanumériques, traits de soulignement, points et traits d’union.

Commencez par alphanumérique. Fin avec alphanumérique ou trait de soulignement.
emplacement Emplacement des ressources chaîne (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
extendedLocation Emplacement étendu de l’image. ExtendedLocation
Propriétés Décrit les propriétés d’une image. ImageProperties

ExtendedLocation

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

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

Sous-ressource

Nom Description Valeur
id ID de ressource corde

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

ImageDataDisk

Nom Description Valeur
blobUri Disque dur virtuel. corde
Cache Spécifie les exigences de mise en cache.

Les valeurs possibles sont les suivantes :

Aucun

ReadOnly

ReadWrite

Valeur par défaut : None pour le stockage Standard. ReadOnly pour les de 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. 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'
'UltraSSD_LRS'

DiskEncryptionSetParameters

Nom Description Valeur
id ID de ressource corde

ImageOSDisk

Nom Description Valeur
blobUri Disque dur virtuel. corde
Cache Spécifie les exigences de mise en cache.

Les valeurs possibles sont les suivantes :

Aucun

ReadOnly

ReadWrite

Valeur par défaut : None pour le stockage Standard. ReadOnly pour les de 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. '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 les suivantes :

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. 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'
'UltraSSD_LRS'

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 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": "2021-04-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "extendedLocation": {
    "name": "string",
    "type": "EdgeZone"
  },
  "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é

Images

Nom Description Valeur
type Type de ressource 'Microsoft.Compute/images'
apiVersion Version de l’API de ressource '2021-04-01'
nom Nom de la ressource chaîne (obligatoire)

Limite de caractères : 1 à 80

Caractères valides :
Alphanumériques, traits de soulignement, points et traits d’union.

Commencez par alphanumérique. Fin avec alphanumérique ou trait de soulignement.
emplacement Emplacement des ressources chaîne (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
extendedLocation Emplacement étendu de l’image. ExtendedLocation
Propriétés Décrit les propriétés d’une image. ImageProperties

ExtendedLocation

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

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

Sous-ressource

Nom Description Valeur
id ID de ressource corde

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

ImageDataDisk

Nom Description Valeur
blobUri Disque dur virtuel. corde
Cache Spécifie les exigences de mise en cache.

Les valeurs possibles sont les suivantes :

Aucun

ReadOnly

ReadWrite

Valeur par défaut : None pour le stockage Standard. ReadOnly pour les de 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. 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'
'UltraSSD_LRS'

DiskEncryptionSetParameters

Nom Description Valeur
id ID de ressource corde

ImageOSDisk

Nom Description Valeur
blobUri Disque dur virtuel. corde
Cache Spécifie les exigences de mise en cache.

Les valeurs possibles sont les suivantes :

Aucun

ReadOnly

ReadWrite

Valeur par défaut : None pour le stockage Standard. ReadOnly pour les de 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. '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 les suivantes :

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. 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'
'UltraSSD_LRS'

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@2021-04-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    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
      }
    }
    extendedLocation = {
      name = "string"
      type = "EdgeZone"
    }
  })
}

Valeurs de propriété

Images

Nom Description Valeur
type Type de ressource « Microsoft.Compute/images@2021-04-01 »
nom Nom de la ressource chaîne (obligatoire)

Limite de caractères : 1 à 80

Caractères valides :
Alphanumériques, traits de soulignement, points et traits d’union.

Commencez par alphanumérique. Fin avec alphanumérique ou trait de soulignement.
emplacement Emplacement des ressources chaîne (obligatoire)
parent_id Pour effectuer un déploiement sur un groupe de ressources, utilisez l’ID de ce groupe de ressources. chaîne (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes.
extendedLocation Emplacement étendu de l’image. ExtendedLocation
Propriétés Décrit les propriétés d’une image. ImageProperties

ExtendedLocation

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

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

Sous-ressource

Nom Description Valeur
id ID de ressource corde

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

ImageDataDisk

Nom Description Valeur
blobUri Disque dur virtuel. corde
Cache Spécifie les exigences de mise en cache.

Les valeurs possibles sont les suivantes :

Aucun

ReadOnly

ReadWrite

Valeur par défaut : None pour le stockage Standard. ReadOnly pour les de stockage Premium
« Aucun »
« 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. « Premium_LRS »
« Premium_ZRS »
« StandardSSD_LRS »
« StandardSSD_ZRS »
« Standard_LRS »
« UltraSSD_LRS »

DiskEncryptionSetParameters

Nom Description Valeur
id ID de ressource corde

ImageOSDisk

Nom Description Valeur
blobUri Disque dur virtuel. corde
Cache Spécifie les exigences de mise en cache.

Les valeurs possibles sont les suivantes :

Aucun

ReadOnly

ReadWrite

Valeur par défaut : None pour le stockage Standard. ReadOnly pour les de stockage Premium
« Aucun »
« 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. « Généralisé »
« Spécialisé » (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 les suivantes :

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. « Premium_LRS »
« Premium_ZRS »
« StandardSSD_LRS »
« StandardSSD_ZRS »
« Standard_LRS »
« UltraSSD_LRS »