Microsoft.Compute/disks 2018-06-01 - Bicep, ARM template & Terraform AzAPI reference

Définition de ressource Bicep

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

groupes de ressources - Consultez commandes de déploiement de groupes de ressources

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

Format de ressource

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

resource symbolicname 'Microsoft.Compute/disks@2018-06-01' = {
  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
    encryptionSettings: {
      diskEncryptionKey: {
        secretUrl: 'string'
        sourceVault: {
          id: 'string'
        }
      }
      enabled: bool
      keyEncryptionKey: {
        keyUrl: 'string'
        sourceVault: {
          id: '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' (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. Pour obtenir une description de la plage de valeurs que vous pouvez définir, consultez Offres de disques managés Ultra SSD.	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. Pour obtenir une description de la plage de valeurs que vous pouvez définir, consultez Offres de disques managés Ultra SSD.	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
encryptionSettings	Paramètres de chiffrement pour le disque ou l’instantané	EncryptionSettings
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'

EncryptionSettings

Nom	Description	Valeur
diskEncryptionKey	URL du secret Key Vault et ID du coffre de la clé de chiffrement de disque	KeyVaultAndSecretReference
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
keyEncryptionKey	URL de clé key Vault et ID de coffre de la clé de chiffrement de clé	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 :

groupes de ressources - Consultez commandes de déploiement de groupes de ressources

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

Format de ressource

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

{
  "type": "Microsoft.Compute/disks",
  "apiVersion": "2018-06-01",
  "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",
    "encryptionSettings": {
      "diskEncryptionKey": {
        "secretUrl": "string",
        "sourceVault": {
          "id": "string"
        }
      },
      "enabled": "bool",
      "keyEncryptionKey": {
        "keyUrl": "string",
        "sourceVault": {
          "id": "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' (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. Pour obtenir une description de la plage de valeurs que vous pouvez définir, consultez Offres de disques managés Ultra SSD.	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. Pour obtenir une description de la plage de valeurs que vous pouvez définir, consultez Offres de disques managés Ultra SSD.	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
encryptionSettings	Paramètres de chiffrement pour le disque ou l’instantané	EncryptionSettings
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'

EncryptionSettings

Nom	Description	Valeur
diskEncryptionKey	URL du secret Key Vault et ID du coffre de la clé de chiffrement de disque	KeyVaultAndSecretReference
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
keyEncryptionKey	URL de clé key Vault et ID de coffre de la clé de chiffrement de clé	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-06-01'
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	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é	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	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	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	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é	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	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é	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 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-06-01"
  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
      encryptionSettings = {
        diskEncryptionKey = {
          secretUrl = "string"
          sourceVault = {
            id = "string"
          }
        }
        enabled = bool
        keyEncryptionKey = {
          keyUrl = "string"
          sourceVault = {
            id = "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' (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. Pour obtenir une description de la plage de valeurs que vous pouvez définir, consultez Offres de disques managés Ultra SSD.	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. Pour obtenir une description de la plage de valeurs que vous pouvez définir, consultez Offres de disques managés Ultra SSD.	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
encryptionSettings	Paramètres de chiffrement pour le disque ou l’instantané	EncryptionSettings
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'

EncryptionSettings

Nom	Description	Valeur
diskEncryptionKey	URL du secret Key Vault et ID du coffre de la clé de chiffrement de disque	KeyVaultAndSecretReference
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
keyEncryptionKey	URL de clé key Vault et ID de coffre de la clé de chiffrement de clé	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-06-01 »
zones	Liste de zones logiques pour le disque.	string[]

ResourceTags

Nom	Description	Valeur

SourceVault

Nom	Description	Valeur
id	ID de ressource	corde

Partager via

Disques Microsoft.Compute 2018-06-01

Définition de ressource Bicep

Format de ressource

Valeurs de propriété

CreationData

DiskProperties

DiskSku

EncryptionSettings

ImageDiskReference

KeyVaultAndKeyReference

KeyVaultAndSecretReference

Microsoft.Compute/disks

ResourceTags

SourceVault

Exemples de démarrage rapide

Définition de ressource de modèle ARM

Format de ressource

Valeurs de propriété

CreationData

DiskProperties

DiskSku

EncryptionSettings

ImageDiskReference

KeyVaultAndKeyReference

KeyVaultAndSecretReference

Microsoft.Compute/disks

ResourceTags

SourceVault

Modèles de démarrage rapide

Définition de ressource Terraform (fournisseur AzAPI)

Format de ressource

Valeurs de propriété

CreationData

DiskProperties

DiskSku

EncryptionSettings

ImageDiskReference

KeyVaultAndKeyReference

KeyVaultAndSecretReference

Microsoft.Compute/disks

ResourceTags

SourceVault

Commentaires

Ressources supplémentaires