Partager via


Images Microsoft.Compute 2021-03-01

Définition de ressource Bicep

Le type de ressource 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 des ressources

Pour créer une ressource Microsoft.Compute/images, ajoutez le Bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Compute/images@2021-03-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és

images

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

Limite de caractères : 1-80

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

Doit commencer par un caractère alphanumérique. Doit se terminer par un caractère alphanumérique ou un trait de soulignement.
location Emplacement de la ressource chaîne (obligatoire)
tags Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
extendedLocation Emplacement étendu de l’image. ExtendedLocation
properties Décrit les propriétés d’une image. Imageproperties

ExtendedLocation

Nom Description Valeur
name Nom de l’emplacement étendu. string
type Type de l’emplacement étendu. 'EdgeZone'

Imageproperties

Nom Description Valeur
hyperVGeneration Spécifie l’HyperVGenerationType du VirtualMachine créé à partir de l’image. À partir de la version d’API 2019-03-01 si la source d’image est un objet blob, nous avons besoin que l’utilisateur spécifie la valeur. Si la source est une ressource managée comme un disque ou un instantané, nous pouvons exiger de l’utilisateur qu’il spécifie 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. Sous-ressource
storageProfile Spécifie les paramètres de stockage des disques de machine virtuelle. ImageStorageProfile

Sous-ressource

Nom Description Valeur
id ID de ressource string

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 à la zone. La valeur par défaut est false. Les images résilientes de zone ne peuvent être créées que dans les régions qui fournissent un stockage redondant interzone (ZRS). bool

ImageDataDisk

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

Les valeurs possibles sont les suivantes :

Aucun

Lecture seule

Lecture/écriture

Valeur par défaut : Aucune 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 à 1 023 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é Instantané. 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 string

ImageOSDisk

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

Les valeurs possibles sont les suivantes :

Aucun

Lecture seule

Lecture/écriture

Valeur par défaut : Aucune 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 à 1 023 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 lors de la création d’une machine virtuelle à partir d’une image personnalisée.

Les valeurs possibles sont les suivantes :

Windows

Linux
'Linux'
'Windows' (obligatoire)
instantané Instantané. 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 un Machines Virtuelles à partir d’une image Utilisateur. Ce modèle déploie également une 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 la connecter à un réseau virtuel nouveau ou existant qui peut 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 l’abonnement et la région où vous créez le 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 dans 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 ressources de modèle ARM

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

Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Compute/images, ajoutez le JSON suivant à votre modèle.

{
  "type": "Microsoft.Compute/images",
  "apiVersion": "2021-03-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és

images

Nom Description Valeur
type Type de ressource 'Microsoft.Compute/images'
apiVersion Version de l’API de ressource '2021-03-01'
name Nom de la ressource string (obligatoire)

Limite de caractères : 1-80

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

Doit commencer par un caractère alphanumérique. Doit se terminer par un caractère alphanumérique ou un trait de soulignement.
location Emplacement de la ressource string (obligatoire)
tags Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
extendedLocation Emplacement étendu de l’image. ExtendedLocation
properties Décrit les propriétés d’une image. Imageproperties

ExtendedLocation

Nom Description Valeur
name Nom de l’emplacement étendu. string
type Type de l’emplacement étendu. 'EdgeZone'

Imageproperties

Nom Description Valeur
hyperVGeneration Spécifie le Type HyperVGeneration du VirtualMachine créé à partir de l’image. À partir de la version d’API 2019-03-01 si la source d’image est un objet blob, nous avons besoin que l’utilisateur spécifie la valeur. Si la source est une ressource gérée comme un disque ou un instantané, nous pouvons exiger de l’utilisateur qu’il spécifie 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 Image est créée. SubResource
storageProfile Spécifie les paramètres de stockage des disques de machine virtuelle. ImageStorageProfile

SubResource

Nom Description Valeur
id ID de ressource string

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 de 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 à la zone ou non. 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. string
mise en cache Spécifie les exigences de mise en cache.

Les valeurs possibles sont les suivantes :

Aucun

Lecture seule

Lecture/écriture

Valeur par défaut : Aucune 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 à 1 023 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é Instantané. 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 string

ImageOSDisk

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

Les valeurs possibles sont les suivantes :

Aucun

Lecture seule

Lecture/écriture

Valeur par défaut : Aucune 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 à 1 023 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 lors de la création d’une machine virtuelle à partir d’une image personnalisée.

Les valeurs possibles sont les suivantes :

Windows

Linux
'Linux'
'Windows' (obligatoire)
instantané Instantané. 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 un Machines Virtuelles à partir d’une image Utilisateur. Ce modèle déploie également une 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 la connecter à un réseau virtuel nouveau ou existant qui peut 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 l’abonnement et la région où vous créez le 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 dans 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 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 d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Compute/images, ajoutez le Terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/images@2021-03-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és

images

Nom Description Valeur
type Type de ressource « Microsoft.Compute/images@2021-03-01 »
name Nom de la ressource string (obligatoire)

Limite de caractères : 1-80

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

Doit commencer par un caractère alphanumérique. Doit se terminer par un caractère alphanumérique ou un trait de soulignement.
location Emplacement de la ressource string (obligatoire)
parent_id Pour effectuer un déploiement dans un groupe de ressources, utilisez l’ID de ce groupe de ressources. string (obligatoire)
tags Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes.
extendedLocation Emplacement étendu de l’image. ExtendedLocation
properties Décrit les propriétés d’une image. Imageproperties

ExtendedLocation

Nom Description Valeur
name Nom de l’emplacement étendu. string
type Type de l’emplacement étendu. « EdgeZone »

Imageproperties

Nom Description Valeur
hyperVGeneration Spécifie le Type HyperVGeneration du VirtualMachine créé à partir de l’image. À partir de la version d’API 2019-03-01 si la source d’image est un objet blob, nous avons besoin que l’utilisateur spécifie la valeur. Si la source est une ressource gérée comme un disque ou un instantané, nous pouvons exiger de l’utilisateur qu’il spécifie 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 Image est créée. SubResource
storageProfile Spécifie les paramètres de stockage des disques de machine virtuelle. ImageStorageProfile

SubResource

Nom Description Valeur
id ID de ressource string

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 à la zone. La valeur par défaut est false. Les images résilientes de zone ne peuvent être créées que dans les régions qui fournissent un stockage redondant interzone (ZRS). bool

ImageDataDisk

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

Les valeurs possibles sont les suivantes :

Aucun

Lecture seule

Lecture/écriture

Valeur par défaut : Aucune 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 à 1 023 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. Sous-ressource
instantané Instantané. Sous-ressource
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 string

ImageOSDisk

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

Les valeurs possibles sont les suivantes :

Aucun

Lecture seule

Lecture/écriture

Valeur par défaut : Aucune 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 à 1 023 Go
int
managedDisk ManagedDisk. Sous-ressource
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 lors de la création d’une machine virtuelle à partir d’une image personnalisée.

Les valeurs possibles sont les suivantes :

Windows

Linux
« Linux »
« Windows » (obligatoire)
instantané Instantané. 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 »