Condividi tramite

Snapshot Microsoft.Compute 2023-10-02

  • Articolo

Definizione di risorsa Bicep

Il tipo di risorsa snapshot può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Compute/snapshots, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.Compute/snapshots@2023-10-02' = {
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    completionPercent: int
    copyCompletionError: {
      errorCode: 'string'
      errorMessage: 'string'
    }
    creationData: {
      createOption: 'string'
      elasticSanResourceId: 'string'
      galleryImageReference: {
        communityGalleryImageId: 'string'
        id: 'string'
        lun: int
        sharedGalleryImageId: 'string'
      }
      imageReference: {
        communityGalleryImageId: 'string'
        id: 'string'
        lun: int
        sharedGalleryImageId: 'string'
      }
      logicalSectorSize: int
      performancePlus: bool
      provisionedBandwidthCopySpeed: 'string'
      securityDataUri: 'string'
      sourceResourceId: 'string'
      sourceUri: 'string'
      storageAccountId: 'string'
      uploadSizeBytes: int
    }
    dataAccessAuthMode: 'string'
    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'
    publicNetworkAccess: 'string'
    purchasePlan: {
      name: 'string'
      product: 'string'
      promotionCode: 'string'
      publisher: 'string'
    }
    securityProfile: {
      secureVMDiskEncryptionSetId: 'string'
      securityType: 'string'
    }
    supportedCapabilities: {
      acceleratedNetwork: bool
      architecture: 'string'
      diskControllerTypes: 'string'
    }
    supportsHibernation: bool
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valori delle proprietà

CopyCompletionError

Nome Descrizione Valore
errorCode Indica il codice di errore se la copia in background di una risorsa creata tramite l'operazione CopyStart ha esito negativo. 'CopySourceNotFound' (obbligatorio)
errorMessage Indica il messaggio di errore se la copia in background di una risorsa creata tramite l'operazione CopyStart ha esito negativo. stringa (obbligatorio)

CreationData

Nome Descrizione Valore
createOption In questo modo vengono enumerate le possibili origini della creazione di un disco. 'Attach'
'Copia'
'CopyFromSanSnapshot'
'CopyStart'
'Empty'
'FromImage'
'Import'
'ImportSecure'
'Restore'
'Carica'
'UploadPreparedSecure' (obbligatorio)
elasticSanResourceId Obbligatorio se createOption è CopyFromSanSnapshot. Si tratta dell'ID ARM dello snapshot del volume san elastico di origine. corda
galleryImageReference Obbligatorio se si crea da un'immagine della raccolta. Id/sharedGalleryImageId/communityGalleryImageId di ImageDiskReference sarà l'ID ARM della versione dell'immagine condivisa da cui creare un disco. ImageDiskReference
imageReference Informazioni sull'origine del disco per immagini PIR o utente. ImageDiskReference
logicalSectorSize Dimensioni del settore logico in byte per i dischi Ultra. I valori supportati sono 512 annunci 4096. 4096 è l'impostazione predefinita. Int
performancePlus Impostare questo flag su true per ottenere un aumento della destinazione delle prestazioni del disco distribuito, vedere qui nella rispettiva destinazione delle prestazioni. Questo flag può essere impostato solo in fase di creazione del disco e non può essere disabilitato dopo l'abilitazione. Bool
provisionedBandwidthCopySpeed Se questo campo è impostato su uno snapshot e createOption è CopyStart, lo snapshot verrà copiato con una velocità più rapida. 'Avanzato'
'Nessuno'
securityDataUri Se createOption è ImportSecure, si tratta dell'URI di un BLOB da importare nello stato guest della macchina virtuale. corda
sourceResourceId Se createOption è Copy, si tratta dell'ID ARM dello snapshot o del disco di origine. corda
sourceUri Se createOption è Import, si tratta dell'URI di un BLOB da importare in un disco gestito. corda
storageAccountId Obbligatorio se createOption è Import. Identificatore di Azure Resource Manager dell'account di archiviazione contenente il BLOB da importare come disco. corda
uploadSizeBytes Se createOption è Upload, si tratta delle dimensioni del contenuto del caricamento, incluso il piè di pagina del disco rigido virtuale. Questo valore deve essere compreso tra 20972032 (20 MiB + 512 byte per il piè di pagina del disco rigido virtuale) e 35183298347520 byte (32 TiB + 512 byte per il piè di pagina del disco rigido virtuale). Int

DiskSecurityProfile

