Sdílet prostřednictvím


Snímky Microsoft.Compute z 2. 7. 2022

Definice prostředku Bicep

Typ prostředku snímků je možné nasadit s operacemi, které cílí na:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Compute/snapshots, přidejte do šablony následující bicep.

resource symbolicname 'Microsoft.Compute/snapshots@2022-07-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
      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
  }
}

Hodnoty vlastností

snímky

Název Description Hodnota
name Název prostředku string (povinné)

Omezení počtu znaků: 1–80

Platné znaky:
Alfanumerické znaky, podtržítka, tečky a spojovníky

Začněte alfanumerickými znaky. Končí alfanumerickými znaky nebo podtržítkem.
location Umístění prostředku string (povinné)
tags Značky prostředků Slovník názvů a hodnot značek. Zobrazit značky v šablonách
Sku Název skladové položky snímků Může být Standard_LRS, Premium_LRS nebo Standard_ZRS. Jedná se o volitelný parametr pro přírůstkové snímky a výchozí chování je, že skladová položka se nastaví na stejnou skladovou položku jako předchozí snímek. SnapshotSku
extendedLocation Rozšířené umístění, kde se snímek vytvoří. Rozšířené umístění nelze změnit. ExtendedLocation
properties Vlastnosti prostředku snímku. Vlastnosti snímku

ExtendedLocation

Název Description Hodnota
name Název rozšířeného umístění. řetězec
typ Typ rozšířeného umístění. EdgeZone

Vlastnosti snímku

Název Description Hodnota
completionPercent Procento dokončení kopie na pozadí při vytvoření prostředku prostřednictvím operace CopyStart int
copyCompletionError Označuje podrobnosti o chybě, pokud selže kopie prostředku vytvořeného prostřednictvím operace CopyStart na pozadí. CopyCompletionError
creationData Informace o zdroji disku. Informace CreationData nelze po vytvoření disku změnit. CreationData (povinné)
dataAccessAuthMode Další požadavky na ověřování při exportu nebo nahrávání na disk nebo snímek AzureActiveDirectory
'Žádný'
diskAccessId ID ARM prostředku DiskAccess pro použití privátních koncových bodů na discích řetězec
diskSizeGB Pokud je vlastnost creationData.createOption prázdná, je toto pole povinné a označuje velikost disku, který se má vytvořit. Pokud je toto pole k dispozici pro aktualizace nebo vytvoření s jinými možnostmi, označuje změnu velikosti. Změna velikosti je povolená jenom v případě, že disk není připojený k běžícímu virtuálnímu počítači, a může pouze zvětšit velikost disku. int
šifrování Vlastnost šifrování je možné použít k šifrování neaktivních uložených dat pomocí klíčů spravovaných zákazníkem nebo klíčů spravovaných platformou. Šifrování
encryptionSettingsCollection Kolekce nastavení šifrování, která se používá jako Azure Disk Encryption, může obsahovat více nastavení šifrování na disk nebo snímek. EncryptionSettingsCollection
hyperVGeneration Generace hypervisoru virtuálního počítače. Platí jenom pro disky s operačním systémem. 'V1'
'V2'
Přírůstkové Určuje, jestli je snímek přírůstkový. Přírůstkové snímky na stejném disku zabírají méně místa než úplné snímky a můžou být rozdílné. bool
networkAccessPolicy Zásady pro přístup k disku přes síť 'AllowAll'
AllowPrivate
'DenyAll'
typ operačního systému Typ operačního systému. 'Linux'
'Windows'
publicNetworkAccess Zásady pro řízení exportu na disku Zakázáno
Povoleno
purchasePlan Informace o plánu nákupu pro image, ze které byl zdrojový disk pro snímek původně vytvořen. PurchasePlan
profil zabezpečení Obsahuje informace týkající se zabezpečení prostředku. DiskSecurityProfile
supportedCapabilities Seznam podporovaných funkcí pro image, ze které byl zdrojový disk ze snímku původně vytvořen. Podporovanécapabilities
supportsHibernation Označuje, že operační systém na snímku podporuje hibernaci. bool

CopyCompletionError

