Partager via

Disques Microsoft.Compute 2018-09-30

  • Article

Définition de ressource Bicep

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

resource symbolicname 'Microsoft.Compute/disks@2018-09-30' = {
  location: 'string'
  name: 'string'
  properties: {
    creationData: {
      createOption: 'string'
      imageReference: {
        id: 'string'
        lun: int
      }
      sourceResourceId: 'string'
      sourceUri: 'string'
      storageAccountId: 'string'
    }
    diskIOPSReadWrite: int
    diskMBpsReadWrite: int
    diskSizeGB: int
    encryptionSettingsCollection: {
      enabled: bool
      encryptionSettings: [
        {
          diskEncryptionKey: {
            secretUrl: 'string'
            sourceVault: {
              id: 'string'
            }
          }
          keyEncryptionKey: {
            keyUrl: 'string'
            sourceVault: {
              id: 'string'
            }
          }
        }
      ]
    }
    hyperVGeneration: 'string'
    osType: 'string'
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
  zones: [
    'string'
  ]
}

Valeurs de propriété

CreationData

Nom Description Valeur
createOption Cela énumère les sources possibles de la création d’un disque. 'Attacher'
'Copy'
'Empty'
'FromImage'
'Import'
'Restore'
'Upload' (obligatoire)
imageReference Informations sur la source de disque. ImageDiskReference
sourceResourceId Si createOption est Copy, il s’agit de l’ID ARM de l’instantané ou du disque source. corde
sourceUri Si createOption est Import, il s’agit de l’URI d’un objet blob à importer dans un disque managé. corde
storageAccountId Si createOption est Import, l’identificateur Azure Resource Manager du compte de stockage contenant l’objet blob à importer en tant que disque. Obligatoire uniquement si l’objet blob se trouve dans un autre abonnement corde

DiskProperties

Nom Description Valeur
creationData Informations sur la source de disque. Les informations CreationData ne peuvent pas être modifiées une fois le disque créé. CreationData (obligatoire)
diskIOPSReadWrite Nombre d’E/S par seconde autorisées pour ce disque ; uniquement paramétrable pour les disques UltraSSD. Une opération peut transférer entre 4 000 et 256 000 octets. Int
diskMBpsReadWrite Bande passante autorisée pour ce disque ; uniquement paramétrable pour les disques UltraSSD. Les Mbits/s signifient des millions d’octets par seconde : Mo utilise ici la notation ISO, de puissances de 10. Int
diskSizeGB Si creationData.createOption est vide, ce champ est obligatoire et indique la taille du disque dur virtuel à créer. Si ce champ est présent pour les mises à jour ou la création avec d’autres options, il indique un redimensionnement. Les redimensionnements ne sont autorisés que si le disque n’est pas attaché à une machine virtuelle en cours d’exécution et ne peut augmenter que la taille du disque. Int
encryptionSettingsCollection La collection de paramètres de chiffrement utilisée pour Azure Disk Encryption peut contenir plusieurs paramètres de chiffrement par disque ou instantané. EncryptionSettingsCollection
hyperVGeneration Génération d’hyperviseur de la machine virtuelle. Applicable uniquement aux disques du système d’exploitation. 'V1'
'V2'
osType Type de système d’exploitation. 'Linux'
'Windows'

DiskSku

Nom Description Valeur
nom Nom de la référence SKU. 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'
'UltraSSD_LRS'

EncryptionSettingsCollection

Nom Description Valeur
Activé Définissez cet indicateur sur true et fournissez DiskEncryptionKey et KeyEncryptionKey facultatif pour activer le chiffrement. Définissez cet indicateur sur false et supprimez DiskEncryptionKey et KeyEncryptionKey pour désactiver le chiffrement. Si EncryptionSettings a la valeur Null dans l’objet de requête, les paramètres existants restent inchangés. bool (obligatoire)
encryptionSettings Collection de paramètres de chiffrement, un pour chaque volume de disque. EncryptionSettingsElement[]

EncryptionSettingsElement

Nom Description Valeur
diskEncryptionKey URL du secret Key Vault et ID du coffre de la clé de chiffrement de disque KeyVaultAndSecretReference
keyEncryptionKey URL de clé key vault et ID de coffre de la clé de chiffrement de clé. KeyEncryptionKey est facultatif et, lorsqu’il est fourni, est utilisé pour désencapsuler la clé de chiffrement de disque. KeyVaultAndKeyReference

ImageDiskReference

Nom Description Valeur
id URI relatif contenant un référentiel d’images de plateforme ou une référence d’image utilisateur. chaîne (obligatoire)
lun Si le disque est créé à partir du disque de données d’une image, il s’agit d’un index qui indique les disques de données de l’image à utiliser. Pour les disques de système d’exploitation, ce champ a la valeur Null. Int

KeyVaultAndKeyReference

Nom Description Valeur
keyUrl URL pointant vers une clé ou un secret dans KeyVault chaîne (obligatoire)
sourceVault ID de ressource du coffre de clés contenant la clé ou le secret sourceVault (obligatoire)

KeyVaultAndSecretReference

Nom Description Valeur
secretUrl URL pointant vers une clé ou un secret dans KeyVault chaîne (obligatoire)
sourceVault ID de ressource du coffre de clés contenant la clé ou le secret sourceVault (obligatoire)

Microsoft.Compute/disks

Nom Description Valeur
emplacement Emplacement des ressources chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés des ressources de disque. DiskProperties
Sku Nom de la référence SKU des disques. Peut être Standard_LRS, Premium_LRS, StandardSSD_LRS ou UltraSSD_LRS. DiskSku
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
zones Liste de zones logiques pour le disque. string[]

ResourceTags

Nom Description Valeur

SourceVault

Nom Description Valeur
id ID de ressource corde

Exemples de démarrage rapide

Les exemples de démarrage rapide suivants déploient ce type de ressource.

Fichier Bicep Description
Créer un disque & activer la protection via le coffre de sauvegarde Modèle qui crée un disque et active la protection via le coffre de sauvegarde
hôte Docker Windows avec Portainer et Traefik préinstallé Hôte Docker Windows avec Portainer et Traefik préinstallé
machine virtuelle Windows Server avec SSH Déployez une seule machine virtuelle Windows avec Open SSH activé pour vous connecter via SSH à l’aide de l’authentification par clé.

Définition de ressource de modèle ARM

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

{
  "type": "Microsoft.Compute/disks",
  "apiVersion": "2018-09-30",
  "name": "string",
  "location": "string",
  "properties": {
    "creationData": {
      "createOption": "string",
      "imageReference": {
        "id": "string",
        "lun": "int"
      },
      "sourceResourceId": "string",
      "sourceUri": "string",
      "storageAccountId": "string"
    },
    "diskIOPSReadWrite": "int",
    "diskMBpsReadWrite": "int",
    "diskSizeGB": "int",
    "encryptionSettingsCollection": {
      "enabled": "bool",
      "encryptionSettings": [
        {
          "diskEncryptionKey": {
            "secretUrl": "string",
            "sourceVault": {
              "id": "string"
            }
          },
          "keyEncryptionKey": {
            "keyUrl": "string",
            "sourceVault": {
              "id": "string"
            }
          }
        }
      ]
    },
    "hyperVGeneration": "string",
    "osType": "string"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  },
  "zones": [ "string" ]
}

Valeurs de propriété

CreationData

Nom Description Valeur
createOption Cela énumère les sources possibles de la création d’un disque. 'Attacher'
'Copy'
'Empty'
'FromImage'
'Import'
'Restore'
'Upload' (obligatoire)
imageReference Informations sur la source de disque. ImageDiskReference
sourceResourceId Si createOption est Copy, il s’agit de l’ID ARM de l’instantané ou du disque source. corde
sourceUri Si createOption est Import, il s’agit de l’URI d’un objet blob à importer dans un disque managé. corde
storageAccountId Si createOption est Import, l’identificateur Azure Resource Manager du compte de stockage contenant l’objet blob à importer en tant que disque. Obligatoire uniquement si l’objet blob se trouve dans un autre abonnement corde

DiskProperties

Nom Description Valeur
creationData Informations sur la source de disque. Les informations CreationData ne peuvent pas être modifiées une fois le disque créé. CreationData (obligatoire)
diskIOPSReadWrite Nombre d’E/S par seconde autorisées pour ce disque ; uniquement paramétrable pour les disques UltraSSD. Une opération peut transférer entre 4 000 et 256 000 octets. Int
diskMBpsReadWrite Bande passante autorisée pour ce disque ; uniquement paramétrable pour les disques UltraSSD. Les Mbits/s signifient des millions d’octets par seconde : Mo utilise ici la notation ISO, de puissances de 10. Int
diskSizeGB Si creationData.createOption est vide, ce champ est obligatoire et indique la taille du disque dur virtuel à créer. Si ce champ est présent pour les mises à jour ou la création avec d’autres options, il indique un redimensionnement. Les redimensionnements ne sont autorisés que si le disque n’est pas attaché à une machine virtuelle en cours d’exécution et ne peut augmenter que la taille du disque. Int
encryptionSettingsCollection La collection de paramètres de chiffrement utilisée pour Azure Disk Encryption peut contenir plusieurs paramètres de chiffrement par disque ou instantané. EncryptionSettingsCollection
hyperVGeneration Génération d’hyperviseur de la machine virtuelle. Applicable uniquement aux disques du système d’exploitation. 'V1'
'V2'
osType Type de système d’exploitation. 'Linux'
'Windows'

DiskSku

Nom Description Valeur
nom Nom de la référence SKU. 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'
'UltraSSD_LRS'

EncryptionSettingsCollection

Nom Description Valeur
Activé Définissez cet indicateur sur true et fournissez DiskEncryptionKey et KeyEncryptionKey facultatif pour activer le chiffrement. Définissez cet indicateur sur false et supprimez DiskEncryptionKey et KeyEncryptionKey pour désactiver le chiffrement. Si EncryptionSettings a la valeur Null dans l’objet de requête, les paramètres existants restent inchangés. bool (obligatoire)
encryptionSettings Collection de paramètres de chiffrement, un pour chaque volume de disque. EncryptionSettingsElement[]

EncryptionSettingsElement

Nom Description Valeur
diskEncryptionKey URL du secret Key Vault et ID du coffre de la clé de chiffrement de disque KeyVaultAndSecretReference
keyEncryptionKey URL de clé key vault et ID de coffre de la clé de chiffrement de clé. KeyEncryptionKey est facultatif et, lorsqu’il est fourni, est utilisé pour désencapsuler la clé de chiffrement de disque. KeyVaultAndKeyReference

ImageDiskReference

Nom Description Valeur
id URI relatif contenant un référentiel d’images de plateforme ou une référence d’image utilisateur. chaîne (obligatoire)
lun Si le disque est créé à partir du disque de données d’une image, il s’agit d’un index qui indique les disques de données de l’image à utiliser. Pour les disques de système d’exploitation, ce champ a la valeur Null. Int

KeyVaultAndKeyReference

Nom Description Valeur
keyUrl URL pointant vers une clé ou un secret dans KeyVault chaîne (obligatoire)
sourceVault ID de ressource du coffre de clés contenant la clé ou le secret sourceVault (obligatoire)

KeyVaultAndSecretReference

Nom Description Valeur
secretUrl URL pointant vers une clé ou un secret dans KeyVault chaîne (obligatoire)
sourceVault ID de ressource du coffre de clés contenant la clé ou le secret sourceVault (obligatoire)

Microsoft.Compute/disks

Nom Description Valeur
apiVersion Version de l’API '2018-09-30'
emplacement Emplacement des ressources chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés des ressources de disque. DiskProperties
Sku Nom de la référence SKU des disques. Peut être Standard_LRS, Premium_LRS, StandardSSD_LRS ou UltraSSD_LRS. DiskSku
é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/disks'
zones Liste de zones logiques pour le disque. string[]

ResourceTags

Nom Description Valeur

SourceVault

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’un disque dur virtuel EfficientIP

Déployer sur Azure 		Ce modèle crée une machine virtuelle à partir d’un disque dur virtuel EfficientIP et vous permet de le connecter à un réseau virtuel existant qui peut résider dans un autre groupe de ressources, puis la machine virtuelle.
Créer une machine virtuelle dans un réseau virtuel nouveau ou existant à partir d’un disque dur virtuel personnalisé

Déployer sur Azure 		Ce modèle crée une machine virtuelle à partir d’un disque dur virtuel spécialisé 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.
Créer un disque & activer la protection via le coffre de sauvegarde

Déployer sur Azure 		Modèle qui crée un disque et active la protection via le coffre de sauvegarde
Créer une machine virtuelle à partir de disques durs virtuels existants et la connecter à un VNET existant

Déployer sur Azure 		Ce modèle crée une machine virtuelle à partir de disques durs virtuels (système d’exploitation + disque de données) et vous permet de le connecter à un réseau virtuel existant qui peut résider dans un autre groupe de ressources, puis la machine virtuelle.
Crée un disque ultra managé avec une taille de secteur spécifique

Déployer sur Azure 		Ce modèle crée un disque ultra managé qui permet à l’utilisateur de spécifier une taille de secteur de 512 ou 4096.
Déployer un cluster Percona XtraDB à 3 nœuds dans des zones de disponibilité

Déployer sur Azure 		Ce modèle déploie un cluster à haute disponibilité MySQL à 3 nœuds sur CentOS 6.5 ou Ubuntu 12.04
paramètres de stockage optimisé pour les machines virtuelles SQL sur les UltraSSD

Déployer sur Azure 		Créer une machine virtuelle SQL Server avec des paramètres de stockage optimisés pour les performances, à l’aide d’UltraSSD pour les fichiers journaux SQL
hôte Docker Windows avec Portainer et Traefik préinstallé

Déployer sur Azure 		Hôte Docker Windows avec Portainer et Traefik préinstallé
machine virtuelle Windows Server avec SSH

Déployer sur Azure 		Déployez une seule machine virtuelle Windows avec Open SSH activé pour vous connecter via SSH à l’aide de l’authentification par clé.

Définition de ressource Terraform (fournisseur AzAPI)

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/disks@2018-09-30"
  name = "string"
  location = "string"
  sku = {
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  zones = [
    "string"
  ]
  body = jsonencode({
    properties = {
      creationData = {
        createOption = "string"
        imageReference = {
          id = "string"
          lun = int
        }
        sourceResourceId = "string"
        sourceUri = "string"
        storageAccountId = "string"
      }
      diskIOPSReadWrite = int
      diskMBpsReadWrite = int
      diskSizeGB = int
      encryptionSettingsCollection = {
        enabled = bool
        encryptionSettings = [
          {
            diskEncryptionKey = {
              secretUrl = "string"
              sourceVault = {
                id = "string"
              }
            }
            keyEncryptionKey = {
              keyUrl = "string"
              sourceVault = {
                id = "string"
              }
            }
          }
        ]
      }
      hyperVGeneration = "string"
      osType = "string"
    }
  })
}

Valeurs de propriété

CreationData

Nom Description Valeur
createOption Cela énumère les sources possibles de la création d’un disque. 'Attacher'
'Copy'
'Empty'
'FromImage'
'Import'
'Restore'
'Upload' (obligatoire)
imageReference Informations sur la source de disque. ImageDiskReference
sourceResourceId Si createOption est Copy, il s’agit de l’ID ARM de l’instantané ou du disque source. corde
sourceUri Si createOption est Import, il s’agit de l’URI d’un objet blob à importer dans un disque managé. corde
storageAccountId Si createOption est Import, l’identificateur Azure Resource Manager du compte de stockage contenant l’objet blob à importer en tant que disque. Obligatoire uniquement si l’objet blob se trouve dans un autre abonnement corde

DiskProperties

Nom Description Valeur
creationData Informations sur la source de disque. Les informations CreationData ne peuvent pas être modifiées une fois le disque créé. CreationData (obligatoire)
diskIOPSReadWrite Nombre d’E/S par seconde autorisées pour ce disque ; uniquement paramétrable pour les disques UltraSSD. Une opération peut transférer entre 4 000 et 256 000 octets. Int
diskMBpsReadWrite Bande passante autorisée pour ce disque ; uniquement paramétrable pour les disques UltraSSD. Les Mbits/s signifient des millions d’octets par seconde : Mo utilise ici la notation ISO, de puissances de 10. Int
diskSizeGB Si creationData.createOption est vide, ce champ est obligatoire et indique la taille du disque dur virtuel à créer. Si ce champ est présent pour les mises à jour ou la création avec d’autres options, il indique un redimensionnement. Les redimensionnements ne sont autorisés que si le disque n’est pas attaché à une machine virtuelle en cours d’exécution et ne peut augmenter que la taille du disque. Int
encryptionSettingsCollection La collection de paramètres de chiffrement utilisée pour Azure Disk Encryption peut contenir plusieurs paramètres de chiffrement par disque ou instantané. EncryptionSettingsCollection
hyperVGeneration Génération d’hyperviseur de la machine virtuelle. Applicable uniquement aux disques du système d’exploitation. 'V1'
'V2'
osType Type de système d’exploitation. 'Linux'
'Windows'

DiskSku

Nom Description Valeur
nom Nom de la référence SKU. 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'
'UltraSSD_LRS'

EncryptionSettingsCollection

Nom Description Valeur
Activé Définissez cet indicateur sur true et fournissez DiskEncryptionKey et KeyEncryptionKey facultatif pour activer le chiffrement. Définissez cet indicateur sur false et supprimez DiskEncryptionKey et KeyEncryptionKey pour désactiver le chiffrement. Si EncryptionSettings a la valeur Null dans l’objet de requête, les paramètres existants restent inchangés. bool (obligatoire)
encryptionSettings Collection de paramètres de chiffrement, un pour chaque volume de disque. EncryptionSettingsElement[]

EncryptionSettingsElement

Nom Description Valeur
diskEncryptionKey URL du secret Key Vault et ID du coffre de la clé de chiffrement de disque KeyVaultAndSecretReference
keyEncryptionKey URL de clé key vault et ID de coffre de la clé de chiffrement de clé. KeyEncryptionKey est facultatif et, lorsqu’il est fourni, est utilisé pour désencapsuler la clé de chiffrement de disque. KeyVaultAndKeyReference

ImageDiskReference

Nom Description Valeur
id URI relatif contenant un référentiel d’images de plateforme ou une référence d’image utilisateur. chaîne (obligatoire)
lun Si le disque est créé à partir du disque de données d’une image, il s’agit d’un index qui indique les disques de données de l’image à utiliser. Pour les disques de système d’exploitation, ce champ a la valeur Null. Int

KeyVaultAndKeyReference

Nom Description Valeur
keyUrl URL pointant vers une clé ou un secret dans KeyVault chaîne (obligatoire)
sourceVault ID de ressource du coffre de clés contenant la clé ou le secret sourceVault (obligatoire)

KeyVaultAndSecretReference

Nom Description Valeur
secretUrl URL pointant vers une clé ou un secret dans KeyVault chaîne (obligatoire)
sourceVault ID de ressource du coffre de clés contenant la clé ou le secret sourceVault (obligatoire)

Microsoft.Compute/disks

Nom Description Valeur
emplacement Emplacement des ressources chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés des ressources de disque. DiskProperties
Sku Nom de la référence SKU des disques. Peut être Standard_LRS, Premium_LRS, StandardSSD_LRS ou UltraSSD_LRS. DiskSku
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.Compute/disks@2018-09-30 »
zones Liste de zones logiques pour le disque. string[]

ResourceTags

Nom Description Valeur

SourceVault

Nom Description Valeur
id ID de ressource corde