Nome Descrizione Valore
secureVMDiskEncryptionSetId ResourceId del set di crittografia del disco associato a Confidential VM supported disk encrypted with customer managed key corda
securityType Specifica il Tipo di sicurezza della macchina virtuale. Applicabile solo per i dischi del sistema operativo. 'ConfidentialVM_DiskEncryptedWithCustomerKey'
'ConfidentialVM_DiskEncryptedWithPlatformKey'
'ConfidentialVM_NonPersistedTPM'
'ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey'
'TrustedLaunch'

Codifica

Nome Descrizione Valore
diskEncryptionSetId ResourceId del set di crittografia del disco da usare per abilitare la crittografia dei dati inattivi. corda
digitare Tipo di chiave utilizzata per crittografare i dati del disco. 'EncryptionAtRestWithCustomerKey'
'EncryptionAtRestWithPlatformAndCustomerKeys'
'EncryptionAtRestWithPlatformKey'

EncryptionSettingsCollection

Nome Descrizione Valore
Abilitato Impostare questo flag su true e specificare DiskEncryptionKey e keyEncryptionKey facoltativo per abilitare la crittografia. Impostare questo flag su false e rimuovere DiskEncryptionKey e KeyEncryptionKey per disabilitare la crittografia. Se EncryptionSettings è Null nell'oggetto richiesta, le impostazioni esistenti rimangono invariate. bool (obbligatorio)
encryptionSettings Raccolta di impostazioni di crittografia, una per ogni volume del disco. EncryptionSettingsElement[]
encryptionSettingsVersion Descrive il tipo di crittografia usato per i dischi. Dopo aver impostato questo campo, non può essere sovrascritto. '1.0' corrisponde a Crittografia dischi di Azure con l'app AAD.'1.1' corrisponde a Crittografia dischi di Azure. corda

EncryptionSettingsElement

Nome Descrizione Valore
diskEncryptionKey URL segreto dell'insieme di credenziali delle chiavi e ID dell'insieme di credenziali della chiave di crittografia del disco KeyVaultAndSecretReference
keyEncryptionKey URL della chiave dell'insieme di credenziali delle chiavi e ID dell'insieme di credenziali della chiave. KeyEncryptionKey è facoltativo e, se specificato, viene usato per annullare il wrapping della chiave di crittografia del disco. KeyVaultAndKeyReference

ExtendedLocation

Nome Descrizione Valore
nome Nome della posizione estesa. corda
digitare Tipo della posizione estesa. 'EdgeZone'

ImageDiskReference

Nome Descrizione Valore
communityGalleryImageId URI relativo contenente un riferimento all'immagine della raccolta di calcolo di Azure della community. corda
Id URI relativo contenente un repository di immagini della piattaforma, un'immagine utente o un riferimento all'immagine della raccolta di calcolo di Azure. corda
lun Se il disco viene creato dal disco dati di un'immagine, si tratta di un indice che indica quale dei dischi dati nell'immagine usare. Per i dischi del sistema operativo, questo campo è Null. Int
sharedGalleryImageId URI relativo contenente un riferimento diretto all'immagine della raccolta di calcolo di Azure condivisa. corda

KeyVaultAndKeyReference

Nome Descrizione Valore
keyUrl URL che punta a una chiave o a un segreto in KeyVault stringa (obbligatorio)
sourceVault ID risorsa dell'insieme di credenziali delle chiavi contenente la chiave o il segreto SourceVault (obbligatorio)

KeyVaultAndSecretReference

Nome Descrizione Valore
secretUrl URL che punta a una chiave o a un segreto in KeyVault stringa (obbligatorio)
sourceVault ID risorsa dell'insieme di credenziali delle chiavi contenente la chiave o il segreto SourceVault (obbligatorio)

Microsoft.Compute/snapshots

Nome Descrizione Valore
extendedLocation Posizione estesa in cui verrà creato lo snapshot. Impossibile modificare la posizione estesa. ExtendedLocation
ubicazione Percorso risorsa stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà delle risorse snapshot. SnapshotProperties
Sku Nome sku degli snapshot. Può essere Standard_LRS, Premium_LRS o Standard_ZRS. Si tratta di un parametro facoltativo per lo snapshot incrementale e il comportamento predefinito è che lo SKU verrà impostato sullo stesso SKU dello snapshot precedente snapshotSku
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

PurchasePlan

Nome Descrizione Valore
nome ID del piano. stringa (obbligatorio)
prodotto Specifica il prodotto dell'immagine dal marketplace. Si tratta dello stesso valore di Offer nell'elemento imageReference. stringa (obbligatorio)
promotionCode Codice promozionale dell'offerta. corda
editore ID editore. stringa (obbligatorio)

ResourceTags

Nome Descrizione Valore

Proprietà snapshot