Název Description Hodnota
Errorcode Označuje kód chyby, pokud selže kopie prostředku vytvořeného prostřednictvím operace CopyStart na pozadí. CopySourceNotFound (povinné)
Errormessage Označuje chybovou zprávu, pokud selže kopie prostředku vytvořeného prostřednictvím operace CopyStart na pozadí. string (povinné)

CreationData

Název Description Hodnota
createOption Tím se vytvoří výčet možných zdrojů vytvoření disku. "Připojit"
'Kopírovat'
'CopyStart'
"Prázdné"
'FromImage'
'Importovat'
'ImportSecure'
Obnovit
'Nahrát'
UploadPreparedSecure (povinné)
galleryImageReference Vyžaduje se při vytváření z obrázku v galerii. Id/sharedGalleryImageId/communityGalleryImageId imageDiskReference bude ID ARM verze sdílené image galerie, ze které se má vytvořit disk. ImageDiskReference
imageReference Informace o zdroji disků pro PIR nebo uživatelské image. ImageDiskReference
logicalSectorSize Velikost logického sektoru v bajtech pro disky úrovně Ultra Podporované hodnoty jsou 512 a 4096. Výchozí je 4096. int
performancePlus Pokud chcete zvýšit výkonový cíl nasazeného disku, nastavte tento příznak na hodnotu true. Informace o příslušném cíli výkonu najdete tady. Tento příznak lze nastavit pouze při vytváření disku a po jeho povolení jej nelze zakázat. bool
identifikátor securityDataUri Pokud má createOption hodnotu ImportSecure, jedná se o identifikátor URI objektu blob, který se má importovat do stavu hosta virtuálního počítače. řetězec
sourceResourceId Pokud createOption je Copy, jedná se o ID ARM zdrojového snímku nebo disku. řetězec
Sourceuri Pokud je createOption hodnota Import, jedná se o identifikátor URI objektu blob, který se má importovat na spravovaný disk. řetězec
storageAccountId Vyžaduje se, pokud createOption je Import. Azure Resource Manager identifikátor účtu úložiště obsahujícího objekt blob, který se má importovat jako disk. řetězec
uploadSizeBytes Pokud je createOption nahrání, jedná se o velikost obsahu nahrávání včetně zápatí virtuálního pevného disku. Tato hodnota by měla být mezi 20972032 (20 MiB + 512 bajtů pro zápatí virtuálního pevného disku) a 35183298347520 bajty (32 TiB + 512 bajtů pro zápatí virtuálního pevného disku). int

ImageDiskReference

Název Description Hodnota
communityGalleryImageId Relativní identifikátor URI obsahující komunitní odkaz na image Azure Compute Gallery. řetězec
id Relativní identifikátor URI obsahující úložiště imagí platformy, uživatelskou image nebo odkaz na image Azure Compute Gallery. řetězec
Lun Pokud je disk vytvořen z datového disku image, jedná se o index, který určuje, který z datových disků v imagi se má použít. Pro disky s operačním systémem má toto pole hodnotu null. int
sharedGalleryImageId Relativní identifikátor URI obsahující přímý odkaz na sdílenou image Azure Compute Gallery. řetězec

Šifrování

Název Description Hodnota
diskEncryptionSetId ResourceId šifrování disku nastaveného pro povolení šifrování neaktivních uložených dat. řetězec
typ Typ klíče, který se používá k šifrování dat na disku. 'EncryptionAtRestWithCustomerKey'
EncryptionAtRestWithPlatformAndCustomerKeys
EncryptionAtRestWithPlatformKey

EncryptionSettingsCollection

Název Description Hodnota
enabled Pokud chcete povolit šifrování, nastavte tento příznak na true a zadejte DiskEncryptionKey a volitelný klíč KeyEncryptionKey. Nastavte tento příznak na false a odeberte DiskEncryptionKey a KeyEncryptionKey, aby se šifrování zakázalo. Pokud má encryptionSettings v objektu požadavku hodnotu null, stávající nastavení zůstanou beze změny. bool (povinné)
encryptionSettings Kolekce nastavení šifrování, jedno pro každý diskový svazek. EncryptionSettingsElement[]
encryptionSettingsVersion Popisuje, jaký typ šifrování se používá pro disky. Jakmile je toto pole nastavené, nelze ho přepsat. Verze 1.0 odpovídá Službě Azure Disk Encryption s aplikací AAD.'1.1' odpovídá službě Azure Disk Encryption. řetězec

