Sdílet prostřednictvím

Snímky Microsoft.Compute 2024-03-02

  • Článek

Definice prostředku Bicep

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í bicep.

resource symbolicname 'Microsoft.Compute/snapshots@2024-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'
      elasticSanResourceId: 'string'
      galleryImageReference: {
        communityGalleryImageId: 'string'
        id: 'string'
        lun: int
        sharedGalleryImageId: 'string'
      }
      imageReference: {
        communityGalleryImageId: 'string'
        id: 'string'
        lun: int
        sharedGalleryImageId: 'string'
      }
      logicalSectorSize: int
      performancePlus: bool
      provisionedBandwidthCopySpeed: 'string'
      securityDataUri: 'string'
      sourceResourceId: 'string'
      sourceUri: 'string'
      storageAccountId: 'string'
      uploadSizeBytes: int
    }
    dataAccessAuthMode: 'string'
    diskAccessId: 'string'
    diskSizeGB: int
    encryption: {
      diskEncryptionSetId: 'string'
      type: 'string'
    }
    encryptionSettingsCollection: {
      enabled: bool
      encryptionSettings: [
        {
          diskEncryptionKey: {
            secretUrl: 'string'
            sourceVault: {
              id: 'string'
            }
          }
          keyEncryptionKey: {
            keyUrl: 'string'
            sourceVault: {
              id: 'string'
            }
          }
        }
      ]
      encryptionSettingsVersion: 'string'
    }
    hyperVGeneration: 'string'
    incremental: bool
    networkAccessPolicy: 'string'
    osType: 'string'
    publicNetworkAccess: 'string'
    purchasePlan: {
      name: 'string'
      product: 'string'
      promotionCode: 'string'
      publisher: 'string'
    }
    securityProfile: {
      secureVMDiskEncryptionSetId: 'string'
      securityType: 'string'
    }
    supportedCapabilities: {
      acceleratedNetwork: bool
      architecture: 'string'
      diskControllerTypes: 'string'
    }
    supportsHibernation: bool
  }
}

Hodnoty vlastností

Snímky

Jméno Popis Hodnota
Jméno Název prostředku string (povinné)

Limit znaků: 1-80

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

Začněte alfanumerickými znaky. Končí alfanumerickým znakem nebo podtržítkem.
umístění Umístění prostředku string (povinné)
visačky Značky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách
sku Název skladové položky snímků. Může to být Standard_LRS, Premium_LRS nebo Standard_ZRS. Toto je volitelný parametr přírůstkového snímku 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í, kam se snímek vytvoří. Rozšířené umístění nelze změnit. ExtendedLocation
vlastnosti Vlastnosti prostředku snímku SnapshotProperties

ExtendedLocation

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

SnapshotProperties

Jméno Popis Hodnota
completionPercent Procento dokončení kopírování na pozadí při vytvoření prostředku prostřednictvím operace CopyStart. Int
copyCompletionError Označuje podrobnosti o chybě, pokud se nezdaří kopie pozadí prostředku vytvořeného prostřednictvím operace CopyStart. CopyCompletionError
creationData Informace o zdroji disků Po vytvoření disku nelze změnit informace o objektu CreationData. CreationData (povinné)
dataAccessAuthMode Další požadavky na ověřování při exportu nebo nahrání na disk nebo snímek AzureActiveDirectory
None (Žádný)
diskAccessId ID ARM prostředku DiskAccess pro použití privátních koncových bodů na discích řetězec
diskSizeGB Pokud je 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, znamená to změnu velikosti. Změna velikosti je povolená jenom v případě, že disk není připojený ke spuštěném virtuálnímu počítači a může zvětšit jenom velikost disku. Int
šifrování Vlastnost šifrování se dá 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í použitá 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"
inkrementální 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 dají se oddábit. 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. PurchasePlan
securityProfile Obsahuje informace související se zabezpečením prostředku. DiskSecurityProfile
supportedCapabilities Seznam podporovaných funkcí pro image, ze které byl původně vytvořen zdrojový disk ze snímku supportedCapabilities
supportsHibernation Označuje operační systém na snímku, který podporuje hibernaci. Bool