Nome Descrizione Valore
completionPercent Percentuale di completamento per la copia in background quando viene creata una risorsa tramite l'operazione CopyStart. Int
copyCompletionError Indica i dettagli dell'errore se la copia in background di una risorsa creata tramite l'operazione CopyStart ha esito negativo. CopyCompletionError
creationData Informazioni sull'origine del disco. Le informazioni creationData non possono essere modificate dopo la creazione del disco. CreationData (obbligatorio)
dataAccessAuthMode Requisiti di autenticazione aggiuntivi per l'esportazione o il caricamento in un disco o uno snapshot. 'AzureActiveDirectory'
'Nessuno'
diskAccessId ID ARM della risorsa DiskAccess per l'uso di endpoint privati su dischi. corda
diskSizeGB Se creationData.createOption è Vuoto, questo campo è obbligatorio e indica le dimensioni del disco da creare. Se questo campo è presente per gli aggiornamenti o la creazione con altre opzioni, indica un ridimensionamento. I ridimensionamenti sono consentiti solo se il disco non è collegato a una macchina virtuale in esecuzione e può aumentare solo le dimensioni del disco. Int
codifica La proprietà di crittografia può essere usata per crittografare i dati inattivi con chiavi gestite dal cliente o chiavi gestite dalla piattaforma. crittografia
encryptionSettingsCollection La raccolta di impostazioni di crittografia usata è Crittografia dischi di Azure, può contenere più impostazioni di crittografia per disco o snapshot. EncryptionSettingsCollection
hyperVGeneration Generazione dell'hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo. 'V1'
'V2'
incrementale Indica se uno snapshot è incrementale. Gli snapshot incrementali sullo stesso disco occupano meno spazio rispetto agli snapshot completi e possono essere diffati. Bool
networkAccessPolicy Criteri per l'accesso al disco tramite rete. 'AllowAll'
'AllowPrivate'
'DenyAll'
osType Tipo di sistema operativo. 'Linux'
'Windows'
publicNetworkAccess Criteri per controllare l'esportazione sul disco. 'Disabilitato'
'Enabled'
purchasePlan Informazioni sul piano di acquisto per l'immagine da cui è stato originariamente creato il disco di origine per lo snapshot. PurchasePlan
securityProfile Contiene le informazioni relative alla sicurezza per la risorsa. DiskSecurityProfile
supportedCapabilities Elenco delle funzionalità supportate per l'immagine da cui è stato originariamente creato il disco di origine dallo snapshot. supportedCapabilities
supportsHibernation Indica che il sistema operativo in uno snapshot supporta l'ibernazione. Bool

SnapshotSku

Nome Descrizione Valore
nome Nome sku. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

SourceVault

Nome Descrizione Valore
Id ID risorsa corda

SupportedCapabilities