EncryptionSettingsElement

Název Description Hodnota
diskEncryptionKey Key Vault adresu URL tajného kódu a ID trezoru šifrovacího klíče disku KeyVaultAndSecretReference
keyEncryptionKey Key Vault adresu URL klíče a ID trezoru šifrovacího klíče klíče. Klíč KeyEncryptionKey je volitelný a pokud je zadaný, použije se k rozbalení šifrovacího klíče disku. KeyVaultAndKeyReference

KeyVaultAndSecretReference

Název Description Hodnota
secretUrl Adresa URL odkazující na klíč nebo tajný kód ve službě KeyVault string (povinné)
sourceVault ID prostředku služby KeyVault obsahující klíč nebo tajný klíč SourceVault (povinné)

SourceVault

Název Description Hodnota
id ID prostředku řetězec

KeyVaultAndKeyReference

Název Description Hodnota
keyUrl Adresa URL odkazující na klíč nebo tajný kód ve službě KeyVault string (povinné)
sourceVault ID prostředku služby KeyVault obsahující klíč nebo tajný klíč SourceVault (povinné)

Plán nákupu

Název Description Hodnota
name ID plánu. string (povinné)
product Určuje součin obrázku z marketplace. To je stejná hodnota jako Nabídka v elementu imageReference. string (povinné)
promotionCode Kód propagační nabídky. řetězec
vydavatel ID vydavatele. string (povinné)

DiskSecurityProfile

Název Description Hodnota
secureVMDiskEncryptionSetId ResourceId sady šifrování disků přidružené k disku s podporou důvěrného virtuálního počítače šifrovaného pomocí klíče spravovaného zákazníkem řetězec
securityType Určuje Typ zabezpečení virtuálního počítače. Platí jenom pro disky s operačním systémem. "ConfidentialVM_DiskEncryptedWithCustomerKey"
"ConfidentialVM_DiskEncryptedWithPlatformKey"
'ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey'
'TrustedLaunch'

Podporovanécapabilities

Název Description Hodnota
acceleratedNetwork Hodnota True, pokud image, ze které je vytvořen disk s operačním systémem, podporuje akcelerované síťové služby. bool
Architektura Architektura procesoru podporovaná diskem s operačním systémem Arm64
'x64'
diskControllerTypes Řadiče disků, které podporuje disk s operačním systémem. Pokud je nastavená, může to být SCSI nebo SCSI, NVME nebo NVME, SCSI. řetězec

SnapshotSku

Název Description Hodnota
name Název skladové položky. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

Definice prostředku šablony ARM

Typ prostředku snímků je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Compute/snapshots, přidejte do šablony následující kód JSON.

{
  "type": "Microsoft.Compute/snapshots",
  "apiVersion": "2022-07-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",
      "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"
  }
}

Hodnoty vlastností

snímky

Název Description Hodnota
typ Typ prostředku Microsoft.Compute/snapshots
apiVersion Verze rozhraní API prostředků '2022-07-02'
name Název prostředku string (povinné)

Limit počtu znaků: 1–80

Platné znaky:
Alfanumerické znaky, podtržítka, tečky a spojovníky.

Začněte alfanumerickým kódem. Na konci je alfanumerické nebo podtržítko.
location Umístění prostředku string (povinné)
tags Značky prostředků Slovník názvů značek a hodnot. Viz Značky v šablonách
Sku Název skladové položky snímků Může být Standard_LRS, Premium_LRS nebo Standard_ZRS. Toto je volitelný parametr pro přírůstkový snímek a výchozí chování je, že skladová položka se nastaví na stejnou skladovou položku jako předchozí snímek. SnapshotSku
extendedLocation Rozšířené umístění, ve kterém se snímek vytvoří. Rozšířené umístění nelze změnit. ExtendedLocation
properties Vlastnosti prostředku snímku. Vlastnosti snímků

ExtendedLocation

Název Description Hodnota
name Název rozšířeného umístění. řetězec
typ Typ rozšířeného umístění. EdgeZone