CopyCompletionError

Jméno Popis Hodnota
errorCode Označuje kód chyby, pokud se nezdaří kopie pozadí prostředku vytvořeného prostřednictvím operace CopyStart. CopySourceNotFound (povinné)
errorMessage Označuje chybovou zprávu, pokud selže kopie prostředku vytvořeného prostřednictvím operace CopyStart. string (povinné)

CreationData

Jméno Popis Hodnota
createOption Tím se vytvoří výčet možných zdrojů vytvoření disku. Připojit
Kopírovat
CopyFromSanSnapshot
CopyStart
"Prázdné"
FromImage
Import
ImportSecure
Obnovit
Nahrát
UploadPreparedSecure (povinné)
elasticSanResourceId Vyžaduje se, pokud je createOption CopyFromSanSnapshot. Toto je ID ARM zdrojového snímku elastického san svazku. řetězec
galleryImageReference Vyžaduje se při vytváření z obrázku galerie. ID/sharedGalleryImageId/communityGalleryImageId imageDiskReference bude ID ARM verze sdílené galerie image, 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 ad 4096. Výchozí hodnota je 4096. Int
performancePlus Pokud chcete zvýšit výkon nasazeného disku, nastavte tento příznak na hodnotu true, abyste získali vyšší výkon, viz zde odpovídající cíl výkonu. Tento příznak lze nastavit pouze při vytváření disku a po povolení nelze tento příznak zakázat. Bool
provisionedBandwidthCopySpeed Pokud je toto pole nastavené na snímku a createOption je CopyStart, snímek se zkopíruje rychleji. "Rozšířeno"
None (Žádný)
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. Identifikátor Azure Resource Manageru účtu úložiště obsahujícího objekt blob, který se má importovat jako disk. řetězec
uploadSizeBytes Pokud je createOption upload, 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

Jméno Popis Hodnota
communityGalleryImageId Relativní identifikátor URI, který obsahuje referenční informace ke komunitní galerii výpočetních prostředků Azure. řetězec
id Relativní identifikátor URI obsahující buď úložiště imagí platformy, image uživatele nebo referenční informace k imagi galerie výpočetních prostředků Azure. řetězec
Lun Pokud se disk vytvoří z datového disku image, jedná se o index, který označuje, které datové disky v imagi 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ý sdílený odkaz na image galerie výpočetních prostředků Azure. řetězec

Šifrování

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

EncryptionSettingsCollection

Jméno Popis Hodnota
zpřístupněný Nastavte tento příznak na true a zadejte DiskEncryptionKey a volitelný KeyEncryptionKey pro povolení šifrování. Nastavte tento příznak na false a odeberte DiskEncryptionKey a KeyEncryptionKey pro zakázání šifrování. Pokud je parametr EncryptionSettings v objektu požadavku null, stávající nastavení zůstanou beze změny. bool (povinné)
encryptionSettings Kolekce nastavení šifrování, jedno pro každý svazek disku. EncryptionSettingsElement[]
encryptionSettingsVersion Popisuje, jaký typ šifrování se používá pro disky. Jakmile je toto pole nastavené, nelze ho přepsat. Hodnota 1.0 odpovídá službě Azure Disk Encryption s aplikací AAD.'1.1' odpovídá službě Azure Disk Encryption. řetězec

EncryptionSettingsElement

Jméno Popis Hodnota
diskEncryptionKey Adresa URL tajného klíče služby Key Vault a ID trezoru šifrovacího klíče disku KeyVaultAndSecretReference
keyEncryptionKey Adresa URL klíče služby Key Vault a ID trezoru šifrovacího klíče. KeyEncryptionKey je volitelný a pokud se používá k rozbalení šifrovacího klíče disku. keyVaultAndKeyReference

KeyVaultAndSecretReference

Jméno Popis Hodnota
secretUrl Adresa URL odkazující na klíč nebo tajný klíč ve službě KeyVault string (povinné)
sourceVault ID prostředku služby KeyVault obsahující klíč nebo tajný klíč SourceVault (povinné)