Nome Descrizione Valore
acceleratedNetwork True se l'immagine da cui viene creato il disco del sistema operativo supporta la rete accelerata. Bool
architettura Architettura della CPU supportata da un disco del sistema operativo. 'Arm64'
'x64'
diskControllerTypes Controller del disco supportati da un disco del sistema operativo. Se impostato, può essere SCSI o SCSI, NVME o NVME, SCSI. corda

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa snapshot può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Compute/snapshots, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.Compute/snapshots",
  "apiVersion": "2023-10-02",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "location": "string",
  "properties": {
    "completionPercent": "int",
    "copyCompletionError": {
      "errorCode": "string",
      "errorMessage": "string"
    },
    "creationData": {
      "createOption": "string",
      "elasticSanResourceId": "string",
      "galleryImageReference": {
        "communityGalleryImageId": "string",
        "id": "string",
        "lun": "int",
        "sharedGalleryImageId": "string"
      },
      "imageReference": {
        "communityGalleryImageId": "string",
        "id": "string",
        "lun": "int",
        "sharedGalleryImageId": "string"
      },
      "logicalSectorSize": "int",
      "performancePlus": "bool",
      "provisionedBandwidthCopySpeed": "string",
      "securityDataUri": "string",
      "sourceResourceId": "string",
      "sourceUri": "string",
      "storageAccountId": "string",
      "uploadSizeBytes": "int"
    },
    "dataAccessAuthMode": "string",
    "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",
    "publicNetworkAccess": "string",
    "purchasePlan": {
      "name": "string",
      "product": "string",
      "promotionCode": "string",
      "publisher": "string"
    },
    "securityProfile": {
      "secureVMDiskEncryptionSetId": "string",
      "securityType": "string"
    },
    "supportedCapabilities": {
      "acceleratedNetwork": "bool",
      "architecture": "string",
      "diskControllerTypes": "string"
    },
    "supportsHibernation": "bool"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valori delle proprietà

CopyCompletionError

Nome Descrizione Valore
errorCode Indica il codice di errore se la copia in background di una risorsa creata tramite l'operazione CopyStart ha esito negativo. 'CopySourceNotFound' (obbligatorio)
errorMessage Indica il messaggio di errore se la copia in background di una risorsa creata tramite l'operazione CopyStart ha esito negativo. stringa (obbligatorio)

CreationData

Nome Descrizione Valore
createOption In questo modo vengono enumerate le possibili origini della creazione di un disco. 'Attach'
'Copia'
'CopyFromSanSnapshot'
'CopyStart'
'Empty'
'FromImage'
'Import'
'ImportSecure'
'Restore'
'Carica'
'UploadPreparedSecure' (obbligatorio)
elasticSanResourceId Obbligatorio se createOption è CopyFromSanSnapshot. Si tratta dell'ID ARM dello snapshot del volume san elastico di origine. corda
galleryImageReference Obbligatorio se si crea da un'immagine della raccolta. Id/sharedGalleryImageId/communityGalleryImageId di ImageDiskReference sarà l'ID ARM della versione dell'immagine condivisa da cui creare un disco. ImageDiskReference
imageReference Informazioni sull'origine del disco per immagini PIR o utente. ImageDiskReference
logicalSectorSize Dimensioni del settore logico in byte per i dischi Ultra. I valori supportati sono 512 annunci 4096. 4096 è l'impostazione predefinita. Int
performancePlus Impostare questo flag su true per ottenere un aumento della destinazione delle prestazioni del disco distribuito, vedere qui nella rispettiva destinazione delle prestazioni. Questo flag può essere impostato solo in fase di creazione del disco e non può essere disabilitato dopo l'abilitazione. Bool
provisionedBandwidthCopySpeed Se questo campo è impostato su uno snapshot e createOption è CopyStart, lo snapshot verrà copiato con una velocità più rapida. 'Avanzato'
'Nessuno'
securityDataUri Se createOption è ImportSecure, si tratta dell'URI di un BLOB da importare nello stato guest della macchina virtuale. corda
sourceResourceId Se createOption è Copy, si tratta dell'ID ARM dello snapshot o del disco di origine. corda
sourceUri Se createOption è Import, si tratta dell'URI di un BLOB da importare in un disco gestito. corda
storageAccountId Obbligatorio se createOption è Import. Identificatore di Azure Resource Manager dell'account di archiviazione contenente il BLOB da importare come disco. corda
uploadSizeBytes Se createOption è Upload, si tratta delle dimensioni del contenuto del caricamento, incluso il piè di pagina del disco rigido virtuale. Questo valore deve essere compreso tra 20972032 (20 MiB + 512 byte per il piè di pagina del disco rigido virtuale) e 35183298347520 byte (32 TiB + 512 byte per il piè di pagina del disco rigido virtuale). Int

DiskSecurityProfile

Nome Descrizione Valore
secureVMDiskEncryptionSetId ResourceId del set di crittografia del disco associato a Confidential VM supported disk encrypted with customer managed key corda
securityType Specifica il Tipo di sicurezza della macchina virtuale. Applicabile solo per i dischi del sistema operativo. 'ConfidentialVM_DiskEncryptedWithCustomerKey'
'ConfidentialVM_DiskEncryptedWithPlatformKey'
'ConfidentialVM_NonPersistedTPM'
'ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey'
'TrustedLaunch'

Codifica

Nome Descrizione Valore
diskEncryptionSetId ResourceId del set di crittografia del disco da usare per abilitare la crittografia dei dati inattivi. corda
digitare Tipo di chiave utilizzata per crittografare i dati del disco. 'EncryptionAtRestWithCustomerKey'
'EncryptionAtRestWithPlatformAndCustomerKeys'
'EncryptionAtRestWithPlatformKey'

EncryptionSettingsCollection

Nome Descrizione Valore
Abilitato Impostare questo flag su true e specificare DiskEncryptionKey e keyEncryptionKey facoltativo per abilitare la crittografia. Impostare questo flag su false e rimuovere DiskEncryptionKey e KeyEncryptionKey per disabilitare la crittografia. Se EncryptionSettings è Null nell'oggetto richiesta, le impostazioni esistenti rimangono invariate. bool (obbligatorio)
encryptionSettings Raccolta di impostazioni di crittografia, una per ogni volume del disco. EncryptionSettingsElement[]
encryptionSettingsVersion Descrive il tipo di crittografia usato per i dischi. Dopo aver impostato questo campo, non può essere sovrascritto. '1.0' corrisponde a Crittografia dischi di Azure con l'app AAD.'1.1' corrisponde a Crittografia dischi di Azure. corda

EncryptionSettingsElement

Nome Descrizione Valore
diskEncryptionKey URL segreto dell'insieme di credenziali delle chiavi e ID dell'insieme di credenziali della chiave di crittografia del disco KeyVaultAndSecretReference
keyEncryptionKey URL della chiave dell'insieme di credenziali delle chiavi e ID dell'insieme di credenziali della chiave. KeyEncryptionKey è facoltativo e, se specificato, viene usato per annullare il wrapping della chiave di crittografia del disco. KeyVaultAndKeyReference

ExtendedLocation

Nome Descrizione Valore
nome Nome della posizione estesa. corda
digitare Tipo della posizione estesa. 'EdgeZone'

ImageDiskReference

Nome Descrizione Valore
communityGalleryImageId URI relativo contenente un riferimento all'immagine della raccolta di calcolo di Azure della community. corda
Id URI relativo contenente un repository di immagini della piattaforma, un'immagine utente o un riferimento all'immagine della raccolta di calcolo di Azure. corda
lun Se il disco viene creato dal disco dati di un'immagine, si tratta di un indice che indica quale dei dischi dati nell'immagine usare. Per i dischi del sistema operativo, questo campo è Null. Int
sharedGalleryImageId URI relativo contenente un riferimento diretto all'immagine della raccolta di calcolo di Azure condivisa. corda

KeyVaultAndKeyReference

Nome Descrizione Valore
keyUrl URL che punta a una chiave o a un segreto in KeyVault stringa (obbligatorio)
sourceVault ID risorsa dell'insieme di credenziali delle chiavi contenente la chiave o il segreto SourceVault (obbligatorio)

KeyVaultAndSecretReference

Nome Descrizione Valore
secretUrl URL che punta a una chiave o a un segreto in KeyVault stringa (obbligatorio)
sourceVault ID risorsa dell'insieme di credenziali delle chiavi contenente la chiave o il segreto SourceVault (obbligatorio)

Microsoft.Compute/snapshots

Nome Descrizione Valore
apiVersion Versione dell'API '2023-10-02'
extendedLocation Posizione estesa in cui verrà creato lo snapshot. Impossibile modificare la posizione estesa. ExtendedLocation
ubicazione Percorso risorsa stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà delle risorse snapshot. SnapshotProperties
Sku Nome sku degli snapshot. Può essere Standard_LRS, Premium_LRS o Standard_ZRS. Si tratta di un parametro facoltativo per lo snapshot incrementale e il comportamento predefinito è che lo SKU verrà impostato sullo stesso SKU dello snapshot precedente snapshotSku
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.Compute/snapshots'

PurchasePlan

Nome Descrizione Valore
nome ID del piano. stringa (obbligatorio)
prodotto Specifica il prodotto dell'immagine dal marketplace. Si tratta dello stesso valore di Offer nell'elemento imageReference. stringa (obbligatorio)
promotionCode Codice promozionale dell'offerta. corda
editore ID editore. stringa (obbligatorio)

ResourceTags

Nome Descrizione Valore

Proprietà snapshot

Nome Descrizione Valore
completionPercent Percentuale di completamento per la copia in background quando viene creata una risorsa tramite l'operazione CopyStart. Int
copyCompletionError Indica i dettagli dell'errore se la copia in background di una risorsa creata tramite l'operazione CopyStart ha esito negativo. CopyCompletionError
creationData Informazioni sull'origine del disco. Le informazioni creationData non possono essere modificate dopo la creazione del disco. CreationData (obbligatorio)
dataAccessAuthMode Requisiti di autenticazione aggiuntivi per l'esportazione o il caricamento in un disco o uno snapshot. 'AzureActiveDirectory'
'Nessuno'
diskAccessId ID ARM della risorsa DiskAccess per l'uso di endpoint privati su dischi. corda
diskSizeGB Se creationData.createOption è Vuoto, questo campo è obbligatorio e indica le dimensioni del disco da creare. Se questo campo è presente per gli aggiornamenti o la creazione con altre opzioni, indica un ridimensionamento. I ridimensionamenti sono consentiti solo se il disco non è collegato a una macchina virtuale in esecuzione e può aumentare solo le dimensioni del disco. Int
codifica La proprietà di crittografia può essere usata per crittografare i dati inattivi con chiavi gestite dal cliente o chiavi gestite dalla piattaforma. crittografia
encryptionSettingsCollection La raccolta di impostazioni di crittografia usata è Crittografia dischi di Azure, può contenere più impostazioni di crittografia per disco o snapshot. EncryptionSettingsCollection
hyperVGeneration Generazione dell'hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo. 'V1'
'V2'
incrementale Indica se uno snapshot è incrementale. Gli snapshot incrementali sullo stesso disco occupano meno spazio rispetto agli snapshot completi e possono essere diffati. Bool
networkAccessPolicy Criteri per l'accesso al disco tramite rete. 'AllowAll'
'AllowPrivate'
'DenyAll'
osType Tipo di sistema operativo. 'Linux'
'Windows'
publicNetworkAccess Criteri per controllare l'esportazione sul disco. 'Disabilitato'
'Enabled'
purchasePlan Informazioni sul piano di acquisto per l'immagine da cui è stato originariamente creato il disco di origine per lo snapshot. PurchasePlan
securityProfile Contiene le informazioni relative alla sicurezza per la risorsa. DiskSecurityProfile
supportedCapabilities Elenco delle funzionalità supportate per l'immagine da cui è stato originariamente creato il disco di origine dallo snapshot. supportedCapabilities
supportsHibernation Indica che il sistema operativo in uno snapshot supporta l'ibernazione. Bool

SnapshotSku

Nome Descrizione Valore
nome Nome sku. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

SourceVault

Nome Descrizione Valore
Id ID risorsa corda

SupportedCapabilities

Nome Descrizione Valore
acceleratedNetwork True se l'immagine da cui viene creato il disco del sistema operativo supporta la rete accelerata. Bool
architettura Architettura della CPU supportata da un disco del sistema operativo. 'Arm64'
'x64'
diskControllerTypes Controller del disco supportati da un disco del sistema operativo. Se impostato, può essere SCSI o SCSI, NVME o NVME, SCSI. corda

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa snapshot può essere distribuito con operazioni destinate a:

  • gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Compute/snapshots, aggiungere il file Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/snapshots@2023-10-02"
  name = "string"
  location = "string"
  sku = {
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      completionPercent = int
      copyCompletionError = {
        errorCode = "string"
        errorMessage = "string"
      }
      creationData = {
        createOption = "string"
        elasticSanResourceId = "string"
        galleryImageReference = {
          communityGalleryImageId = "string"
          id = "string"
          lun = int
          sharedGalleryImageId = "string"
        }
        imageReference = {
          communityGalleryImageId = "string"
          id = "string"
          lun = int
          sharedGalleryImageId = "string"
        }
        logicalSectorSize = int
        performancePlus = bool
        provisionedBandwidthCopySpeed = "string"
        securityDataUri = "string"
        sourceResourceId = "string"
        sourceUri = "string"
        storageAccountId = "string"
        uploadSizeBytes = int
      }
      dataAccessAuthMode = "string"
      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"
      publicNetworkAccess = "string"
      purchasePlan = {
        name = "string"
        product = "string"
        promotionCode = "string"
        publisher = "string"
      }
      securityProfile = {
        secureVMDiskEncryptionSetId = "string"
        securityType = "string"
      }
      supportedCapabilities = {
        acceleratedNetwork = bool
        architecture = "string"
        diskControllerTypes = "string"
      }
      supportsHibernation = bool
    }
  })
}