Vlastnosti snímků

Název Description Hodnota
completionPercent Procento dokončení kopie na pozadí při vytvoření prostředku prostřednictvím operace CopyStart int
copyCompletionError Označuje podrobnosti o chybě, pokud kopie prostředku vytvořeného na pozadí prostřednictvím operace CopyStart selže. CopyCompletionError
creationData Informace o zdroji disku. Informace CreationData nelze po vytvoření disku změnit. CreationData (povinné)
dataAccessAuthMode Další požadavky na ověřování při exportu nebo nahrávání na disk nebo snímek AzureActiveDirectory
'Žádný'
diskAccessId ID ARM prostředku DiskAccess pro použití privátních koncových bodů na discích řetězec
diskSizeGB Pokud je vlastnost creationData.createOption prázdná, je toto pole povinné a označuje velikost disku, který se má vytvořit. Pokud je toto pole k dispozici pro aktualizace nebo vytvoření s jinými možnostmi, označuje změnu velikosti. Změna velikosti je povolená jenom v případě, že disk není připojený k běžícímu virtuálnímu počítači, a může pouze zvětšit velikost disku. int
šifrování Vlastnost šifrování je možné použít k šifrování neaktivních uložených dat pomocí klíčů spravovaných zákazníkem nebo klíčů spravovaných platformou. Šifrování
encryptionSettingsCollection Kolekce nastavení šifrování, která se používá jako Azure Disk Encryption, může obsahovat více nastavení šifrování na disk nebo snímek. EncryptionSettingsCollection
hyperVGeneration Generace hypervisoru virtuálního počítače. Platí jenom pro disky s operačním systémem. 'V1'
'V2'
Přírůstkové Určuje, jestli je snímek přírůstkový. Přírůstkové snímky na stejném disku zabírají méně místa než úplné snímky a můžou být rozdílné. bool
networkAccessPolicy Zásady pro přístup k disku přes síť 'AllowAll'
AllowPrivate
'DenyAll'
typ operačního systému Typ operačního systému. 'Linux'
'Windows'
publicNetworkAccess Zásady pro řízení exportu na disku Zakázáno
Povoleno
purchasePlan Informace o plánu nákupu pro image, ze které byl zdrojový disk pro snímek původně vytvořen. PurchasePlan
profil zabezpečení Obsahuje informace týkající se zabezpečení prostředku. DiskSecurityProfile
supportedCapabilities Seznam podporovaných funkcí pro image, ze které byl zdrojový disk ze snímku původně vytvořen. Podporovanécapabilities
supportsHibernation Označuje, že operační systém na snímku podporuje hibernaci. bool

CopyCompletionError

Název Description Hodnota
Errorcode Označuje kód chyby, pokud selže kopie prostředku vytvořeného prostřednictvím operace CopyStart na pozadí. CopySourceNotFound (povinné)
Errormessage Označuje chybovou zprávu, pokud selže kopie prostředku vytvořeného prostřednictvím operace CopyStart na pozadí. string (povinné)

CreationData

Název Description Hodnota
createOption Tím se vytvoří výčet možných zdrojů vytvoření disku. "Připojit"
'Kopírovat'
'CopyStart'
"Prázdné"
'FromImage'
'Importovat'
'ImportSecure'
Obnovit
'Nahrát'
UploadPreparedSecure (povinné)
galleryImageReference Vyžaduje se při vytváření z obrázku v galerii. Id/sharedGalleryImageId/communityGalleryImageId imageDiskReference bude ID ARM verze sdílené image galerie, ze které se má vytvořit disk. ImageDiskReference
imageReference Informace o zdroji disků pro PIR nebo uživatelské image. ImageDiskReference
logicalSectorSize Velikost logického sektoru v bajtech pro disky úrovně Ultra Podporované hodnoty jsou 512 a 4096. Výchozí je 4096. int
performancePlus Pokud chcete zvýšit výkonový cíl nasazeného disku, nastavte tento příznak na hodnotu true. Informace o příslušném cíli výkonu najdete tady. Tento příznak lze nastavit pouze při vytváření disku a po jeho povolení jej nelze zakázat. bool
identifikátor securityDataUri Pokud má createOption hodnotu ImportSecure, jedná se o identifikátor URI objektu blob, který se má importovat do stavu hosta virtuálního počítače. řetězec
sourceResourceId Pokud createOption je Copy, jedná se o ID ARM zdrojového snímku nebo disku. řetězec
Sourceuri Pokud je createOption hodnota Import, jedná se o identifikátor URI objektu blob, který se má importovat na spravovaný disk. řetězec
storageAccountId Vyžaduje se, pokud createOption je Import. Azure Resource Manager identifikátor účtu úložiště obsahujícího objekt blob, který se má importovat jako disk. řetězec
uploadSizeBytes Pokud je createOption nahrání, jedná se o velikost obsahu nahrávání včetně zápatí virtuálního pevného disku. Tato hodnota by měla být mezi 20972032 (20 MiB + 512 bajtů pro zápatí virtuálního pevného disku) a 35183298347520 bajty (32 TiB + 512 bajtů pro zápatí virtuálního pevného disku). int

