Microsoft.Compute-pillanatképek 2018.04.01.

Bicep-erőforrásdefiníció

A pillanatképek erőforrástípusa üzembe helyezhető a célműveletekkel:

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.

Használati példák

Bicep-minták

Alapvető példa a lemez pillanatképének üzembe helyezésére.

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

Erőforrás formátuma

Microsoft.Compute/snapshots erőforrás létrehozásához adja hozzá a következő Bicep-et a sablonhoz.

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

Tulajdonságértékek

Microsoft.Compute/pillanatképek

Név Leírás Érték
hely Erőforrás helye sztring (kötelező)
név Az erőforrás neve sztring (kötelező)
kellékek Lemezerőforrás tulajdonságai. DiskProperties
Sku A pillanatképek termékváltozatának neve. Lehet Standard_LRS, Premium_LRS vagy Standard_ZRS. SnapshotSku
Címkék Erőforráscímkék Címkenevek és -értékek szótára. sablonok címkéinek megtekintése

CreationData

Név Leírás Érték
createOption Ez felsorolja a lemez létrehozásának lehetséges forrásait. "Csatolás"
"Másolás"
"Üres"
"FromImage"
"Importálás"
"Visszaállítás" (kötelező)
imageReference Lemezforrás adatai. ImageDiskReference
sourceResourceId Ha a createOption másolás, akkor ez a forrás pillanatképének vagy lemezének ARM-azonosítója. karakterlánc
sourceUri Ha a createOption importálás, akkor ez egy felügyelt lemezbe importálandó blob URI-ja. karakterlánc
storageAccountId Ha a createOption importálás, a lemezként importálandó blobot tartalmazó tárfiók Azure Resource Manager-azonosítója. Csak akkor szükséges, ha a blob másik előfizetésben található karakterlánc

DiskProperties

Név Leírás Érték
létrehozási adatok Lemezforrás adatai. A CreationData adatai a lemez létrehozása után nem módosíthatók. CreationData (kötelező)
diskSizeGB Ha a creationData.createOption üres, ez a mező kötelező, és a létrehozandó VHD méretét jelzi. Ha ez a mező frissítésekhez vagy más beállításokkal való létrehozáshoz van jelen, az átméretezést jelez. Az átméretezések csak akkor engedélyezettek, ha a lemez nincs futó virtuális géphez csatlakoztatva, és csak a lemez méretét növelheti. Int
titkosításBeállítások Lemez vagy pillanatkép titkosítási beállításai Titkosítás Beállítások
osType Az operációs rendszer típusa. "Linux"
"Windows"

Titkosítás Beállítások

Név Leírás Érték
diskEncryptionKey A Key Vault titkos url-címe és a lemeztitkosítási kulcs tárolóazonosítója KeyVaultAndSecretReference
Engedélyezve Állítsa ezt a jelzőt igaz értékre, és adja meg a DiskEncryptionKey és az opcionális KeyEncryptionKey értéket a titkosítás engedélyezéséhez. Állítsa ezt a jelzőt hamis értékre, és távolítsa el a DiskEncryptionKey és a KeyEncryptionKey elemet a titkosítás letiltásához. Ha a EncryptionSettings null értékű a kérelemobjektumban, a meglévő beállítások változatlanok maradnak. Bool
keyEncryptionKey Key Vault kulcs URL-címe és a kulcstitkosítási kulcs tárolóazonosítója KeyVaultAndKeyReference

ImageDiskReference

Név Leírás Érték
azonosító Egy relatív uri, amely platformrendszerkép-adattárat vagy felhasználói lemezkép-referenciát tartalmaz. sztring (kötelező)
Lun Ha a lemez egy lemez adatlemezéből jön létre, ez egy index, amely jelzi, hogy a lemezkép mely adatlemezeit használja. Operációsrendszer-lemezek esetén ez a mező null értékű. Int

KeyVaultAndKeyReference

Név Leírás Érték
kulcs URL-címe Kulcsra vagy titkos kulcsra mutató URL-cím a KeyVaultban sztring (kötelező)
sourceVault A kulcsot vagy titkos kulcsot tartalmazó KeyVault erőforrás-azonosítója SourceVault (kötelező)

KeyVaultAndSecretReference

Név Leírás Érték
secretUrl Kulcsra vagy titkos kulcsra mutató URL-cím a KeyVaultban sztring (kötelező)
sourceVault A kulcsot vagy titkos kulcsot tartalmazó KeyVault erőforrás-azonosítója SourceVault (kötelező)

Erőforrás címkék

Név Leírás Érték

SnapshotSku

Név Leírás Érték
név A termékváltozat neve. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

SourceVault

Név Leírás Érték
azonosító Erőforrás-azonosító karakterlánc

ARM-sablon erőforrásdefiníciója