Valori delle proprietà

CopyCompletionError

Nome Descrizione Valore
errorCode Indica il codice di errore se la copia in background di una risorsa creata tramite l'operazione CopyStart ha esito negativo. 'CopySourceNotFound' (obbligatorio)
errorMessage Indica il messaggio di errore se la copia in background di una risorsa creata tramite l'operazione CopyStart ha esito negativo. stringa (obbligatorio)

CreationData

Nome Descrizione Valore
createOption In questo modo vengono enumerate le possibili origini della creazione di un disco. 'Attach'
'Copia'
'CopyFromSanSnapshot'
'CopyStart'
'Empty'
'FromImage'
'Import'
'ImportSecure'
'Restore'
'Carica'
'UploadPreparedSecure' (obbligatorio)
elasticSanResourceId Obbligatorio se createOption è CopyFromSanSnapshot. Si tratta dell'ID ARM dello snapshot del volume san elastico di origine. corda
galleryImageReference Obbligatorio se si crea da un'immagine della raccolta. Id/sharedGalleryImageId/communityGalleryImageId di ImageDiskReference sarà l'ID ARM della versione dell'immagine condivisa da cui creare un disco. ImageDiskReference
imageReference Informazioni sull'origine del disco per immagini PIR o utente. ImageDiskReference
logicalSectorSize Dimensioni del settore logico in byte per i dischi Ultra. I valori supportati sono 512 annunci 4096. 4096 è l'impostazione predefinita. Int
performancePlus Impostare questo flag su true per ottenere un aumento della destinazione delle prestazioni del disco distribuito, vedere qui nella rispettiva destinazione delle prestazioni. Questo flag può essere impostato solo in fase di creazione del disco e non può essere disabilitato dopo l'abilitazione. Bool
provisionedBandwidthCopySpeed Se questo campo è impostato su uno snapshot e createOption è CopyStart, lo snapshot verrà copiato con una velocità più rapida. 'Avanzato'
'Nessuno'
securityDataUri Se createOption è ImportSecure, si tratta dell'URI di un BLOB da importare nello stato guest della macchina virtuale. corda
sourceResourceId Se createOption è Copy, si tratta dell'ID ARM dello snapshot o del disco di origine. corda
sourceUri Se createOption è Import, si tratta dell'URI di un BLOB da importare in un disco gestito. corda
storageAccountId Obbligatorio se createOption è Import. Identificatore di Azure Resource Manager dell'account di archiviazione contenente il BLOB da importare come disco. corda
uploadSizeBytes Se createOption è Upload, si tratta delle dimensioni del contenuto del caricamento, incluso il piè di pagina del disco rigido virtuale. Questo valore deve essere compreso tra 20972032 (20 MiB + 512 byte per il piè di pagina del disco rigido virtuale) e 35183298347520 byte (32 TiB + 512 byte per il piè di pagina del disco rigido virtuale). Int

