Snímky Microsoft.Compute 2018-04-01

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.

Příklady použití

Ukázky Bicep

Základní příklad nasazení Disk Snapshotu.

param resourceName string = 'acctest0001'
param location string = 'westus'

resource disk 'Microsoft.Compute/disks@2023-04-02' = {
  name: '${resourceName}disk'
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  properties: {
    creationData: {
      createOption: 'Empty'
      performancePlus: false
    }
    diskSizeGB: 10
    encryption: {
      type: 'EncryptionAtRestWithPlatformKey'
    }
    networkAccessPolicy: 'AllowAll'
    optimizedForFrequentAttach: false
    publicNetworkAccess: 'Enabled'
  }
}

resource snapshot 'Microsoft.Compute/snapshots@2022-03-02' = {
  name: '${resourceName}snapshot'
  location: location
  properties: {
    creationData: {
      createOption: 'Copy'
      sourceUri: disk.id
    }
    diskSizeGB: 20
    incremental: false
    networkAccessPolicy: 'AllowAll'
    publicNetworkAccess: 'Enabled'
  }
}

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@2018-04-01' = {
  location: 'string'
  name: 'string'
  properties: {
    creationData: {
      createOption: 'string'
      imageReference: {
        id: 'string'
        lun: int
      }
      sourceResourceId: 'string'
      sourceUri: 'string'
      storageAccountId: 'string'
    }
    diskSizeGB: int
    encryptionSettings: {
      diskEncryptionKey: {
        secretUrl: 'string'
        sourceVault: {
          id: 'string'
        }
      }
      enabled: bool
      keyEncryptionKey: {
        keyUrl: 'string'
        sourceVault: {
          id: 'string'
        }
      }
    }
    osType: 'string'
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Hodnoty vlastností

Microsoft.Compute/snímky

Jméno Popis Hodnota
poloha Umístění prostředku string (povinné)
Jméno Název prostředku string (povinné)
vlastnosti Vlastnosti prostředku disku DiskProperties
SKU (identifikátor zboží) Název skladové položky snímků. Může to být Standard_LRS, Premium_LRS nebo Standard_ZRS. snapshotSku
visačky Značky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách

Vytváření dat

Jméno Popis Hodnota
Možnost vytvoření Tím se vytvoří výčet možných zdrojů vytvoření disku. Připojit
Kopírovat
"Prázdné"
FromImage
Import
Obnovit (povinné)
Odkaz na obrázek Informace o zdroji disků imageDiskReference
ID zdroje 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
identifikátor účtu storageAccountId Pokud je createOption import, identifikátor Azure Resource Manageru účtu úložiště obsahujícího objekt blob, který se má importovat jako disk. Vyžadováno pouze v případě, že je objekt blob v jiném předplatném. řetězec

Vlastnosti disku

Jméno Popis Hodnota
creationData Informace o zdroji disků Po vytvoření disku nelze změnit informace o objektu CreationData. CreationData (povinné)
diskSizeGB Pokud je creationData.createOption prázdný, je toto pole povinné a označuje velikost virtuálního pevného disku, který chcete 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
nastavení šifrování Nastavení šifrování disku nebo snímku EncryptionSettings
OSType Typ operačního systému. Linux
Windows

Nastavení šifrování

Jméno Popis Hodnota
diskEncryptionKey Adresa URL tajného klíče služby Key Vault a ID trezoru šifrovacího klíče disku KeyVaultAndSecretReference
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
klíčŠifrovací klíč Adresa URL klíče služby Key Vault a ID trezoru šifrovacího klíče keyVaultAndKeyReference

Odkaz na obrazový disk

Jméno Popis Hodnota
identifikační číslo Relativní identifikátor URI obsahující buď úložiště imagí platformy, nebo odkaz na image uživatele. string (povinné)
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

Trezor klíčů a odkaz na klíče

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

Klíč

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

Značky prostředků

Jméno Popis Hodnota

SnímekSku

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

Zdrojový trezor

Jméno Popis Hodnota
identifikační číslo ID prostředku řetězec

Definice prostředku šablony ARM

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

Příklady použití

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": "2018-04-01",
  "name": "string",
  "location": "string",
  "properties": {
    "creationData": {
      "createOption": "string",
      "imageReference": {
        "id": "string",
        "lun": "int"
      },
      "sourceResourceId": "string",
      "sourceUri": "string",
      "storageAccountId": "string"
    },
    "diskSizeGB": "int",
    "encryptionSettings": {
      "diskEncryptionKey": {
        "secretUrl": "string",
        "sourceVault": {
          "id": "string"
        }
      },
      "enabled": "bool",
      "keyEncryptionKey": {
        "keyUrl": "string",
        "sourceVault": {
          "id": "string"
        }
      }
    },
    "osType": "string"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Hodnoty vlastností

Microsoft.Compute/snímky

Jméno Popis Hodnota
Verze rozhraní apiVersion Verze rozhraní API '2018-04-01'
poloha Umístění prostředku string (povinné)
Jméno Název prostředku string (povinné)
vlastnosti Vlastnosti prostředku disku DiskProperties
SKU (identifikátor zboží) Název skladové položky snímků. Může to být Standard_LRS, Premium_LRS nebo Standard_ZRS. snapshotSku
visačky Značky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách
typ Typ prostředku Microsoft.Compute/snapshots

Vytváření dat

Jméno Popis Hodnota
Možnost vytvoření Tím se vytvoří výčet možných zdrojů vytvoření disku. Připojit
Kopírovat
"Prázdné"
FromImage
Import
Obnovit (povinné)
Odkaz na obrázek Informace o zdroji disků imageDiskReference
ID zdroje 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
identifikátor účtu storageAccountId Pokud je createOption import, identifikátor Azure Resource Manageru účtu úložiště obsahujícího objekt blob, který se má importovat jako disk. Vyžadováno pouze v případě, že je objekt blob v jiném předplatném. řetězec

Vlastnosti disku

Jméno Popis Hodnota
creationData Informace o zdroji disků Po vytvoření disku nelze změnit informace o objektu CreationData. CreationData (povinné)
diskSizeGB Pokud je creationData.createOption prázdný, je toto pole povinné a označuje velikost virtuálního pevného disku, který chcete 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
nastavení šifrování Nastavení šifrování disku nebo snímku EncryptionSettings
OSType Typ operačního systému. Linux
Windows

Nastavení šifrování

Jméno Popis Hodnota
diskEncryptionKey Adresa URL tajného klíče služby Key Vault a ID trezoru šifrovacího klíče disku KeyVaultAndSecretReference
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
klíčŠifrovací klíč Adresa URL klíče služby Key Vault a ID trezoru šifrovacího klíče keyVaultAndKeyReference

Odkaz na obrazový disk

Jméno Popis Hodnota
identifikační číslo Relativní identifikátor URI obsahující buď úložiště imagí platformy, nebo odkaz na image uživatele. string (povinné)
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

Trezor klíčů a odkaz na klíče

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

Klíč

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

Značky prostředků

Jméno Popis Hodnota

SnímekSku

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

Zdrojový trezor

Jméno Popis Hodnota
identifikační číslo ID prostředku řetězec

Definice prostředku Terraformu (poskytovatel AzAPI)

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

  • Skupiny zdrojů Pro seznam změněných vlastností v každé verzi API viz log změn.

Příklady použití

Ukázky Terraformu

Základní příklad nasazení Disk Snapshotu.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westus"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "disk" {
  type      = "Microsoft.Compute/disks@2023-04-02"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}disk"
  location  = var.location
  body = {
    properties = {
      creationData = {
        createOption    = "Empty"
        performancePlus = false
      }
      diskSizeGB = 10
      encryption = {
        type = "EncryptionAtRestWithPlatformKey"
      }
      networkAccessPolicy        = "AllowAll"
      optimizedForFrequentAttach = false
      publicNetworkAccess        = "Enabled"
    }
    sku = {
      name = "Standard_LRS"
    }
  }
}

