Instantanés Microsoft.Compute 2019-03-01

Article
12/21/2024

Définition de ressource Bicep

Le type de ressource d’instantanés 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/snapshots, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Compute/snapshots@2019-03-01' = {
  location: 'string'
  name: 'string'
  properties: {
    creationData: {
      createOption: 'string'
      imageReference: {
        id: 'string'
        lun: int
      }
      sourceResourceId: 'string'
      sourceUri: 'string'
      storageAccountId: 'string'
      uploadSizeBytes: int
    }
    diskSizeGB: int
    encryptionSettingsCollection: {
      enabled: bool
      encryptionSettings: [
        {
          diskEncryptionKey: {
            secretUrl: 'string'
            sourceVault: {
              id: 'string'
            }
          }
          keyEncryptionKey: {
            keyUrl: 'string'
            sourceVault: {
              id: 'string'
            }
          }
        }
      ]
      encryptionSettingsVersion: 'string'
    }
    hyperVGeneration: 'string'
    incremental: bool
    osType: 'string'
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: '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
uploadSizeBytes	Si createOption est Upload, il s’agit de la taille du contenu du chargement, y compris le pied de page du disque dur virtuel. Cette valeur doit être comprise entre 20972032 (20 Mio + 512 octets pour le pied de page VHD) et 35183298347520 octets (32 Tio + 512 octets pour le pied de page VHD).	Int

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[]
encryptionSettingsVersion	Décrit le type de chiffrement utilisé pour les disques. Une fois ce champ défini, il ne peut pas être remplacé. « 1.0 » correspond à Azure Disk Encryption avec l’application AAD. « 1.1 » correspond à Azure Disk Encryption.	corde

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/snapshots

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 d’instantané.	SnapshotProperties
Sku	Nom de la référence sku d’instantanés. Peut être Standard_LRS, Premium_LRS ou Standard_ZRS.	snapshotSku
étiquettes	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

ResourceTags

Nom	Description	Valeur

SnapshotProperties

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)
diskSizeGB	Si creationData.createOption est vide, ce champ est obligatoire et indique la taille du disque à 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 est 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'
incrémental	Indique si un instantané est incrémentiel. Les instantanés incrémentiels sur le même disque occupent moins d’espace que les instantanés complets et peuvent être différents.	Bool
osType	Type de système d’exploitation.	'Linux' 'Windows'

SnapshotSku

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

SourceVault

Nom	Description	Valeur
id	ID de ressource	corde

Définition de ressource de modèle ARM

Le type de ressource d’instantanés 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/snapshots, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.Compute/snapshots",
  "apiVersion": "2019-03-01",
  "name": "string",
  "location": "string",
  "properties": {
    "creationData": {
      "createOption": "string",
      "imageReference": {
        "id": "string",
        "lun": "int"
      },
      "sourceResourceId": "string",
      "sourceUri": "string",
      "storageAccountId": "string",
      "uploadSizeBytes": "int"
    },
    "diskSizeGB": "int",
    "encryptionSettingsCollection": {
      "enabled": "bool",
      "encryptionSettings": [
        {
          "diskEncryptionKey": {
            "secretUrl": "string",
            "sourceVault": {
              "id": "string"
            }
          },
          "keyEncryptionKey": {
            "keyUrl": "string",
            "sourceVault": {
              "id": "string"
            }
          }
        }
      ],
      "encryptionSettingsVersion": "string"
    },
    "hyperVGeneration": "string",
    "incremental": "bool",
    "osType": "string"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "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
uploadSizeBytes	Si createOption est Upload, il s’agit de la taille du contenu du chargement, y compris le pied de page du disque dur virtuel. Cette valeur doit être comprise entre 20972032 (20 Mio + 512 octets pour le pied de page VHD) et 35183298347520 octets (32 Tio + 512 octets pour le pied de page VHD).	Int

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[]
encryptionSettingsVersion	Décrit le type de chiffrement utilisé pour les disques. Une fois ce champ défini, il ne peut pas être remplacé. « 1.0 » correspond à Azure Disk Encryption avec l’application AAD. « 1.1 » correspond à Azure Disk Encryption.	corde

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/snapshots

Nom	Description	Valeur
apiVersion	Version de l’API	'2019-03-01'
emplacement	Emplacement des ressources	chaîne (obligatoire)
nom	Nom de la ressource	chaîne (obligatoire)
Propriétés	Propriétés des ressources d’instantané.	SnapshotProperties
Sku	Nom de la référence sku d’instantanés. Peut être Standard_LRS, Premium_LRS ou Standard_ZRS.	snapshotSku
é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/snapshots'

ResourceTags

Nom	Description	Valeur

SnapshotProperties

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)
diskSizeGB	Si creationData.createOption est vide, ce champ est obligatoire et indique la taille du disque à 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 est 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'
incrémental	Indique si un instantané est incrémentiel. Les instantanés incrémentiels sur le même disque occupent moins d’espace que les instantanés complets et peuvent être différents.	Bool
osType	Type de système d’exploitation.	'Linux' 'Windows'