DiskSecurityProfile

Nome Descrizione Valore
secureVMDiskEncryptionSetId ResourceId del set di crittografia del disco associato a Confidential VM supported disk encrypted with customer managed key corda
securityType Specifica il Tipo di sicurezza della macchina virtuale. Applicabile solo per i dischi del sistema operativo. 'ConfidentialVM_DiskEncryptedWithCustomerKey'
'ConfidentialVM_DiskEncryptedWithPlatformKey'
'ConfidentialVM_NonPersistedTPM'
'ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey'
'TrustedLaunch'

Codifica

Nome Descrizione Valore
diskEncryptionSetId ResourceId del set di crittografia del disco da usare per abilitare la crittografia dei dati inattivi. corda
digitare Tipo di chiave utilizzata per crittografare i dati del disco. 'EncryptionAtRestWithCustomerKey'
'EncryptionAtRestWithPlatformAndCustomerKeys'
'EncryptionAtRestWithPlatformKey'

EncryptionSettingsCollection

Nome Descrizione Valore
Abilitato Impostare questo flag su true e specificare DiskEncryptionKey e keyEncryptionKey facoltativo per abilitare la crittografia. Impostare questo flag su false e rimuovere DiskEncryptionKey e KeyEncryptionKey per disabilitare la crittografia. Se EncryptionSettings è Null nell'oggetto richiesta, le impostazioni esistenti rimangono invariate. bool (obbligatorio)
encryptionSettings Raccolta di impostazioni di crittografia, una per ogni volume del disco. EncryptionSettingsElement[]
encryptionSettingsVersion Descrive il tipo di crittografia usato per i dischi. Dopo aver impostato questo campo, non può essere sovrascritto. '1.0' corrisponde a Crittografia dischi di Azure con l'app AAD.'1.1' corrisponde a Crittografia dischi di Azure. corda