SourceVault

Jméno Popis Hodnota
id ID prostředku řetězec

KeyVaultAndKeyReference

Jméno Popis Hodnota
keyUrl Adresa URL odkazující na klíč nebo tajný klíč ve službě KeyVault string (povinné)
sourceVault ID prostředku služby KeyVault obsahující klíč nebo tajný klíč SourceVault (povinné)

PurchasePlan

Jméno Popis Hodnota
Jméno ID plánu. string (povinné)
výrobek Určuje produkt image z marketplace. Jedná se o stejnou hodnotu jako Offer pod elementem imageReference. string (povinné)
promotionCode Kód zvýšení úrovně nabídky. řetězec
vydavatel ID vydavatele. string (povinné)

DiskSecurityProfile

Jméno Popis Hodnota
secureVMDiskEncryptionSetId ResourceId sady šifrování disku přidružené k disku podporovanému důvěrnému virtuálnímu počítači š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_NonPersistedTPM
"ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey"
TrustedLaunch

SupportedCapabilities

Jméno Popis 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 disků, které disk s operačním systémem podporuje. Pokud ji nastavíte, může to být SCSI nebo SCSI, NVME nebo NVME, SCSI. řetězec

SnapshotSku

Jméno Popis Hodnota
Jméno 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í JSON.

{
  "type": "Microsoft.Compute/snapshots",
  "apiVersion": "2024-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",
      "elasticSanResourceId": "string",
      "galleryImageReference": {
        "communityGalleryImageId": "string",
        "id": "string",
        "lun": "int",
        "sharedGalleryImageId": "string"
      },
      "imageReference": {
        "communityGalleryImageId": "string",
        "id": "string",
        "lun": "int",
        "sharedGalleryImageId": "string"
      },
      "logicalSectorSize": "int",
      "performancePlus": "bool",
      "provisionedBandwidthCopySpeed": "string",
      "securityDataUri": "string",
      "sourceResourceId": "string",
      "sourceUri": "string",
      "storageAccountId": "string",
      "uploadSizeBytes": "int"
    },
    "dataAccessAuthMode": "string",
    "diskAccessId": "string",
    "diskSizeGB": "int",
    "encryption": {
      "diskEncryptionSetId": "string",
      "type": "string"
    },
    "encryptionSettingsCollection": {
      "enabled": "bool",
      "encryptionSettings": [
        {
          "diskEncryptionKey": {
            "secretUrl": "string",
            "sourceVault": {
              "id": "string"
            }
          },
          "keyEncryptionKey": {
            "keyUrl": "string",
            "sourceVault": {
              "id": "string"
            }
          }
        }
      ],
      "encryptionSettingsVersion": "string"
    },
    "hyperVGeneration": "string",
    "incremental": "bool",
    "networkAccessPolicy": "string",
    "osType": "string",
    "publicNetworkAccess": "string",
    "purchasePlan": {
      "name": "string",
      "product": "string",
      "promotionCode": "string",
      "publisher": "string"
    },
    "securityProfile": {
      "secureVMDiskEncryptionSetId": "string",
      "securityType": "string"
    },
    "supportedCapabilities": {
      "acceleratedNetwork": "bool",
      "architecture": "string",
      "diskControllerTypes": "string"
    },
    "supportsHibernation": "bool"
  }
}

Hodnoty vlastností

Snímky

Jméno Popis Hodnota
typ Typ prostředku Microsoft.Compute/snapshots
apiVersion Verze rozhraní API prostředku '2024-03-02'
Jméno Název prostředku string (povinné)

Limit znaků: 1-80

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

Začněte alfanumerickými znaky. Končí alfanumerickým znakem nebo podtržítkem.
umístění Umístění prostředku string (povinné)
visačky Značky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách
sku Název skladové položky snímků. Může to být Standard_LRS, Premium_LRS nebo Standard_ZRS. Toto je volitelný parametr přírůstkového snímku 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í, kam se snímek vytvoří. Rozšířené umístění nelze změnit. ExtendedLocation
vlastnosti Vlastnosti prostředku snímku SnapshotProperties