ImageDiskReference

Název Description Hodnota
communityGalleryImageId Relativní identifikátor URI obsahující komunitní odkaz na image Azure Compute Gallery. řetězec
id Relativní identifikátor URI obsahující úložiště imagí platformy, uživatelskou image nebo odkaz na image Azure Compute Gallery. řetězec
Lun Pokud je disk vytvořen z datového disku image, jedná se o index, který určuje, který z datových disků v imagi se má použít. Pro disky s operačním systémem má toto pole hodnotu null. int
sharedGalleryImageId Relativní identifikátor URI obsahující přímý odkaz na sdílenou image Azure Compute Gallery. řetězec

Šifrování

Název Description Hodnota
diskEncryptionSetId ResourceId šifrování disku nastaveného k povolení šifrování neaktivních uložených dat. řetězec
typ Typ klíče, který se používá k šifrování dat na disku. EncryptionAtRestWithCustomerKey
EncryptionAtRestWithPlatformAndCustomerKeys
'EncryptionAtRestWithPlatformKey'

EncryptionSettingsCollection

Název Description Hodnota
enabled Nastavte tento příznak na true a zadejte DiskEncryptionKey a volitelně KeyEncryptionKey pro povolení šifrování. Nastavte tento příznak na false a odebráním disků DiskEncryptionKey a KeyEncryptionKey šifrování zakážete. Pokud má parametr EncryptionSettings v objektu požadavku hodnotu null, stávající nastavení se nezmění. bool (povinné)
nastavení šifrování Kolekce nastavení šifrování, jedno pro každý diskový svazek. EncryptionSettingsElement[]
encryptionSettingsVersion Popisuje, jaký typ šifrování se pro disky používá. Jakmile je toto pole nastaveno, nelze jej přepsat. 1.0 odpovídá službě Azure Disk Encryption s aplikací AAD. 1.1 odpovídá službě Azure Disk Encryption. řetězec

EncryptionSettingsElement

Název Description Hodnota
diskEncryptionKey Key Vault adresu URL tajného kódu a ID trezoru šifrovacího klíče disku KeyVaultAndSecretReference
klíč_klíč_kryptografie Key Vault adresu URL klíče a ID trezoru šifrovacího klíče klíče. Klíč KeyEncryptionKey je volitelný a pokud je zadaný, použije se k rozbalení šifrovacího klíče disku. KeyVaultAndKeyReference

KeyVaultAndSecretReference

Název Description Hodnota
adresa URL tajného kódu Adresa URL odkazující na klíč nebo tajný klíč ve službě Key Vault string (povinné)
sourceVault ID prostředku služby Key Vault obsahující klíč nebo tajný klíč SourceVault (povinné)

SourceVault

Název Description Hodnota
id ID prostředku řetězec

KeyVaultAndKeyReference

Název Description Hodnota
keyUrl Adresa URL odkazující na klíč nebo tajný klíč ve službě Key Vault string (povinné)
sourceVault ID prostředku služby Key Vault obsahující klíč nebo tajný klíč SourceVault (povinné)

PurchasePlan

