Sdílet prostřednictvím

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

  • Článek

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-03-02' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'string'
  }
  extendedLocation: {
    name: 'string'
    type: 'EdgeZone'
  }
  properties: {
    completionPercent: int
    copyCompletionError: {
      errorCode: 'CopySourceNotFound'
      errorMessage: 'string'
    }
    creationData: {
      createOption: 'string'
      galleryImageReference: {
        communityGalleryImageId: 'string'
        id: 'string'
        lun: int
        sharedGalleryImageId: 'string'
      }
      imageReference: {
        communityGalleryImageId: 'string'
        id: 'string'
        lun: int
        sharedGalleryImageId: 'string'
      }
      logicalSectorSize: int
      securityDataUri: 'string'
      sourceResourceId: 'string'
      sourceUri: 'string'
      storageAccountId: 'string'
      uploadSizeBytes: int
    }
    dataAccessAuthMode: 'string'
    diskAccessId: 'string'
    diskSizeGB: int
    encryption: {
      diskEncryptionSetId: 'string'
      type: 'string'
    }
    encryptionSettingsCollection: {
      enabled: bool
      encryptionSettings: [
        {
          diskEncryptionKey: {
            secretUrl: 'string'
            sourceVault: {
              id: 'string'
            }
          }
          keyEncryptionKey: {
            keyUrl: 'string'
            sourceVault: {
              id: 'string'
            }
          }
        }
      ]
      encryptionSettingsVersion: 'string'
    }
    hyperVGeneration: 'string'
    incremental: bool
    networkAccessPolicy: 'string'
    osType: 'string'
    publicNetworkAccess: 'string'
    purchasePlan: {
      name: 'string'
      product: 'string'
      promotionCode: 'string'
      publisher: 'string'
    }
    securityProfile: {
      secureVMDiskEncryptionSetId: 'string'
      securityType: 'string'
    }
    supportedCapabilities: {
      acceleratedNetwork: bool
      architecture: 'string'
    }
    supportsHibernation: bool
  }
}

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

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í 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í kód JSON.

{
  "type": "Microsoft.Compute/snapshots",
  "apiVersion": "2022-03-02",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "string"
  },
  "extendedLocation": {
    "name": "string",
    "type": "EdgeZone"
  },
  "properties": {
    "completionPercent": "int",
    "copyCompletionError": {
      "errorCode": "CopySourceNotFound",
      "errorMessage": "string"
    },
    "creationData": {
      "createOption": "string",
      "galleryImageReference": {
        "communityGalleryImageId": "string",
        "id": "string",
        "lun": "int",
        "sharedGalleryImageId": "string"
      },
      "imageReference": {
        "communityGalleryImageId": "string",
        "id": "string",
        "lun": "int",
        "sharedGalleryImageId": "string"
      },
      "logicalSectorSize": "int",
      "securityDataUri": "string",
      "sourceResourceId": "string",
      "sourceUri": "string",
      "storageAccountId": "string",
      "uploadSizeBytes": "int"
    },
    "dataAccessAuthMode": "string",
    "diskAccessId": "string",
    "diskSizeGB": "int",
    "encryption": {
      "diskEncryptionSetId": "string",
      "type": "string"
    },
    "encryptionSettingsCollection": {
      "enabled": "bool",
      "encryptionSettings": [
        {
          "diskEncryptionKey": {
            "secretUrl": "string",
            "sourceVault": {
              "id": "string"
            }
          },
          "keyEncryptionKey": {
            "keyUrl": "string",
            "sourceVault": {
              "id": "string"
            }
          }
        }
      ],
      "encryptionSettingsVersion": "string"
    },
    "hyperVGeneration": "string",
    "incremental": "bool",
    "networkAccessPolicy": "string",
    "osType": "string",
    "publicNetworkAccess": "string",
    "purchasePlan": {
      "name": "string",
      "product": "string",
      "promotionCode": "string",
      "publisher": "string"
    },
    "securityProfile": {
      "secureVMDiskEncryptionSetId": "string",
      "securityType": "string"
    },
    "supportedCapabilities": {
      "acceleratedNetwork": "bool",
      "architecture": "string"
    },
    "supportsHibernation": "bool"
  }
}

Hodnoty vlastností

snímky

Název Description Hodnota
typ Typ prostředku Microsoft.Compute/snapshots
apiVersion Verze rozhraní API prostředku '2022-03-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é)
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
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'

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-03-02"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      completionPercent = int
      copyCompletionError = {
        errorCode = "CopySourceNotFound"
        errorMessage = "string"
      }
      creationData = {
        createOption = "string"
        galleryImageReference = {
          communityGalleryImageId = "string"
          id = "string"
          lun = int
          sharedGalleryImageId = "string"
        }
        imageReference = {
          communityGalleryImageId = "string"
          id = "string"
          lun = int
          sharedGalleryImageId = "string"
        }
        logicalSectorSize = int
        securityDataUri = "string"
        sourceResourceId = "string"
        sourceUri = "string"
        storageAccountId = "string"
        uploadSizeBytes = int
      }
      dataAccessAuthMode = "string"
      diskAccessId = "string"
      diskSizeGB = int
      encryption = {
        diskEncryptionSetId = "string"
        type = "string"
      }
      encryptionSettingsCollection = {
        enabled = bool
        encryptionSettings = [
          {
            diskEncryptionKey = {
              secretUrl = "string"
              sourceVault = {
                id = "string"
              }
            }
            keyEncryptionKey = {
              keyUrl = "string"
              sourceVault = {
                id = "string"
              }
            }
          }
        ]
        encryptionSettingsVersion = "string"
      }
      hyperVGeneration = "string"
      incremental = bool
      networkAccessPolicy = "string"
      osType = "string"
      publicNetworkAccess = "string"
      purchasePlan = {
        name = "string"
        product = "string"
        promotionCode = "string"
        publisher = "string"
      }
      securityProfile = {
        secureVMDiskEncryptionSetId = "string"
        securityType = "string"
      }
      supportedCapabilities = {
        acceleratedNetwork = bool
        architecture = "string"
      }
      supportsHibernation = bool
    }
    sku = {
      name = "string"
    }
    extendedLocation = {
      name = "string"
      type = "EdgeZone"
    }
  })
}

Hodnoty vlastností

snímky

Název Description Hodnota
typ Typ prostředku Microsoft.Compute/snapshots@2022-03-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 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 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
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í 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 š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"

SnapshotSku

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