ExtendedLocation

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

SnapshotProperties

Jméno Popis Hodnota
completionPercent Procento dokončení kopírování na pozadí při vytvoření prostředku prostřednictvím operace CopyStart. Int
copyCompletionError Označuje podrobnosti o chybě, pokud se nezdaří kopie pozadí prostředku vytvořeného prostřednictvím operace CopyStart. CopyCompletionError
creationData Informace o zdroji disků Po vytvoření disku nelze změnit informace o objektu CreationData. CreationData (povinné)
dataAccessAuthMode Další požadavky na ověřování při exportu nebo nahrání na disk nebo snímek AzureActiveDirectory
None (Žádný)
diskAccessId ID ARM prostředku DiskAccess pro použití privátních koncových bodů na discích řetězec
diskSizeGB Pokud je 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, znamená to změnu velikosti. Změna velikosti je povolená jenom v případě, že disk není připojený ke spuštěném virtuálnímu počítači a může zvětšit jenom velikost disku. Int
šifrování Vlastnost šifrování se dá 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í použitá 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"
inkrementální 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 dají se oddábit. 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. PurchasePlan
securityProfile Obsahuje informace související se zabezpečením prostředku. DiskSecurityProfile
supportedCapabilities Seznam podporovaných funkcí pro image, ze které byl původně vytvořen zdrojový disk ze snímku supportedCapabilities
supportsHibernation Označuje operační systém na snímku, který podporuje hibernaci. Bool

CopyCompletionError

Jméno Popis Hodnota
errorCode Označuje kód chyby, pokud se nezdaří kopie pozadí prostředku vytvořeného prostřednictvím operace CopyStart. CopySourceNotFound (povinné)
errorMessage Označuje chybovou zprávu, pokud selže kopie prostředku vytvořeného prostřednictvím operace CopyStart. string (povinné)

CreationData

Jméno Popis Hodnota
createOption Tím se vytvoří výčet možných zdrojů vytvoření disku. Připojit
Kopírovat
CopyFromSanSnapshot
CopyStart
"Prázdné"
FromImage
Import
ImportSecure
Obnovit
Nahrát
UploadPreparedSecure (povinné)
elasticSanResourceId Vyžaduje se, pokud je createOption CopyFromSanSnapshot. Toto je ID ARM zdrojového snímku elastického san svazku. řetězec
galleryImageReference Vyžaduje se při vytváření z obrázku galerie. ID/sharedGalleryImageId/communityGalleryImageId imageDiskReference bude ID ARM verze sdílené galerie image, 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 ad 4096. Výchozí hodnota je 4096. Int
performancePlus Pokud chcete zvýšit výkon nasazeného disku, nastavte tento příznak na hodnotu true, abyste získali vyšší výkon, viz zde odpovídající cíl výkonu. Tento příznak lze nastavit pouze při vytváření disku a po povolení nelze tento příznak zakázat. Bool
provisionedBandwidthCopySpeed Pokud je toto pole nastavené na snímku a createOption je CopyStart, snímek se zkopíruje rychleji. "Rozšířeno"
None (Žádný)
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. Identifikátor Azure Resource Manageru účtu úložiště obsahujícího objekt blob, který se má importovat jako disk. řetězec
uploadSizeBytes Pokud je createOption upload, 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

Jméno Popis Hodnota
communityGalleryImageId Relativní identifikátor URI, který obsahuje referenční informace ke komunitní galerii výpočetních prostředků Azure. řetězec
id Relativní identifikátor URI obsahující buď úložiště imagí platformy, image uživatele nebo referenční informace k imagi galerie výpočetních prostředků Azure. řetězec
Lun Pokud se disk vytvoří z datového disku image, jedná se o index, který označuje, které datové disky v imagi 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ý sdílený odkaz na image galerie výpočetních prostředků Azure. řetězec

Šifrování

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

EncryptionSettingsCollection