A pillanatképek erőforrástípusa üzembe helyezhető a célműveletekkel:

Használati példák

Erőforrás formátuma

Microsoft.Compute/snapshots erőforrás létrehozásához adja hozzá a következő JSON-t a sablonhoz.

{
  "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"
  }
}

Tulajdonságértékek

Microsoft.Compute/pillanatképek

Név Leírás Érték
apiVersion Az API verziója '2018-04-01'
hely Erőforrás helye sztring (kötelező)
név Az erőforrás neve sztring (kötelező)
kellékek Lemezerőforrás tulajdonságai. DiskProperties
Sku A pillanatképek termékváltozatának neve. Lehet Standard_LRS, Premium_LRS vagy Standard_ZRS. SnapshotSku
Címkék Erőforráscímkék Címkenevek és -értékek szótára. sablonok címkéinek megtekintése
típus Az erőforrás típusa "Microsoft.Compute/snapshots"

CreationData

Név Leírás Érték
createOption Ez felsorolja a lemez létrehozásának lehetséges forrásait. "Csatolás"
"Másolás"
"Üres"
"FromImage"
"Importálás"
"Visszaállítás" (kötelező)
imageReference Lemezforrás adatai. ImageDiskReference
sourceResourceId Ha a createOption másolás, akkor ez a forrás pillanatképének vagy lemezének ARM-azonosítója. karakterlánc
sourceUri Ha a createOption importálás, akkor ez egy felügyelt lemezbe importálandó blob URI-ja. karakterlánc
storageAccountId Ha a createOption importálás, a lemezként importálandó blobot tartalmazó tárfiók Azure Resource Manager-azonosítója. Csak akkor szükséges, ha a blob másik előfizetésben található karakterlánc

DiskProperties

Név Leírás Érték
létrehozási adatok Lemezforrás adatai. A CreationData adatai a lemez létrehozása után nem módosíthatók. CreationData (kötelező)
diskSizeGB Ha a creationData.createOption üres, ez a mező kötelező, és a létrehozandó VHD méretét jelzi. Ha ez a mező frissítésekhez vagy más beállításokkal való létrehozáshoz van jelen, az átméretezést jelez. Az átméretezések csak akkor engedélyezettek, ha a lemez nincs futó virtuális géphez csatlakoztatva, és csak a lemez méretét növelheti. Int
titkosításBeállítások Lemez vagy pillanatkép titkosítási beállításai Titkosítás Beállítások
osType Az operációs rendszer típusa. "Linux"
"Windows"

Titkosítás Beállítások

Név Leírás Érték
diskEncryptionKey A Key Vault titkos url-címe és a lemeztitkosítási kulcs tárolóazonosítója KeyVaultAndSecretReference
Engedélyezve Állítsa ezt a jelzőt igaz értékre, és adja meg a DiskEncryptionKey és az opcionális KeyEncryptionKey értéket a titkosítás engedélyezéséhez. Állítsa ezt a jelzőt hamis értékre, és távolítsa el a DiskEncryptionKey és a KeyEncryptionKey elemet a titkosítás letiltásához. Ha a EncryptionSettings null értékű a kérelemobjektumban, a meglévő beállítások változatlanok maradnak. Bool
keyEncryptionKey Key Vault kulcs URL-címe és a kulcstitkosítási kulcs tárolóazonosítója KeyVaultAndKeyReference

ImageDiskReference

Név Leírás Érték
azonosító Egy relatív uri, amely platformrendszerkép-adattárat vagy felhasználói lemezkép-referenciát tartalmaz. sztring (kötelező)
Lun Ha a lemez egy lemez adatlemezéből jön létre, ez egy index, amely jelzi, hogy a lemezkép mely adatlemezeit használja. Operációsrendszer-lemezek esetén ez a mező null értékű. Int

KeyVaultAndKeyReference

Név Leírás Érték
kulcs URL-címe Kulcsra vagy titkos kulcsra mutató URL-cím a KeyVaultban sztring (kötelező)
sourceVault A kulcsot vagy titkos kulcsot tartalmazó KeyVault erőforrás-azonosítója SourceVault (kötelező)

KeyVaultAndSecretReference

Név Leírás Érték
secretUrl Kulcsra vagy titkos kulcsra mutató URL-cím a KeyVaultban sztring (kötelező)
sourceVault A kulcsot vagy titkos kulcsot tartalmazó KeyVault erőforrás-azonosítója SourceVault (kötelező)

Erőforrás címkék

Név Leírás Érték

SnapshotSku

Név Leírás Érték
név A termékváltozat neve. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

SourceVault

Név Leírás Érték
azonosító Erőforrás-azonosító karakterlánc

Terraform (AzAPI-szolgáltató) erőforrásdefiníciója

