Snapshot Microsoft.Compute 2022-03-02

Articolo
08/17/2024

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@2022-03-02' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'string'
  }
  extendedLocation: {
    name: 'string'
    type: 'EdgeZone'
  }
  properties: {
    completionPercent: int
    copyCompletionError: {
      errorCode: 'CopySourceNotFound'
      errorMessage: 'string'
    }
    creationData: {
      createOption: 'string'
      galleryImageReference: {
        communityGalleryImageId: 'string'
        id: 'string'
        lun: int
        sharedGalleryImageId: 'string'
      }
      imageReference: {
        communityGalleryImageId: 'string'
        id: 'string'
        lun: int
        sharedGalleryImageId: 'string'
      }
      logicalSectorSize: int
      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'
    }
    supportsHibernation: bool
  }
}

Valori delle proprietà

Istantanee

Nome	Descrizione	Valore
nome	Nome della risorsa	stringa (obbligatorio) Limite di caratteri: 1-80 Caratteri validi: Caratteri alfanumerici, caratteri di sottolineatura, punti e trattini. Iniziare con alfanumerico. Termina con caratteri alfanumerici o caratteri di sottolineatura.
ubicazione	Percorso risorsa	stringa (obbligatorio)
Tag	Tag delle risorse	Dizionario di nomi e valori di tag. Vedere tag nei modelli
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
extendedLocation	Posizione estesa in cui verrà creato lo snapshot. Impossibile modificare la posizione estesa.	ExtendedLocation
proprietà	Proprietà delle risorse snapshot.	SnapshotProperties

ExtendedLocation

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

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.	encryption
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

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' 'CopyStart' 'Empty' 'FromImage' 'Import' 'ImportSecure' 'Restore' 'Carica' 'UploadPreparedSecure' (obbligatorio)
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
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

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

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

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)

SourceVault

Nome	Descrizione	Valore
Id	ID risorsa	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)

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)

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_VMGuestStateOnlyEncryptedWithPlatformKey' 'TrustedLaunch'

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'

SnapshotSku

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

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": "2022-03-02",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "string"
  },
  "extendedLocation": {
    "name": "string",
    "type": "EdgeZone"
  },
  "properties": {
    "completionPercent": "int",
    "copyCompletionError": {
      "errorCode": "CopySourceNotFound",
      "errorMessage": "string"
    },
    "creationData": {
      "createOption": "string",
      "galleryImageReference": {
        "communityGalleryImageId": "string",
        "id": "string",
        "lun": "int",
        "sharedGalleryImageId": "string"
      },
      "imageReference": {
        "communityGalleryImageId": "string",
        "id": "string",
        "lun": "int",
        "sharedGalleryImageId": "string"
      },
      "logicalSectorSize": "int",
      "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"
    },
    "supportsHibernation": "bool"
  }
}

Valori delle proprietà

Istantanee

Nome	Descrizione	Valore
digitare	Tipo di risorsa	'Microsoft.Compute/snapshots'
apiVersion	Versione dell'API della risorsa	'2022-03-02'
nome	Nome della risorsa	stringa (obbligatorio) Limite di caratteri: 1-80 Caratteri validi: Caratteri alfanumerici, caratteri di sottolineatura, punti e trattini. Iniziare con alfanumerico. Termina con caratteri alfanumerici o caratteri di sottolineatura.
ubicazione	Percorso risorsa	stringa (obbligatorio)
Tag	Tag delle risorse	Dizionario di nomi e valori di tag. Vedere tag nei modelli
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
extendedLocation	Posizione estesa in cui verrà creato lo snapshot. Impossibile modificare la posizione estesa.	ExtendedLocation
proprietà	Proprietà delle risorse snapshot.	SnapshotProperties

ExtendedLocation

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

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.	encryption
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

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' 'CopyStart' 'Empty' 'FromImage' 'Import' 'ImportSecure' 'Restore' 'Carica' 'UploadPreparedSecure' (obbligatorio)
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
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

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

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

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)