Jméno Popis Hodnota
zpřístupněný Nastavte tento příznak na true a zadejte DiskEncryptionKey a volitelný KeyEncryptionKey pro povolení šifrování. Nastavte tento příznak na false a odeberte DiskEncryptionKey a KeyEncryptionKey pro zakázání šifrování. Pokud je parametr EncryptionSettings v objektu požadavku null, stávající nastavení zůstanou beze změny. bool (povinné)
encryptionSettings Kolekce nastavení šifrování, jedno pro každý svazek disku. EncryptionSettingsElement[]
encryptionSettingsVersion Popisuje, jaký typ šifrování se používá pro disky. Jakmile je toto pole nastavené, nelze ho přepsat. Hodnota 1.0 odpovídá službě Azure Disk Encryption s aplikací AAD.'1.1' odpovídá službě Azure Disk Encryption. řetězec

EncryptionSettingsElement

Jméno Popis Hodnota
diskEncryptionKey Adresa URL tajného klíče služby Key Vault a ID trezoru šifrovacího klíče disku KeyVaultAndSecretReference
keyEncryptionKey Adresa URL klíče služby Key Vault a ID trezoru šifrovacího klíče. KeyEncryptionKey je volitelný a pokud se používá k rozbalení šifrovacího klíče disku. keyVaultAndKeyReference

KeyVaultAndSecretReference

Jméno Popis Hodnota
secretUrl Adresa URL odkazující na klíč nebo tajný klíč ve službě KeyVault string (povinné)
sourceVault ID prostředku služby KeyVault obsahující klíč nebo tajný klíč SourceVault (povinné)

SourceVault

Jméno Popis Hodnota
id ID prostředku řetězec

KeyVaultAndKeyReference

Jméno Popis Hodnota
keyUrl Adresa URL odkazující na klíč nebo tajný klíč ve službě KeyVault string (povinné)
sourceVault ID prostředku služby KeyVault obsahující klíč nebo tajný klíč SourceVault (povinné)

PurchasePlan

Jméno Popis Hodnota
Jméno ID plánu. string (povinné)
výrobek Určuje produkt image z marketplace. Jedná se o stejnou hodnotu jako Offer pod elementem imageReference. string (povinné)
promotionCode Kód zvýšení úrovně nabídky. řetězec
vydavatel ID vydavatele. string (povinné)

DiskSecurityProfile

Jméno Popis Hodnota
secureVMDiskEncryptionSetId ResourceId sady šifrování disku přidružené k disku podporovanému důvěrnému virtuálnímu počítači š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_NonPersistedTPM
"ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey"
TrustedLaunch

SupportedCapabilities

Jméno Popis 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 disků, které disk s operačním systémem podporuje. Pokud ji nastavíte, může to být SCSI nebo SCSI, NVME nebo NVME, SCSI. řetězec

SnapshotSku

Jméno Popis Hodnota
Jméno Název skladové položky. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

Definice prostředku Terraformu (poskytovatel AzAPI)

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

  • 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@2024-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"
        elasticSanResourceId = "string"
        galleryImageReference = {
          communityGalleryImageId = "string"
          id = "string"
          lun = int
          sharedGalleryImageId = "string"
        }
        imageReference = {
          communityGalleryImageId = "string"
          id = "string"
          lun = int
          sharedGalleryImageId = "string"
        }
        logicalSectorSize = int
        performancePlus = bool
        provisionedBandwidthCopySpeed = "string"
        securityDataUri = "string"
        sourceResourceId = "string"
        sourceUri = "string"
        storageAccountId = "string"
        uploadSizeBytes = int
      }
      dataAccessAuthMode = "string"
      diskAccessId = "string"
      diskSizeGB = int
      encryption = {
        diskEncryptionSetId = "string"
        type = "string"
      }
      encryptionSettingsCollection = {
        enabled = bool
        encryptionSettings = [
          {
            diskEncryptionKey = {
              secretUrl = "string"
              sourceVault = {
                id = "string"
              }
            }
            keyEncryptionKey = {
              keyUrl = "string"
              sourceVault = {
                id = "string"
              }
            }
          }
        ]
        encryptionSettingsVersion = "string"
      }
      hyperVGeneration = "string"
      incremental = bool
      networkAccessPolicy = "string"
      osType = "string"
      publicNetworkAccess = "string"
      purchasePlan = {
        name = "string"
        product = "string"
        promotionCode = "string"
        publisher = "string"
      }
      securityProfile = {
        secureVMDiskEncryptionSetId = "string"
        securityType = "string"
      }
      supportedCapabilities = {
        acceleratedNetwork = bool
        architecture = "string"
        diskControllerTypes = "string"
      }
      supportsHibernation = bool
    }
    sku = {
      name = "string"
    }
    extendedLocation = {
      name = "string"
      type = "EdgeZone"
    }
  })
}