A pillanatképek erőforrástípusa üzembe helyezhető a célműveletekkel:

  • Erőforráscsoportok Az API verziók megváltoztatott tulajdonságainak listájáért lásd: Változásnapló.

Használati példák

Terraform minták

Alapvető példa a lemez pillanatképének üzembe helyezésére.

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"
    }
  }
}

Erőforrás formátuma

Microsoft.Compute/snapshots erőforrás létrehozásához adja hozzá a következő Terraformot a sablonhoz.

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"
    }
  }
}

Tulajdonságértékek

Microsoft.Compute/pillanatképek

Név Leírás Érték
hely Erőforrás helye sztring (kötelező)
név Az erőforrás neve sztring (kötelező)
kellékek Lemezerőforrás tulajdonságai. DiskProperties
Sku A pillanatképek termékváltozatának neve. Lehet Standard_LRS, Premium_LRS vagy Standard_ZRS. SnapshotSku
Címkék Erőforráscímkék Címkenevek és -értékek szótára.
típus Az erőforrás típusa "Microsoft.Compute/snapshots@2018-04-01"

CreationData

Név Leírás Érték
createOption Ez felsorolja a lemez létrehozásának lehetséges forrásait. "Csatolás"
"Másolás"
"Üres"
"FromImage"
"Importálás"
"Visszaállítás" (kötelező)
imageReference Lemezforrás adatai. ImageDiskReference
sourceResourceId Ha a createOption másolás, akkor ez a forrás pillanatképének vagy lemezének ARM-azonosítója. karakterlánc
sourceUri Ha a createOption importálás, akkor ez egy felügyelt lemezbe importálandó blob URI-ja. karakterlánc
storageAccountId Ha a createOption importálás, a lemezként importálandó blobot tartalmazó tárfiók Azure Resource Manager-azonosítója. Csak akkor szükséges, ha a blob másik előfizetésben található karakterlánc

DiskProperties

Név Leírás Érték
létrehozási adatok Lemezforrás adatai. A CreationData adatai a lemez létrehozása után nem módosíthatók. CreationData (kötelező)
diskSizeGB Ha a creationData.createOption üres, ez a mező kötelező, és a létrehozandó VHD méretét jelzi. Ha ez a mező frissítésekhez vagy más beállításokkal való létrehozáshoz van jelen, az átméretezést jelez. Az átméretezések csak akkor engedélyezettek, ha a lemez nincs futó virtuális géphez csatlakoztatva, és csak a lemez méretét növelheti. Int
titkosításBeállítások Lemez vagy pillanatkép titkosítási beállításai Titkosítás Beállítások
osType Az operációs rendszer típusa. "Linux"
"Windows"

Titkosítás Beállítások

Név Leírás Érték
diskEncryptionKey A Key Vault titkos url-címe és a lemeztitkosítási kulcs tárolóazonosítója KeyVaultAndSecretReference
Engedélyezve Állítsa ezt a jelzőt igaz értékre, és adja meg a DiskEncryptionKey és az opcionális KeyEncryptionKey értéket a titkosítás engedélyezéséhez. Állítsa ezt a jelzőt hamis értékre, és távolítsa el a DiskEncryptionKey és a KeyEncryptionKey elemet a titkosítás letiltásához. Ha a EncryptionSettings null értékű a kérelemobjektumban, a meglévő beállítások változatlanok maradnak. Bool
keyEncryptionKey Key Vault kulcs URL-címe és a kulcstitkosítási kulcs tárolóazonosítója KeyVaultAndKeyReference

ImageDiskReference

Név Leírás Érték
azonosító Egy relatív uri, amely platformrendszerkép-adattárat vagy felhasználói lemezkép-referenciát tartalmaz. sztring (kötelező)
Lun Ha a lemez egy lemez adatlemezéből jön létre, ez egy index, amely jelzi, hogy a lemezkép mely adatlemezeit használja. Operációsrendszer-lemezek esetén ez a mező null értékű. Int

KeyVaultAndKeyReference

Név Leírás Érték
kulcs URL-címe Kulcsra vagy titkos kulcsra mutató URL-cím a KeyVaultban sztring (kötelező)
sourceVault A kulcsot vagy titkos kulcsot tartalmazó KeyVault erőforrás-azonosítója SourceVault (kötelező)

KeyVaultAndSecretReference

Név Leírás Érték
secretUrl Kulcsra vagy titkos kulcsra mutató URL-cím a KeyVaultban sztring (kötelező)
sourceVault A kulcsot vagy titkos kulcsot tartalmazó KeyVault erőforrás-azonosítója SourceVault (kötelező)

Erőforrás címkék

Név Leírás Érték

SnapshotSku

Név Leírás Érték
név A termékváltozat neve. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

SourceVault

Név Leírás Érték
azonosító Erőforrás-azonosító karakterlánc