SnapshotSku

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

SourceVault

Nom	Description	Valeur
id	ID de ressource	corde

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource d’instantanés 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/snapshots, ajoutez terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/snapshots@2019-03-01"
  name = "string"
  location = "string"
  sku = {
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      creationData = {
        createOption = "string"
        imageReference = {
          id = "string"
          lun = int
        }
        sourceResourceId = "string"
        sourceUri = "string"
        storageAccountId = "string"
        uploadSizeBytes = int
      }
      diskSizeGB = int
      encryptionSettingsCollection = {
        enabled = bool
        encryptionSettings = [
          {
            diskEncryptionKey = {
              secretUrl = "string"
              sourceVault = {
                id = "string"
              }
            }
            keyEncryptionKey = {
              keyUrl = "string"
              sourceVault = {
                id = "string"
              }
            }
          }
        ]
        encryptionSettingsVersion = "string"
      }
      hyperVGeneration = "string"
      incremental = bool
      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
uploadSizeBytes	Si createOption est Upload, il s’agit de la taille du contenu du chargement, y compris le pied de page du disque dur virtuel. Cette valeur doit être comprise entre 20972032 (20 Mio + 512 octets pour le pied de page VHD) et 35183298347520 octets (32 Tio + 512 octets pour le pied de page VHD).	Int

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[]
encryptionSettingsVersion	Décrit le type de chiffrement utilisé pour les disques. Une fois ce champ défini, il ne peut pas être remplacé. « 1.0 » correspond à Azure Disk Encryption avec l’application AAD. « 1.1 » correspond à Azure Disk Encryption.	corde

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/snapshots

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 d’instantané.	SnapshotProperties
Sku	Nom de la référence sku d’instantanés. Peut être Standard_LRS, Premium_LRS ou Standard_ZRS.	snapshotSku
étiquettes	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes.
type	Type de ressource	« Microsoft.Compute/snapshots@2019-03-01 »

ResourceTags

Nom	Description	Valeur

SnapshotProperties

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)
diskSizeGB	Si creationData.createOption est vide, ce champ est obligatoire et indique la taille du disque à 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 est 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'
incrémental	Indique si un instantané est incrémentiel. Les instantanés incrémentiels sur le même disque occupent moins d’espace que les instantanés complets et peuvent être différents.	Bool
osType	Type de système d’exploitation.	'Linux' 'Windows'

SnapshotSku

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

SourceVault

Nom	Description	Valeur
id	ID de ressource	corde

Partager via

Instantanés Microsoft.Compute 2019-03-01

Définition de ressource Bicep

Format de ressource

Valeurs de propriété

CreationData

EncryptionSettingsCollection

EncryptionSettingsElement

ImageDiskReference

KeyVaultAndKeyReference

KeyVaultAndSecretReference

Microsoft.Compute/snapshots

ResourceTags

SnapshotProperties

SnapshotSku

SourceVault

Définition de ressource de modèle ARM

Format de ressource

Valeurs de propriété

CreationData

EncryptionSettingsCollection

EncryptionSettingsElement

ImageDiskReference

KeyVaultAndKeyReference

KeyVaultAndSecretReference

Microsoft.Compute/snapshots

ResourceTags

SnapshotProperties

SnapshotSku

SourceVault

Définition de ressource Terraform (fournisseur AzAPI)

Format de ressource

Valeurs de propriété

CreationData

EncryptionSettingsCollection

EncryptionSettingsElement

ImageDiskReference

KeyVaultAndKeyReference

KeyVaultAndSecretReference

Microsoft.Compute/snapshots

ResourceTags

SnapshotProperties

SnapshotSku

SourceVault

Commentaires

Ressources supplémentaires