EncryptionSettingsElement

Nome Descrizione Valore
diskEncryptionKey URL segreto dell'insieme di credenziali delle chiavi e ID dell'insieme di credenziali della chiave di crittografia del disco KeyVaultAndSecretReference
keyEncryptionKey URL della chiave dell'insieme di credenziali delle chiavi e ID dell'insieme di credenziali della chiave. KeyEncryptionKey è facoltativo e, se specificato, viene usato per annullare il wrapping della chiave di crittografia del disco. KeyVaultAndKeyReference

ExtendedLocation

Nome Descrizione Valore
nome Nome della posizione estesa. corda
digitare Tipo della posizione estesa. 'EdgeZone'

ImageDiskReference

Nome Descrizione Valore
communityGalleryImageId URI relativo contenente un riferimento all'immagine della raccolta di calcolo di Azure della community. corda
Id URI relativo contenente un repository di immagini della piattaforma, un'immagine utente o un riferimento all'immagine della raccolta di calcolo di Azure. corda
lun Se il disco viene creato dal disco dati di un'immagine, si tratta di un indice che indica quale dei dischi dati nell'immagine usare. Per i dischi del sistema operativo, questo campo è Null. Int
sharedGalleryImageId URI relativo contenente un riferimento diretto all'immagine della raccolta di calcolo di Azure condivisa. corda

KeyVaultAndKeyReference

Nome Descrizione Valore
keyUrl URL che punta a una chiave o a un segreto in KeyVault stringa (obbligatorio)
sourceVault ID risorsa dell'insieme di credenziali delle chiavi contenente la chiave o il segreto SourceVault (obbligatorio)