Název Description Hodnota
name ID plánu string (povinné)
product Určuje produkt image z marketplace. Jedná se o stejnou hodnotu jako u prvku Offer v elementu imageReference. string (povinné)
promotionCode Propagační kód nabídky. řetězec
vydavatel ID vydavatele. string (povinné)

DiskSecurityProfile

Název Description Hodnota
secureVMDiskEncryptionSetId ResourceId sady pro šifrování disků přidružené k podporovanému disku důvěrného virtuálního počítače šifrovaného pomocí klíče spravovaného zákazníkem řetězec
typ zabezpečení Určuje SecurityType virtuálního počítače. Platí jenom pro disky s operačním systémem. "ConfidentialVM_DiskEncryptedWithCustomerKey"
"ConfidentialVM_DiskEncryptedWithPlatformKey"
"ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey"
TrustedLaunch

Podporovanécapabilities

Název Description Hodnota
akcelerovaná síť Hodnota True, pokud image, ze které je disk s operačním systémem vytvořen, podporuje akcelerované síťové služby. bool
Architektura Architektura procesoru podporovaná diskem s operačním systémem 'Arm64'
'x64'
diskControllerTypes Řadiče disku, které podporuje disk s operačním systémem. Pokud je nastavená, může to být SCSI nebo SCSI, NVME nebo NVME, SCSI. řetězec

SnapshotSku

Název Description Hodnota
name Název skladové položky. 'Premium_LRS'
"Standard_LRS"
"Standard_ZRS"

Definice prostředku Terraform (poskytovatel AzAPI)

Typ prostředku snímků je možné nasadit s operacemi, které cílí na:

  • Skupiny prostředků

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Compute/snapshots, přidejte do šablony následující Terraform.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/snapshots@2022-07-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
        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"
    }
  })
}

Hodnoty vlastností

snímky

Název Description Hodnota
typ Typ prostředku Microsoft.Compute/snapshots@2022-07-02
name Název prostředku string (povinné)

Omezení počtu znaků: 1–80

Platné znaky:
Alfanumerické znaky, podtržítka, tečky a spojovníky

Začněte alfanumerickými znaky. Končí alfanumerickými znaky nebo podtržítkem.
location Umístění prostředku string (povinné)
parent_id K nasazení do skupiny prostředků použijte ID této skupiny prostředků. string (povinné)
tags Značky prostředků Slovník názvů a hodnot značek.
Sku Název skladové položky snímků Může být Standard_LRS, Premium_LRS nebo Standard_ZRS. Jedná se o volitelný parametr pro přírůstkové snímky a výchozí chování je, že skladová položka se nastaví na stejnou skladovou položku jako předchozí snímek. SnapshotSku
extendedLocation Rozšířené umístění, kde se snímek vytvoří. Rozšířené umístění nelze změnit. ExtendedLocation
properties Vlastnosti prostředku snímku. Vlastnosti snímku

ExtendedLocation

Název Description Hodnota
name Název rozšířeného umístění. řetězec
typ Typ rozšířeného umístění. "EdgeZone"

Vlastnosti snímku

