Snapshot Microsoft.Compute 2023-04-02
Definizione di risorsa Bicep
Il tipo di risorsa snapshot può essere distribuito con operazioni destinate a:
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-04-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'
elasticSanResourceId: 'string'
galleryImageReference: {
communityGalleryImageId: 'string'
id: 'string'
lun: int
sharedGalleryImageId: 'string'
}
imageReference: {
communityGalleryImageId: 'string'
id: 'string'
lun: int
sharedGalleryImageId: 'string'
}
logicalSectorSize: int
performancePlus: bool
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à
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' '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 |
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
SourceVault
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa | corda |
KeyVaultAndKeyReference
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' |
diskControllerTypes | Controller del disco supportati da un disco del sistema operativo. Se impostato, può essere SCSI o SCSI, NVME o NVME, SCSI. | corda |
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:
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-04-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",
"elasticSanResourceId": "string",
"galleryImageReference": {
"communityGalleryImageId": "string",
"id": "string",
"lun": "int",
"sharedGalleryImageId": "string"
},
"imageReference": {
"communityGalleryImageId": "string",
"id": "string",
"lun": "int",
"sharedGalleryImageId": "string"
},
"logicalSectorSize": "int",
"performancePlus": "bool",
"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à
Istantanee
Nome | Descrizione | Valore |
---|---|---|
digitare | Tipo di risorsa | 'Microsoft.Compute/snapshots' |
apiVersion | Versione dell'API della risorsa | '2023-04-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' '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 |
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
SourceVault
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa | corda |
KeyVaultAndKeyReference
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' |
diskControllerTypes | Controller del disco supportati da un disco del sistema operativo. Se impostato, può essere SCSI o SCSI, NVME o NVME, SCSI. | corda |
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@2023-04-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"
elasticSanResourceId = "string"
galleryImageReference = {
communityGalleryImageId = "string"
id = "string"
lun = int
sharedGalleryImageId = "string"
}
imageReference = {
communityGalleryImageId = "string"
id = "string"
lun = int
sharedGalleryImageId = "string"
}
logicalSectorSize = int
performancePlus = bool
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"
}
extendedLocation = {
name = "string"
type = "EdgeZone"
}
})
}
Valori delle proprietà
Istantanee
Nome | Descrizione | Valore |
---|---|---|
digitare | Tipo di risorsa | "Microsoft.Compute/snapshots@2023-04-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" "CopyFromSanSnapshot" "CopyStart" "Vuoto" "FromImage" "Importa" "ImportSecure" "Ripristina" "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 |
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
SourceVault
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa | corda |
KeyVaultAndKeyReference
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" |
diskControllerTypes | Controller del disco supportati da un disco del sistema operativo. Se impostato, può essere SCSI o SCSI, NVME o NVME, SCSI. | corda |
SnapshotSku
Nome | Descrizione | Valore |
---|---|---|
nome | Nome sku. | "Premium_LRS" "Standard_LRS" "Standard_ZRS" |