Hodnoty vlastností

Snímky

Jméno Popis Hodnota
typ Typ prostředku Microsoft.Compute/snapshots@2024-03-02
Jméno Název prostředku string (povinné)

Limit znaků: 1-80

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

Začněte alfanumerickými znaky. Končí alfanumerickým znakem nebo podtržítkem.
umístění 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é)
visačky Značky prostředků Slovník názvů a hodnot značek
sku Název skladové položky snímků. Může to být Standard_LRS, Premium_LRS nebo Standard_ZRS. Toto je volitelný parametr přírůstkového snímku 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í, kam se snímek vytvoří. Rozšířené umístění nelze změnit. ExtendedLocation
vlastnosti Vlastnosti prostředku snímku SnapshotProperties

ExtendedLocation

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

SnapshotProperties

Jméno Popis Hodnota
completionPercent Procento dokončení kopírování na pozadí při vytvoření prostředku prostřednictvím operace CopyStart. Int
copyCompletionError Označuje podrobnosti o chybě, pokud se nezdaří kopie pozadí prostředku vytvořeného prostřednictvím operace CopyStart. CopyCompletionError
creationData Informace o zdroji disků Po vytvoření disku nelze změnit informace o objektu CreationData. CreationData (povinné)
dataAccessAuthMode Další požadavky na ověřování při exportu nebo nahrá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 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, znamená to změnu velikosti. Změna velikosti je povolená jenom v případě, že disk není připojený ke spuštěném virtuálnímu počítači a může zvětšit jenom velikost disku. Int
šifrování Vlastnost šifrování se dá 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í použitá 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"
inkrementální 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 dají se oddábit. 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. PurchasePlan
securityProfile Obsahuje informace související se zabezpečením prostředku. DiskSecurityProfile
supportedCapabilities Seznam podporovaných funkcí pro image, ze které byl původně vytvořen zdrojový disk ze snímku supportedCapabilities
supportsHibernation Označuje operační systém na snímku, který podporuje hibernaci. Bool

CopyCompletionError

Jméno Popis Hodnota
errorCode Označuje kód chyby, pokud se nezdaří kopie pozadí prostředku vytvořeného prostřednictvím operace CopyStart. CopySourceNotFound (povinné)
errorMessage Označuje chybovou zprávu, pokud selže kopie prostředku vytvořeného prostřednictvím operace CopyStart. string (povinné)

CreationData

Jméno Popis Hodnota
createOption Tím se vytvoří výčet možných zdrojů vytvoření disku. "Připojit"
"Kopírovat"
"CopyFromSanSnapshot"
"CopyStart"
"Prázdné"
"FromImage"
"Importovat"
"ImportSecure"
"Obnovit"
"Nahrát"
UploadPreparedSecure (povinné)
elasticSanResourceId Vyžaduje se, pokud je createOption CopyFromSanSnapshot. Toto je ID ARM zdrojového snímku elastického san svazku. řetězec
galleryImageReference Vyžaduje se při vytváření z obrázku galerie. ID/sharedGalleryImageId/communityGalleryImageId imageDiskReference bude ID ARM verze sdílené galerie image, 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 ad 4096. Výchozí hodnota je 4096. Int
performancePlus Pokud chcete zvýšit výkon nasazeného disku, nastavte tento příznak na hodnotu true, abyste získali vyšší výkon, viz zde odpovídající cíl výkonu. Tento příznak lze nastavit pouze při vytváření disku a po povolení nelze tento příznak zakázat. Bool
provisionedBandwidthCopySpeed Pokud je toto pole nastavené na snímku a createOption je CopyStart, snímek se zkopíruje rychleji. "Rozšířeno"
"Žádný"
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. Identifikátor Azure Resource Manageru účtu úložiště obsahujícího objekt blob, který se má importovat jako disk. řetězec
uploadSizeBytes Pokud je createOption upload, 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