Název Description Hodnota
completionPercent Procento dokončení kopie na pozadí při vytvoření prostředku prostřednictvím operace CopyStart int
copyCompletionError Označuje podrobnosti o chybě, pokud kopie prostředku vytvořeného na pozadí prostřednictvím operace CopyStart selže. CopyCompletionError
creationData Informace o zdroji disku. Informace CreationData nelze po vytvoření disku změnit. CreationData (povinné)
dataAccessAuthMode Další požadavky na ověřování při exportu nebo nahrávání na disk nebo snímek "AzureActiveDirectory"
"Žádné"
diskAccessId ID ARM prostředku DiskAccess pro použití privátních koncových bodů na discích řetězec
diskSizeGB Pokud je createData.createOption prázdný, je toto pole povinné a označuje velikost disku, který se má vytvořit. Pokud je toto pole k dispozici pro aktualizace nebo vytvoření s jinými možnostmi, znamená to změnu velikosti. Změna velikosti je povolená jenom v případě, že disk není připojený ke spuštěnému virtuálnímu počítači a může pouze zvětšit velikost disku. int
šifrování Vlastnost šifrování je možné použít k šifrování neaktivních uložených dat pomocí klíčů spravovaných zákazníkem nebo klíčů spravovaných platformou. Šifrování
encryptionSettingsCollection Kolekce nastavení šifrování, která se používá jako Azure Disk Encryption, může obsahovat několik nastavení šifrování na disk nebo snímek. EncryptionSettingsCollection
hyperVGeneration Generování hypervisoru virtuálního počítače. Platí jenom pro disky s operačním systémem. "V1"
"V2"
Přírůstkové Jestli je snímek přírůstkový. Přírůstkové snímky na stejném disku zabírají méně místa než úplné snímky a můžou být rozdílné. bool
networkAccessPolicy Zásady pro přístup k disku přes síť "AllowAll"
"AllowPrivate"
"DenyAll"
osType Typ operačního systému. "Linux"
"Windows"
publicNetworkAccess Zásady pro řízení exportu na disku "Zakázáno"
"Povoleno"
purchasePlan Informace o plánu nákupu pro image, ze které byl původně vytvořen zdrojový disk pro snímek. Plán nákupu
securityProfile Obsahuje informace týkající se zabezpečení pro prostředek. DiskSecurityProfile
supportedCapabilities Seznam podporovaných funkcí pro image, ze které byl zdrojový disk ze snímku původně vytvořen. Podporovanécapabilities
supportsHibernace Označuje, že operační systém na snímku podporuje hibernaci. bool

CopyCompletionError

Název Description Hodnota
Errorcode Označuje kód chyby, pokud se nezdaří kopie prostředku vytvořeného na pozadí prostřednictvím operace CopyStart. "CopySourceNotFound" (povinné)
Errormessage Označuje chybovou zprávu, pokud kopie prostředku vytvořeného na pozadí prostřednictvím operace CopyStart selže. string (povinné)

CreationData

Název Description Hodnota
createOption Tím se vyčíslí možné zdroje vytvoření disku. "Připojit"
"Kopírovat"
"CopyStart"
"Prázdné"
"FromImage"
"Importovat"
"ImportSecure"
"Obnovit"
"Upload" (Nahrát)
UploadPreparedSecure (povinné)
galleryImageReference Vyžaduje se při vytváření z obrázku v galerii. Id/sharedGalleryImageId/communityGalleryImageId ImageDiskReference bude ID ARM verze image sdílené galerie, ze které se má vytvořit disk. ImageDiskReference
imageReference Informace o zdroji disku pro pir nebo uživatelské image. ImageDiskReference
logicalSectorSize Velikost logického sektoru v bajtech pro disky Úrovně Ultra Podporované hodnoty jsou 512 ad 4096. Výchozí hodnota je 4096. int
performancePlus Pokud chcete zvýšit výkonový cíl nasazeného disku, nastavte tento příznak na hodnotu true. Informace o příslušném cíli výkonu najdete tady. Tento příznak lze nastavit pouze při vytváření disku a po povolení jej nelze zakázat. bool
securityDataUri Pokud je createOption ImportSecure, jedná se o identifikátor URI objektu blob, který se má importovat do stavu hosta virtuálního počítače. řetězec
sourceResourceId Pokud je createOption copy, jedná se o ID ARM zdrojového snímku nebo disku. řetězec
Sourceuri Pokud je createOption Import, jedná se o identifikátor URI objektu blob, který se má importovat do spravovaného disku. řetězec
storageAccountId Vyžaduje se, pokud je createOption import. Azure Resource Manager identifikátor účtu úložiště obsahující objekt blob, který se má importovat jako disk. řetězec
uploadSizeBytes Pokud je možnost createOption nahrání, jedná se o velikost obsahu nahrávání včetně zápatí virtuálního pevného disku. Tato hodnota by měla být mezi 20972032 (20 miB + 512 bajtů pro zápatí VHD) a 35183298347520 bajty (32 TiB + 512 bajtů pro zápatí VHD). int

ImageDiskReference