KeyVaultAndSecretReference

Nome Descrizione Valore
secretUrl URL che punta a una chiave o a un segreto in KeyVault stringa (obbligatorio)
sourceVault ID risorsa dell'insieme di credenziali delle chiavi contenente la chiave o il segreto SourceVault (obbligatorio)

Microsoft.Compute/snapshots

Nome Descrizione Valore
extendedLocation Posizione estesa in cui verrà creato lo snapshot. Impossibile modificare la posizione estesa. ExtendedLocation
ubicazione Percorso risorsa stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà delle risorse snapshot. SnapshotProperties
Sku Nome sku degli snapshot. Può essere Standard_LRS, Premium_LRS o Standard_ZRS. Si tratta di un parametro facoltativo per lo snapshot incrementale e il comportamento predefinito è che lo SKU verrà impostato sullo stesso SKU dello snapshot precedente snapshotSku
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.Compute/snapshots@2023-10-02"

PurchasePlan

Nome Descrizione Valore
nome ID del piano. stringa (obbligatorio)
prodotto Specifica il prodotto dell'immagine dal marketplace. Si tratta dello stesso valore di Offer nell'elemento imageReference. stringa (obbligatorio)
promotionCode Codice promozionale dell'offerta. corda
editore ID editore. stringa (obbligatorio)

ResourceTags

Nome Descrizione Valore

Proprietà snapshot

Nome Descrizione Valore
completionPercent Percentuale di completamento per la copia in background quando viene creata una risorsa tramite l'operazione CopyStart. Int
copyCompletionError Indica i dettagli dell'errore se la copia in background di una risorsa creata tramite l'operazione CopyStart ha esito negativo. CopyCompletionError
creationData Informazioni sull'origine del disco. Le informazioni creationData non possono essere modificate dopo la creazione del disco. CreationData (obbligatorio)
dataAccessAuthMode Requisiti di autenticazione aggiuntivi per l'esportazione o il caricamento in un disco o uno snapshot. 'AzureActiveDirectory'
'Nessuno'
diskAccessId ID ARM della risorsa DiskAccess per l'uso di endpoint privati su dischi. corda
diskSizeGB Se creationData.createOption è Vuoto, questo campo è obbligatorio e indica le dimensioni del disco da creare. Se questo campo è presente per gli aggiornamenti o la creazione con altre opzioni, indica un ridimensionamento. I ridimensionamenti sono consentiti solo se il disco non è collegato a una macchina virtuale in esecuzione e può aumentare solo le dimensioni del disco. Int
codifica La proprietà di crittografia può essere usata per crittografare i dati inattivi con chiavi gestite dal cliente o chiavi gestite dalla piattaforma. crittografia
encryptionSettingsCollection La raccolta di impostazioni di crittografia usata è Crittografia dischi di Azure, può contenere più impostazioni di crittografia per disco o snapshot. EncryptionSettingsCollection
hyperVGeneration Generazione dell'hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo. 'V1'
'V2'
incrementale Indica se uno snapshot è incrementale. Gli snapshot incrementali sullo stesso disco occupano meno spazio rispetto agli snapshot completi e possono essere diffati. Bool
networkAccessPolicy Criteri per l'accesso al disco tramite rete. 'AllowAll'
'AllowPrivate'
'DenyAll'
osType Tipo di sistema operativo. 'Linux'
'Windows'
publicNetworkAccess Criteri per controllare l'esportazione sul disco. 'Disabilitato'
'Enabled'
purchasePlan Informazioni sul piano di acquisto per l'immagine da cui è stato originariamente creato il disco di origine per lo snapshot. PurchasePlan
securityProfile Contiene le informazioni relative alla sicurezza per la risorsa. DiskSecurityProfile
supportedCapabilities Elenco delle funzionalità supportate per l'immagine da cui è stato originariamente creato il disco di origine dallo snapshot. supportedCapabilities
supportsHibernation Indica che il sistema operativo in uno snapshot supporta l'ibernazione. Bool

SnapshotSku

Nome Descrizione Valore
nome Nome sku. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

SourceVault

Nome Descrizione Valore
Id ID risorsa corda

SupportedCapabilities

Nome Descrizione Valore
acceleratedNetwork True se l'immagine da cui viene creato il disco del sistema operativo supporta la rete accelerata. Bool
architettura Architettura della CPU supportata da un disco del sistema operativo. 'Arm64'
'x64'
diskControllerTypes Controller del disco supportati da un disco del sistema operativo. Se impostato, può essere SCSI o SCSI, NVME o NVME, SCSI. corda