resource "azapi_resource" "snapshot" {
  type      = "Microsoft.Compute/snapshots@2022-03-02"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}snapshot"
  location  = var.location
  body = {
    properties = {
      creationData = {
        createOption = "Copy"
        sourceUri    = azapi_resource.disk.id
      }
      diskSizeGB          = 20
      incremental         = false
      networkAccessPolicy = "AllowAll"
      publicNetworkAccess = "Enabled"
    }
  }
}

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@2018-04-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      creationData = {
        createOption = "string"
        imageReference = {
          id = "string"
          lun = int
        }
        sourceResourceId = "string"
        sourceUri = "string"
        storageAccountId = "string"
      }
      diskSizeGB = int
      encryptionSettings = {
        diskEncryptionKey = {
          secretUrl = "string"
          sourceVault = {
            id = "string"
          }
        }
        enabled = bool
        keyEncryptionKey = {
          keyUrl = "string"
          sourceVault = {
            id = "string"
          }
        }
      }
      osType = "string"
    }
    sku = {
      name = "string"
    }
  }
}

Hodnoty vlastností

Microsoft.Compute/snímky

Jméno Popis Hodnota
poloha Umístění prostředku string (povinné)
Jméno Název prostředku string (povinné)
vlastnosti Vlastnosti prostředku disku DiskProperties
SKU (identifikátor zboží) Název skladové položky snímků. Může to být Standard_LRS, Premium_LRS nebo Standard_ZRS. snapshotSku
visačky Značky prostředků Slovník názvů a hodnot značek
typ Typ prostředku Microsoft.Compute/snapshots@2018-04-01

Vytváření dat

Jméno Popis Hodnota
Možnost vytvoření Tím se vytvoří výčet možných zdrojů vytvoření disku. Připojit
Kopírovat
"Prázdné"
FromImage
Import
Obnovit (povinné)
Odkaz na obrázek Informace o zdroji disků imageDiskReference
ID zdroje 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
identifikátor účtu storageAccountId Pokud je createOption import, identifikátor Azure Resource Manageru účtu úložiště obsahujícího objekt blob, který se má importovat jako disk. Vyžadováno pouze v případě, že je objekt blob v jiném předplatném. řetězec

Vlastnosti disku

Jméno Popis Hodnota
creationData Informace o zdroji disků Po vytvoření disku nelze změnit informace o objektu CreationData. CreationData (povinné)
diskSizeGB Pokud je creationData.createOption prázdný, je toto pole povinné a označuje velikost virtuálního pevného disku, který chcete 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
nastavení šifrování Nastavení šifrování disku nebo snímku EncryptionSettings
OSType Typ operačního systému. Linux
Windows

Nastavení šifrování

Jméno Popis Hodnota
diskEncryptionKey Adresa URL tajného klíče služby Key Vault a ID trezoru šifrovacího klíče disku KeyVaultAndSecretReference
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
klíčŠifrovací klíč Adresa URL klíče služby Key Vault a ID trezoru šifrovacího klíče keyVaultAndKeyReference

Odkaz na obrazový disk

Jméno Popis Hodnota
identifikační číslo Relativní identifikátor URI obsahující buď úložiště imagí platformy, nebo odkaz na image uživatele. string (povinné)
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

Trezor klíčů a odkaz na klíče

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

Klíč

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

Značky prostředků

Jméno Popis Hodnota

SnímekSku

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

Zdrojový trezor

Jméno Popis Hodnota
identifikační číslo ID prostředku řetězec