Název Description Hodnota
communityGalleryImageId Relativní identifikátor URI obsahující odkaz na komunitní image Azure Compute Gallery. řetězec
id Relativní identifikátor URI obsahující buď úložiště imagí platformy, uživatelskou image nebo odkaz na image Azure Compute Gallery. řetězec
Lun Pokud je disk vytvořen z datového disku image, jedná se o index, který označuje, který z datových disků v imagi se má použít. Pro disky s operačním systémem má toto pole hodnotu null. int
sharedGalleryImageId Relativní identifikátor URI obsahující přímý odkaz na sdílenou image Azure Compute Gallery. řetězec

Šifrování

Název Description Hodnota
diskEncryptionSetId ResourceId šifrování disku nastaveného pro povolení šifrování neaktivních uložených dat. řetězec
typ Typ klíče, který se používá k šifrování dat na disku. "EncryptionAtRestWithCustomerKey"
"EncryptionAtRestWithPlatformAndCustomerKeys"
"EncryptionAtRestWithPlatformKey"

EncryptionSettingsCollection

Název Description Hodnota
enabled Pokud chcete povolit šifrování, nastavte tento příznak na true a zadejte DiskEncryptionKey a volitelný klíč KeyEncryptionKey. Nastavte tento příznak na false a odeberte DiskEncryptionKey a KeyEncryptionKey, aby se šifrování zakázalo. Pokud má encryptionSettings v objektu požadavku hodnotu null, stávající nastavení zůstanou beze změny. bool (povinné)
encryptionSettings Kolekce nastavení šifrování, jedno pro každý diskový svazek. EncryptionSettingsElement[]
encryptionSettingsVersion Popisuje, jaký typ šifrování se používá pro disky. Jakmile je toto pole nastavené, nelze ho přepsat. Verze 1.0 odpovídá Službě Azure Disk Encryption s aplikací AAD.'1.1' odpovídá službě Azure Disk Encryption. řetězec

EncryptionSettingsElement

Název Description Hodnota
diskEncryptionKey Key Vault adresu URL tajného kódu a ID trezoru šifrovacího klíče disku KeyVaultAndSecretReference
keyEncryptionKey Key Vault adresu URL klíče a ID trezoru šifrovacího klíče klíče. Klíč KeyEncryptionKey je volitelný a pokud je zadaný, použije se k rozbalení šifrovacího klíče disku. KeyVaultAndKeyReference

KeyVaultAndSecretReference

Název Description Hodnota
secretUrl Adresa URL odkazující na klíč nebo tajný kód ve službě KeyVault string (povinné)
sourceVault ID prostředku služby KeyVault obsahující klíč nebo tajný klíč SourceVault (povinné)

SourceVault

Název Description Hodnota
id ID prostředku řetězec

KeyVaultAndKeyReference

Název Description Hodnota
keyUrl Adresa URL odkazující na klíč nebo tajný klíč ve službě Key Vault string (povinné)
sourceVault ID prostředku služby Key Vault obsahující klíč nebo tajný klíč SourceVault (povinné)

PurchasePlan

Název Description Hodnota
name ID plánu string (povinné)
product Určuje produkt image z marketplace. Jedná se o stejnou hodnotu jako u prvku Offer v elementu imageReference. string (povinné)
promotionCode Propagační kód nabídky. řetězec
vydavatel ID vydavatele. string (povinné)

DiskSecurityProfile

Název Description Hodnota
secureVMDiskEncryptionSetId ResourceId sady pro šifrování disků přidružené k podporovanému disku důvěrného virtuálního počítače šifrovaného pomocí klíče spravovaného zákazníkem řetězec
typ zabezpečení Určuje SecurityType virtuálního počítače. Platí jenom pro disky s operačním systémem. "ConfidentialVM_DiskEncryptedWithCustomerKey"
"ConfidentialVM_DiskEncryptedWithPlatformKey"
"ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey"
"TrustedLaunch"

Podporovanécapabilities

Název Description Hodnota
akcelerovaná síť Hodnota True, pokud image, ze které je disk s operačním systémem vytvořen, podporuje akcelerované síťové služby. bool
Architektura Architektura procesoru podporovaná diskem s operačním systémem "Arm64"
"x64"
diskControllerTypes Řadiče disku, které podporuje disk s operačním systémem. Pokud je nastavená, může to být SCSI nebo SCSI, NVME nebo NVME, SCSI. řetězec

SnapshotSku

Název Description Hodnota
name Název skladové položky. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"