SourceVault

Nome	Descrizione	Valore
Id	ID risorsa	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)

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)

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_VMGuestStateOnlyEncryptedWithPlatformKey' 'TrustedLaunch'

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'

SnapshotSku

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

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@2022-03-02"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      completionPercent = int
      copyCompletionError = {
        errorCode = "CopySourceNotFound"
        errorMessage = "string"
      }
      creationData = {
        createOption = "string"
        galleryImageReference = {
          communityGalleryImageId = "string"
          id = "string"
          lun = int
          sharedGalleryImageId = "string"
        }
        imageReference = {
          communityGalleryImageId = "string"
          id = "string"
          lun = int
          sharedGalleryImageId = "string"
        }
        logicalSectorSize = int
        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"
      }
      supportsHibernation = bool
    }
    sku = {
      name = "string"
    }
    extendedLocation = {
      name = "string"
      type = "EdgeZone"
    }
  })
}

Valori delle proprietà

Istantanee

Nome	Descrizione	Valore
digitare	Tipo di risorsa	"Microsoft.Compute/snapshots@2022-03-02"
nome	Nome della risorsa	stringa (obbligatorio) Limite di caratteri: 1-80 Caratteri validi: Caratteri alfanumerici, caratteri di sottolineatura, punti e trattini. Iniziare con alfanumerico. Termina con caratteri alfanumerici o caratteri di sottolineatura.
ubicazione	Percorso risorsa	stringa (obbligatorio)
parent_id	Per eseguire la distribuzione in un gruppo di risorse, usare l'ID del gruppo di risorse.	stringa (obbligatorio)
Tag	Tag delle risorse	Dizionario di nomi e valori di tag.
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
extendedLocation	Posizione estesa in cui verrà creato lo snapshot. Impossibile modificare la posizione estesa.	ExtendedLocation
proprietà	Proprietà delle risorse snapshot.	SnapshotProperties

ExtendedLocation

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

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.	encryption
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" "Abilitato"
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

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" "CopyStart" "Vuoto" "FromImage" "Importa" "ImportSecure" "Ripristina" "Carica" "UploadPreparedSecure" (obbligatorio)
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
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

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

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

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)

SourceVault

Nome	Descrizione	Valore
Id	ID risorsa	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)

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)

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_VMGuestStateOnlyEncryptedWithPlatformKey" "TrustedLaunch"

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"

SnapshotSku

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

Condividi tramite

Snapshot Microsoft.Compute 2022-03-02

Definizione di risorsa Bicep

Formato risorsa

Valori delle proprietà

Istantanee

ExtendedLocation

Proprietà snapshot

CopyCompletionError

CreationData

ImageDiskReference

Codifica

EncryptionSettingsCollection

EncryptionSettingsElement

KeyVaultAndSecretReference

SourceVault

KeyVaultAndKeyReference

PurchasePlan

DiskSecurityProfile

SupportedCapabilities

SnapshotSku

Definizione di risorsa del modello di Resource Manager

Formato risorsa

Valori delle proprietà

Istantanee

ExtendedLocation

Proprietà snapshot

CopyCompletionError

CreationData

ImageDiskReference

Codifica

EncryptionSettingsCollection

EncryptionSettingsElement

KeyVaultAndSecretReference

SourceVault

KeyVaultAndKeyReference

PurchasePlan

DiskSecurityProfile

SupportedCapabilities

SnapshotSku

Definizione di risorsa Terraform (provider AzAPI)

Formato risorsa

Valori delle proprietà

Istantanee

ExtendedLocation

Proprietà snapshot

CopyCompletionError

CreationData

ImageDiskReference

Codifica

EncryptionSettingsCollection

EncryptionSettingsElement

KeyVaultAndSecretReference

SourceVault

KeyVaultAndKeyReference

PurchasePlan

DiskSecurityProfile

SupportedCapabilities

SnapshotSku

Commenti e suggerimenti

Risorse aggiuntive