Instantanés Microsoft.Compute 2020-12-01
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@2020-12-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
sku: {
name: 'string'
}
extendedLocation: {
name: 'string'
type: 'EdgeZone'
}
properties: {
creationData: {
createOption: 'string'
galleryImageReference: {
id: 'string'
lun: int
}
imageReference: {
id: 'string'
lun: int
}
logicalSectorSize: int
sourceResourceId: 'string'
sourceUri: 'string'
storageAccountId: 'string'
uploadSizeBytes: int
}
diskAccessId: 'string'
diskSizeGB: int
encryption: {
diskEncryptionSetId: 'string'
type: 'string'
}
encryptionSettingsCollection: {
enabled: bool
encryptionSettings: [
{
diskEncryptionKey: {
secretUrl: 'string'
sourceVault: {
id: 'string'
}
}
keyEncryptionKey: {
keyUrl: 'string'
sourceVault: {
id: 'string'
}
}
}
]
encryptionSettingsVersion: 'string'
}
hyperVGeneration: 'string'
incremental: bool
networkAccessPolicy: 'string'
osType: 'string'
purchasePlan: {
name: 'string'
product: 'string'
promotionCode: 'string'
publisher: 'string'
}
supportsHibernation: bool
}
}
Valeurs de propriété
Snapshots
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 |
Sku | Nom de la référence sku d’instantanés. Peut être Standard_LRS, Premium_LRS ou Standard_ZRS. Il s’agit d’un paramètre facultatif pour l’instantané incrémentiel et le comportement par défaut est que la référence SKU est définie sur la même référence SKU que l’instantané précédent. | snapshotSku |
extendedLocation | Emplacement étendu où l’instantané sera créé. Impossible de modifier l’emplacement étendu. | ExtendedLocation |
Propriétés | Propriétés des ressources d’instantané. | SnapshotProperties |
ExtendedLocation
Nom | Description | Valeur |
---|---|---|
nom | Nom de l’emplacement étendu. | corde |
type | Type de l’emplacement étendu. | 'EdgeZone' |
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) |
diskAccessId | ID ARM de la ressource DiskAccess pour l’utilisation de points de terminaison privés sur des disques. | corde |
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 |
chiffrement | La propriété de chiffrement peut être utilisée pour chiffrer les données au repos avec des clés gérées par le client ou des clés gérées par la plateforme. | chiffrement |
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 |
networkAccessPolicy | Stratégie d’accès au disque via le réseau. | 'AllowAll' 'AllowPrivate' 'DenyAll' |
osType | Type de système d’exploitation. | 'Linux' 'Windows' |
purchasePlan | Informations sur le plan d’achat de l’image à partir de laquelle le disque source de l’instantané a été créé à l’origine. | PurchasePlan |
supportsHibernation | Indique que le système d’exploitation sur un instantané prend en charge la mise en veille prolongée. | Bool |
CreationData
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 |
Chiffrement
Nom | Description | Valeur |
---|---|---|
diskEncryptionSetId | ResourceId du jeu de chiffrement de disque à utiliser pour activer le chiffrement au repos. | corde |
type | Type de clé utilisé pour chiffrer les données du disque. | 'EncryptionAtRestWithCustomerKey' 'EncryptionAtRestWithPlatformAndCustomerKeys' 'EncryptionAtRestWithPlatformKey' |
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
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) |
SourceVault
Nom | Description | Valeur |
---|---|---|
id | ID de ressource | corde |
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) |
PurchasePlan
Nom | Description | Valeur |
---|---|---|
nom | ID du plan. | chaîne (obligatoire) |
produit | Spécifie le produit de l’image à partir de la Place de marché. Il s’agit de la même valeur que Offer sous l’élément imageReference. | chaîne (obligatoire) |
promotionCode | Code de promotion de l’offre. | corde |
éditeur | ID de l’éditeur. | chaîne (obligatoire) |
SnapshotSku
Nom | Description | Valeur |
---|---|---|
nom | Nom de la référence SKU. | 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
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": "2020-12-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"sku": {
"name": "string"
},
"extendedLocation": {
"name": "string",
"type": "EdgeZone"
},
"properties": {
"creationData": {
"createOption": "string",
"galleryImageReference": {
"id": "string",
"lun": "int"
},
"imageReference": {
"id": "string",
"lun": "int"
},
"logicalSectorSize": "int",
"sourceResourceId": "string",
"sourceUri": "string",
"storageAccountId": "string",
"uploadSizeBytes": "int"
},
"diskAccessId": "string",
"diskSizeGB": "int",
"encryption": {
"diskEncryptionSetId": "string",
"type": "string"
},
"encryptionSettingsCollection": {
"enabled": "bool",
"encryptionSettings": [
{
"diskEncryptionKey": {
"secretUrl": "string",
"sourceVault": {
"id": "string"
}
},
"keyEncryptionKey": {
"keyUrl": "string",
"sourceVault": {
"id": "string"
}
}
}
],
"encryptionSettingsVersion": "string"
},
"hyperVGeneration": "string",
"incremental": "bool",
"networkAccessPolicy": "string",
"osType": "string",
"purchasePlan": {
"name": "string",
"product": "string",
"promotionCode": "string",
"publisher": "string"
},
"supportsHibernation": "bool"
}
}
Valeurs de propriété
Snapshots
Nom | Description | Valeur |
---|---|---|
type | Type de ressource | 'Microsoft.Compute/snapshots' |
apiVersion | Version de l’API de ressource | '2020-12-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 |
Sku | Nom de la référence sku d’instantanés. Peut être Standard_LRS, Premium_LRS ou Standard_ZRS. Il s’agit d’un paramètre facultatif pour l’instantané incrémentiel et le comportement par défaut est que la référence SKU est définie sur la même référence SKU que l’instantané précédent. | snapshotSku |
extendedLocation | Emplacement étendu où l’instantané sera créé. Impossible de modifier l’emplacement étendu. | ExtendedLocation |
Propriétés | Propriétés des ressources d’instantané. | SnapshotProperties |
ExtendedLocation
Nom | Description | Valeur |
---|---|---|
nom | Nom de l’emplacement étendu. | corde |
type | Type de l’emplacement étendu. | 'EdgeZone' |
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) |
diskAccessId | ID ARM de la ressource DiskAccess pour l’utilisation de points de terminaison privés sur des disques. | corde |
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 |
chiffrement | La propriété de chiffrement peut être utilisée pour chiffrer les données au repos avec des clés gérées par le client ou des clés gérées par la plateforme. | chiffrement |
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 |
networkAccessPolicy | Stratégie d’accès au disque via le réseau. | 'AllowAll' 'AllowPrivate' 'DenyAll' |
osType | Type de système d’exploitation. | 'Linux' 'Windows' |
purchasePlan | Informations sur le plan d’achat de l’image à partir de laquelle le disque source de l’instantané a été créé à l’origine. | PurchasePlan |
supportsHibernation | Indique que le système d’exploitation sur un instantané prend en charge la mise en veille prolongée. | Bool |
CreationData
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 |
Chiffrement
Nom | Description | Valeur |
---|---|---|
diskEncryptionSetId | ResourceId du jeu de chiffrement de disque à utiliser pour activer le chiffrement au repos. | corde |
type | Type de clé utilisé pour chiffrer les données du disque. | 'EncryptionAtRestWithCustomerKey' 'EncryptionAtRestWithPlatformAndCustomerKeys' 'EncryptionAtRestWithPlatformKey' |
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
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) |
SourceVault
Nom | Description | Valeur |
---|---|---|
id | ID de ressource | corde |
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) |
PurchasePlan
Nom | Description | Valeur |
---|---|---|
nom | ID du plan. | chaîne (obligatoire) |
produit | Spécifie le produit de l’image à partir de la Place de marché. Il s’agit de la même valeur que Offer sous l’élément imageReference. | chaîne (obligatoire) |
promotionCode | Code de promotion de l’offre. | corde |
éditeur | ID de l’éditeur. | chaîne (obligatoire) |
SnapshotSku
Nom | Description | Valeur |
---|---|---|
nom | Nom de la référence SKU. | 'Premium_LRS' 'Standard_LRS' 'Standard_ZRS' |
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@2020-12-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
creationData = {
createOption = "string"
galleryImageReference = {
id = "string"
lun = int
}
imageReference = {
id = "string"
lun = int
}
logicalSectorSize = int
sourceResourceId = "string"
sourceUri = "string"
storageAccountId = "string"
uploadSizeBytes = int
}
diskAccessId = "string"
diskSizeGB = int
encryption = {
diskEncryptionSetId = "string"
type = "string"
}
encryptionSettingsCollection = {
enabled = bool
encryptionSettings = [
{
diskEncryptionKey = {
secretUrl = "string"
sourceVault = {
id = "string"
}
}
keyEncryptionKey = {
keyUrl = "string"
sourceVault = {
id = "string"
}
}
}
]
encryptionSettingsVersion = "string"
}
hyperVGeneration = "string"
incremental = bool
networkAccessPolicy = "string"
osType = "string"
purchasePlan = {
name = "string"
product = "string"
promotionCode = "string"
publisher = "string"
}
supportsHibernation = bool
}
sku = {
name = "string"
}
extendedLocation = {
name = "string"
type = "EdgeZone"
}
})
}
Valeurs de propriété
Snapshots
Nom | Description | Valeur |
---|---|---|
type | Type de ressource | « Microsoft.Compute/snapshots@2020-12-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. |
Sku | Nom de la référence sku d’instantanés. Peut être Standard_LRS, Premium_LRS ou Standard_ZRS. Il s’agit d’un paramètre facultatif pour l’instantané incrémentiel et le comportement par défaut est que la référence SKU est définie sur la même référence SKU que l’instantané précédent. | snapshotSku |
extendedLocation | Emplacement étendu où l’instantané sera créé. Impossible de modifier l’emplacement étendu. | ExtendedLocation |
Propriétés | Propriétés des ressources d’instantané. | SnapshotProperties |
ExtendedLocation
Nom | Description | Valeur |
---|---|---|
nom | Nom de l’emplacement étendu. | corde |
type | Type de l’emplacement étendu. | « EdgeZone » |
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) |
diskAccessId | ID ARM de la ressource DiskAccess pour l’utilisation de points de terminaison privés sur des disques. | corde |
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 |
chiffrement | La propriété de chiffrement peut être utilisée pour chiffrer les données au repos avec des clés gérées par le client ou des clés gérées par la plateforme. | chiffrement |
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 |
networkAccessPolicy | Stratégie d’accès au disque via le réseau. | « AllowAll » « AllowPrivate » « DenyAll » |
osType | Type de système d’exploitation. | « Linux » « Windows » |
purchasePlan | Informations sur le plan d’achat de l’image à partir de laquelle le disque source de l’instantané a été créé à l’origine. | PurchasePlan |
supportsHibernation | Indique que le système d’exploitation sur un instantané prend en charge la mise en veille prolongée. | Bool |
CreationData
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 |
Chiffrement
Nom | Description | Valeur |
---|---|---|
diskEncryptionSetId | ResourceId du jeu de chiffrement de disque à utiliser pour activer le chiffrement au repos. | corde |
type | Type de clé utilisé pour chiffrer les données du disque. | « EncryptionAtRestWithCustomerKey » « EncryptionAtRestWithPlatformAndCustomerKeys » « EncryptionAtRestWithPlatformKey » |
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
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) |
SourceVault
Nom | Description | Valeur |
---|---|---|
id | ID de ressource | corde |
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) |
PurchasePlan
Nom | Description | Valeur |
---|---|---|
nom | ID du plan. | chaîne (obligatoire) |
produit | Spécifie le produit de l’image à partir de la Place de marché. Il s’agit de la même valeur que Offer sous l’élément imageReference. | chaîne (obligatoire) |
promotionCode | Code de promotion de l’offre. | corde |
éditeur | ID de l’éditeur. | chaîne (obligatoire) |
SnapshotSku
Nom | Description | Valeur |
---|---|---|
nom | Nom de la référence SKU. | « Premium_LRS » « Standard_LRS » « Standard_ZRS » |