Jméno Popis Hodnota
communityGalleryImageId Relativní identifikátor URI, který obsahuje referenční informace ke komunitní galerii výpočetních prostředků Azure. řetězec
id Relativní identifikátor URI obsahující buď úložiště imagí platformy, image uživatele nebo referenční informace k imagi galerie výpočetních prostředků Azure. řetězec
Lun Pokud se disk vytvoří z datového disku image, jedná se o index, který označuje, které datové disky v imagi 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ý sdílený odkaz na image galerie výpočetních prostředků Azure. řetězec

Šifrování

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

EncryptionSettingsCollection

Jméno Popis Hodnota
zpřístupněný Nastavte tento příznak na true a zadejte DiskEncryptionKey a volitelný KeyEncryptionKey pro povolení šifrování. Nastavte tento příznak na false a odeberte DiskEncryptionKey a KeyEncryptionKey pro zakázání šifrování. Pokud je parametr EncryptionSettings v objektu požadavku null, stávající nastavení zůstanou beze změny. bool (povinné)
encryptionSettings Kolekce nastavení šifrování, jedno pro každý svazek disku. EncryptionSettingsElement[]
encryptionSettingsVersion Popisuje, jaký typ šifrování se používá pro disky. Jakmile je toto pole nastavené, nelze ho přepsat. Hodnota 1.0 odpovídá službě Azure Disk Encryption s aplikací AAD.'1.1' odpovídá službě Azure Disk Encryption. řetězec

EncryptionSettingsElement

Jméno Popis Hodnota
diskEncryptionKey Adresa URL tajného klíče služby Key Vault a ID trezoru šifrovacího klíče disku KeyVaultAndSecretReference
keyEncryptionKey Adresa URL klíče služby Key Vault a ID trezoru šifrovacího klíče. KeyEncryptionKey je volitelný a pokud se používá k rozbalení šifrovacího klíče disku. keyVaultAndKeyReference

KeyVaultAndSecretReference

Jméno Popis Hodnota
secretUrl Adresa URL odkazující na klíč nebo tajný klíč ve službě KeyVault string (povinné)
sourceVault ID prostředku služby KeyVault obsahující klíč nebo tajný klíč SourceVault (povinné)

SourceVault

Jméno Popis Hodnota
id ID prostředku řetězec

KeyVaultAndKeyReference

Jméno Popis Hodnota
keyUrl Adresa URL odkazující na klíč nebo tajný klíč ve službě KeyVault string (povinné)
sourceVault ID prostředku služby KeyVault obsahující klíč nebo tajný klíč SourceVault (povinné)

PurchasePlan

Jméno Popis Hodnota
Jméno ID plánu. string (povinné)
výrobek Určuje produkt image z marketplace. Jedná se o stejnou hodnotu jako Offer pod elementem imageReference. string (povinné)
promotionCode Kód zvýšení úrovně nabídky. řetězec
vydavatel ID vydavatele. string (povinné)

DiskSecurityProfile

Jméno Popis Hodnota
secureVMDiskEncryptionSetId ResourceId sady šifrování disku přidružené k disku podporovanému důvěrnému virtuálnímu počítači š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_NonPersistedTPM"
"ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey"
"TrustedLaunch"

SupportedCapabilities

Jméno Popis 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 disků, které disk s operačním systémem podporuje. Pokud ji nastavíte, může to být SCSI nebo SCSI, NVME nebo NVME, SCSI. řetězec

SnapshotSku

Jméno Popis Hodnota
Jméno Název skladové položky. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"