Share via

Microsoft.Compute images 2023-09-01

  • Artigo

Definição de recurso do Bicep

O tipo de recurso de imagens pode ser implantado com operações direcionadas:

Para obter uma lista das propriedades alteradas em cada versão da API, consulte log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Compute/images, adicione o Bicep a seguir ao modelo.

resource symbolicname 'Microsoft.Compute/images@2023-09-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  extendedLocation: {
    name: 'string'
    type: 'EdgeZone'
  }
  properties: {
    hyperVGeneration: 'string'
    sourceVirtualMachine: {
      id: 'string'
    }
    storageProfile: {
      dataDisks: [
        {
          blobUri: 'string'
          caching: 'string'
          diskEncryptionSet: {
            id: 'string'
          }
          diskSizeGB: int
          lun: int
          managedDisk: {
            id: 'string'
          }
          snapshot: {
            id: 'string'
          }
          storageAccountType: 'string'
        }
      ]
      osDisk: {
        blobUri: 'string'
        caching: 'string'
        diskEncryptionSet: {
          id: 'string'
        }
        diskSizeGB: int
        managedDisk: {
          id: 'string'
        }
        osState: 'string'
        osType: 'string'
        snapshot: {
          id: 'string'
        }
        storageAccountType: 'string'
      }
      zoneResilient: bool
    }
  }
}

Valores de propriedade

images

Nome Descrição Valor
name O nome do recurso cadeia de caracteres (obrigatório)

Limite de caracteres: 1 a 80

Caracteres válidos:
Caracteres alfanuméricos, sublinhados, pontos e hifens.

Comece com caractere alfanumérico. Termine com caractere alfanumérico ou sublinhado.
local Localização do recurso cadeia de caracteres (obrigatório)
marcas Marcações de recursos Dicionário de nomes e valores de marcas. Confira Marcas em modelos
extendedLocation O local estendido da Imagem. ExtendedLocation
properties Descreve as propriedades de uma Imagem. ImageProperties

ExtendedLocation

Nome Descrição Valor
name O nome do local estendido. string
type O tipo do local estendido. 'EdgeZone'

ImageProperties

Nome Descrição Valor
hyperVGeneration Especifica o HyperVGenerationType do VirtualMachine criado a partir da imagem. Na Versão da API 2019-03-01 se a origem da imagem for um blob, precisamos que o usuário especifique o valor, se a origem for um recurso gerenciado, como disco ou instantâneo, poderemos exigir que o usuário especifique a propriedade se não pudermos deduzê-la do recurso gerenciado de origem. 'V1'
'V2'
sourceVirtualMachine A máquina virtual de origem da qual a Imagem é criada. SubResource
storageProfile Especifica as configurações de armazenamento dos discos da máquina virtual. ImageStorageProfile

SubResource

Nome Descrição Valor
id ID do recurso string

ImageStorageProfile

Nome Descrição Valor
dataDisks Especifica os parâmetros que são usados para adicionar um disco de dados a uma máquina virtual.

Para obter mais informações sobre discos, consulte Sobre discos e VHDs para máquinas virtuais do Azure.		 ImageDataDisk[]
osDisk Especifica informações sobre o disco do sistema operacional usado pela máquina virtual.

Para obter mais informações sobre discos, consulte Sobre discos e VHDs para máquinas virtuais do Azure.		 ImageOSDisk
zoneResilient Especifica se uma imagem é resiliente à zona ou não. O padrão é false. As imagens resilientes à zona só podem ser criadas em regiões que fornecem ZRS (Armazenamento com Redundância de Zona). bool

ImageDataDisk

Nome Descrição Valor
blobUri O disco rígido virtual. string
cache Especifica os requisitos de cache. Os valores possíveis são: None,ReadOnly,ReadWrite. Os valores padrão são: Nenhum para armazenamento Standard. ReadOnly para armazenamento Premium. 'None'
'ReadOnly'
'ReadWrite'
diskEncryptionSet Especifica a ID do recurso do conjunto de criptografia de disco gerenciado pelo cliente para o disco de imagem gerenciada. DiskEncryptionSetParameters
diskSizeGB Especifica o tamanho dos discos de dados vazios em gigabytes. Esse elemento pode ser usado para substituir o nome do disco em uma imagem de máquina virtual. Esse valor não pode ser maior que 1023 GB. INT
lun Especifica o número da unidade lógica do disco de dados. Esse valor é usado para identificar discos de dados dentro da VM e, portanto, deve ser exclusivo para cada disco de dados anexado a uma VM. int (obrigatório)
managedDisk O managedDisk. SubResource
instantâneo O instantâneo. SubResource
storageAccountType Especifica o tipo de conta de armazenamento para o disco gerenciado. OBSERVAÇÃO: UltraSSD_LRS só pode ser usado com discos de dados, ele não pode ser usado com o disco do sistema operacional. 'PremiumV2_LRS'
'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'
'UltraSSD_LRS'

DiskEncryptionSetParameters

Nome Descrição Valor
id ID do recurso string

ImageOSDisk

Nome Descrição Valor
blobUri O disco rígido virtual. string
cache Especifica os requisitos de cache. Os valores possíveis são: None,ReadOnly,ReadWrite. Os valores padrão são: Nenhum para armazenamento Standard. ReadOnly para armazenamento Premium. 'None'
'ReadOnly'
'ReadWrite'
diskEncryptionSet Especifica a ID do recurso do conjunto de criptografia de disco gerenciado pelo cliente para o disco de imagem gerenciada. DiskEncryptionSetParameters
diskSizeGB Especifica o tamanho dos discos de dados vazios em gigabytes. Esse elemento pode ser usado para substituir o nome do disco em uma imagem de máquina virtual. Esse valor não pode ser maior que 1023 GB. INT
managedDisk O managedDisk. SubResource
osState O estado do sistema operacional. Para imagens gerenciadas, use Generalizado. 'Generalizado'
'Specialized' (obrigatório)
osType Essa propriedade permite que você especifique o tipo do sistema operacional incluído no disco se estiver criando uma VM de uma imagem personalizada. Os valores possíveis são: Windows,Linux. 'Linux'
'Windows' (obrigatório)
instantâneo O instantâneo. SubResource
storageAccountType Especifica o tipo de conta de armazenamento para o disco gerenciado. OBSERVAÇÃO: UltraSSD_LRS só pode ser usado com discos de dados, ele não pode ser usado com o disco do sistema operacional. 'PremiumV2_LRS'
'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'
'UltraSSD_LRS'

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Criar uma VM com base na imagem do usuário

Implantar no Azure		 Esse modelo permite que você crie uma Máquinas Virtuais de uma imagem de Usuário. Esse modelo também implanta um Rede Virtual, endereços IP públicos e um adaptador de rede.
Criar uma VM em uma vnet nova ou existente a partir de um VHD generalizado

Implantar no Azure		 Este modelo cria uma VM de um VHD generalizado e permite conectá-la a uma VNET nova ou existente que pode residir em outro Grupo de Recursos do que a máquina virtual
Implantar um Conjunto de Dimensionamento de VMs com uma imagem personalizada do Linux

Implantar no Azure		 Esse modelo permite implantar uma imagem personalizada do Linux de VM dentro de um Conjunto de Dimensionamento. Essas VMs estão atrás de um balanceador de carga com balanceamento de carga HTTP (por padrão, na porta 80). O exemplo usa um script personalizado para fazer a implantação e atualização do aplicativo, talvez seja necessário fornecer seu script personalizado para seu próprio procedimento de atualização. Você precisará fornecer uma imagem generalizada da VM na mesma assinatura e região em que você cria o VMSS.
Implantar um Conjunto de Dimensionamento de VMs com uma imagem personalizada do Windows

Implantar no Azure		 Esse modelo permite implantar um conjunto de dimensionamento de VMs simples usando uma imagem personalizada do Windows. Essas VMs estão atrás de um balanceador de carga com balanceamento de carga HTTP (por padrão, na porta 80)

Definição de recurso de modelo do ARM

O tipo de recurso de imagens pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Compute/images, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.Compute/images",
  "apiVersion": "2023-09-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "extendedLocation": {
    "name": "string",
    "type": "EdgeZone"
  },
  "properties": {
    "hyperVGeneration": "string",
    "sourceVirtualMachine": {
      "id": "string"
    },
    "storageProfile": {
      "dataDisks": [
        {
          "blobUri": "string",
          "caching": "string",
          "diskEncryptionSet": {
            "id": "string"
          },
          "diskSizeGB": "int",
          "lun": "int",
          "managedDisk": {
            "id": "string"
          },
          "snapshot": {
            "id": "string"
          },
          "storageAccountType": "string"
        }
      ],
      "osDisk": {
        "blobUri": "string",
        "caching": "string",
        "diskEncryptionSet": {
          "id": "string"
        },
        "diskSizeGB": "int",
        "managedDisk": {
          "id": "string"
        },
        "osState": "string",
        "osType": "string",
        "snapshot": {
          "id": "string"
        },
        "storageAccountType": "string"
      },
      "zoneResilient": "bool"
    }
  }
}

Valores de propriedade

images

Nome Descrição Valor
tipo O tipo de recurso 'Microsoft.Compute/images'
apiVersion A versão da API de recursos '2023-09-01'
name O nome do recurso cadeia de caracteres (obrigatório)

Limite de caracteres: 1 a 80

Caracteres válidos:
Caracteres alfanuméricos, sublinhados, pontos e hifens.

Comece com caractere alfanumérico. Termine com caractere alfanumérico ou sublinhado.
local Localização do recurso cadeia de caracteres (obrigatório)
marcas Marcações de recursos Dicionário de nomes e valores de marcas. Consulte Marcas em modelos
extendedLocation O local estendido da Imagem. ExtendedLocation
properties Descreve as propriedades de uma Imagem. ImageProperties

ExtendedLocation

Nome Descrição Valor
name O nome do local estendido. string
type O tipo do local estendido. 'EdgeZone'

ImageProperties

Nome Descrição Valor
hyperVGeneration Especifica o HyperVGenerationType do VirtualMachine criado a partir da imagem. Na API versão 2019-03-01 se a origem da imagem for um blob, precisamos que o usuário especifique o valor, se a origem for gerenciada, como disco ou instantâneo, poderemos exigir que o usuário especifique a propriedade se não pudermos deduzê-la do recurso gerenciado de origem. 'V1'
'V2'
sourceVirtualMachine A máquina virtual de origem da qual a Imagem é criada. SubResource
storageProfile Especifica as configurações de armazenamento dos discos da máquina virtual. ImageStorageProfile

SubResource

Nome Descrição Valor
id ID do recurso string

ImageStorageProfile

Nome Descrição Valor
dataDisks Especifica os parâmetros que são usados para adicionar um disco de dados a uma máquina virtual.

Para obter mais informações sobre discos, consulte Sobre discos e VHDs para máquinas virtuais do Azure.		 ImageDataDisk[]
osDisk Especifica informações sobre o disco do sistema operacional usado pela máquina virtual.

Para obter mais informações sobre discos, consulte Sobre discos e VHDs para máquinas virtuais do Azure.		 ImageOSDisk
zoneResilient Especifica se uma imagem é resiliente à zona ou não. O padrão é false. As imagens resilientes à zona só podem ser criadas em regiões que fornecem ZRS (Armazenamento com Redundância de Zona). bool

ImageDataDisk

Nome Descrição Valor
blobUri O disco rígido virtual. string
cache Especifica os requisitos de cache. Os valores possíveis são: None,ReadOnly,ReadWrite. Os valores padrão são: Nenhum para armazenamento Standard. ReadOnly para armazenamento Premium. 'None'
'ReadOnly'
'ReadWrite'
diskEncryptionSet Especifica a ID do recurso do conjunto de criptografia de disco gerenciado pelo cliente para o disco de imagem gerenciada. DiskEncryptionSetParameters
diskSizeGB Especifica o tamanho dos discos de dados vazios em gigabytes. Esse elemento pode ser usado para substituir o nome do disco em uma imagem de máquina virtual. Esse valor não pode ser maior que 1023 GB. INT
lun Especifica o número da unidade lógica do disco de dados. Esse valor é usado para identificar discos de dados dentro da VM e, portanto, deve ser exclusivo para cada disco de dados anexado a uma VM. int (obrigatório)
managedDisk O managedDisk. SubResource
instantâneo O instantâneo. SubResource
storageAccountType Especifica o tipo de conta de armazenamento para o disco gerenciado. OBSERVAÇÃO: UltraSSD_LRS só pode ser usado com discos de dados, ele não pode ser usado com o disco do sistema operacional. 'PremiumV2_LRS'
'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'
'UltraSSD_LRS'

DiskEncryptionSetParameters

Nome Descrição Valor
id ID do recurso string

ImageOSDisk

Nome Descrição Valor
blobUri O disco rígido virtual. string
cache Especifica os requisitos de cache. Os valores possíveis são: None,ReadOnly,ReadWrite. Os valores padrão são: Nenhum para armazenamento Standard. ReadOnly para armazenamento Premium. 'None'
'ReadOnly'
'ReadWrite'
diskEncryptionSet Especifica a ID do recurso do conjunto de criptografia de disco gerenciado pelo cliente para o disco de imagem gerenciada. DiskEncryptionSetParameters
diskSizeGB Especifica o tamanho dos discos de dados vazios em gigabytes. Esse elemento pode ser usado para substituir o nome do disco em uma imagem de máquina virtual. Esse valor não pode ser maior que 1023 GB. INT
managedDisk O managedDisk. SubResource
osState O estado do sistema operacional. Para imagens gerenciadas, use Generalizado. 'Generalizado'
'Specialized' (obrigatório)
osType Essa propriedade permite que você especifique o tipo do sistema operacional incluído no disco se estiver criando uma VM de uma imagem personalizada. Os valores possíveis são: Windows,Linux. 'Linux'
'Windows' (obrigatório)
instantâneo O instantâneo. SubResource
storageAccountType Especifica o tipo de conta de armazenamento para o disco gerenciado. OBSERVAÇÃO: UltraSSD_LRS só pode ser usado com discos de dados, ele não pode ser usado com o disco do sistema operacional. 'PremiumV2_LRS'
'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'
'UltraSSD_LRS'

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Criar uma VM com base na imagem do usuário

Implantar no Azure		 Esse modelo permite que você crie uma Máquinas Virtuais de uma imagem de Usuário. Esse modelo também implanta um Rede Virtual, endereços IP públicos e um adaptador de rede.
Criar uma VM em uma vnet nova ou existente a partir de um VHD generalizado

Implantar no Azure		 Este modelo cria uma VM de um VHD generalizado e permite conectá-la a uma VNET nova ou existente que pode residir em outro Grupo de Recursos do que a máquina virtual
Implantar um Conjunto de Dimensionamento de VMs com uma imagem personalizada do Linux

Implantar no Azure		 Esse modelo permite implantar uma imagem personalizada do Linux de VM dentro de um Conjunto de Dimensionamento. Essas VMs estão atrás de um balanceador de carga com balanceamento de carga HTTP (por padrão, na porta 80). O exemplo usa um script personalizado para fazer a implantação e atualização do aplicativo, talvez seja necessário fornecer seu script personalizado para seu próprio procedimento de atualização. Você precisará fornecer uma imagem generalizada da VM na mesma assinatura e região em que você cria o VMSS.
Implantar um Conjunto de Dimensionamento de VMs com uma imagem personalizada do Windows

Implantar no Azure		 Esse modelo permite implantar um conjunto de dimensionamento de VMs simples usando uma imagem personalizada do Windows. Essas VMs estão atrás de um balanceador de carga com balanceamento de carga HTTP (por padrão, na porta 80)

Definição de recurso do Terraform (provedor AzAPI)

O tipo de recurso de imagens pode ser implantado com operações direcionadas:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Compute/images, adicione o Terraform a seguir ao modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/images@2023-09-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      hyperVGeneration = "string"
      sourceVirtualMachine = {
        id = "string"
      }
      storageProfile = {
        dataDisks = [
          {
            blobUri = "string"
            caching = "string"
            diskEncryptionSet = {
              id = "string"
            }
            diskSizeGB = int
            lun = int
            managedDisk = {
              id = "string"
            }
            snapshot = {
              id = "string"
            }
            storageAccountType = "string"
          }
        ]
        osDisk = {
          blobUri = "string"
          caching = "string"
          diskEncryptionSet = {
            id = "string"
          }
          diskSizeGB = int
          managedDisk = {
            id = "string"
          }
          osState = "string"
          osType = "string"
          snapshot = {
            id = "string"
          }
          storageAccountType = "string"
        }
        zoneResilient = bool
      }
    }
    extendedLocation = {
      name = "string"
      type = "EdgeZone"
    }
  })
}

Valores de propriedade

images

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.Compute/images@2023-09-01"
name O nome do recurso cadeia de caracteres (obrigatório)

Limite de caracteres: 1 a 80

Caracteres válidos:
Caracteres alfanuméricos, sublinhados, pontos e hifens.

Comece com caractere alfanumérico. Termine com caractere alfanumérico ou sublinhado.
local Localização do recurso cadeia de caracteres (obrigatório)
parent_id Para implantar em um grupo de recursos, use a ID desse grupo de recursos. cadeia de caracteres (obrigatório)
marcas Marcações de recursos Dicionário de nomes e valores de marcas.
extendedLocation O local estendido da Imagem. ExtendedLocation
properties Descreve as propriedades de uma Imagem. ImageProperties

ExtendedLocation

Nome Descrição Valor
name O nome do local estendido. string
type O tipo do local estendido. "EdgeZone"

ImageProperties

Nome Descrição Valor
hyperVGeneration Especifica o HyperVGenerationType do VirtualMachine criado a partir da imagem. Na API versão 2019-03-01 se a origem da imagem for um blob, precisamos que o usuário especifique o valor, se a origem for gerenciada, como disco ou instantâneo, poderemos exigir que o usuário especifique a propriedade se não pudermos deduzê-la do recurso gerenciado de origem. "V1"
"V2"
sourceVirtualMachine A máquina virtual de origem da qual a Imagem é criada. SubResource
storageProfile Especifica as configurações de armazenamento dos discos da máquina virtual. ImageStorageProfile

SubResource

Nome Descrição Valor
id ID do recurso string

ImageStorageProfile

Nome Descrição Valor
dataDisks Especifica os parâmetros que são usados para adicionar um disco de dados a uma máquina virtual.

Para obter mais informações sobre discos, consulte Sobre discos e VHDs para máquinas virtuais do Azure.		 ImageDataDisk[]
osDisk Especifica informações sobre o disco do sistema operacional usado pela máquina virtual.

Para obter mais informações sobre discos, consulte Sobre discos e VHDs para máquinas virtuais do Azure.		 ImageOSDisk
zoneResilient Especifica se uma imagem é resiliente à zona ou não. O padrão é false. As imagens resilientes à zona só podem ser criadas em regiões que fornecem ZRS (Armazenamento com Redundância de Zona). bool

ImageDataDisk

Nome Descrição Valor
blobUri O Disco Rígido Virtual. string
cache Especifica os requisitos de cache. Os valores possíveis são: None,ReadOnly,ReadWrite. Os valores padrão são: Nenhum para armazenamento Standard. ReadOnly para armazenamento Premium. "None"
"ReadOnly"
"ReadWrite"
diskEncryptionSet Especifica a ID do recurso do conjunto de criptografia de disco gerenciado pelo cliente para o disco de imagem gerenciada. DiskEncryptionSetParameters
diskSizeGB Especifica o tamanho de discos de dados vazios em gigabytes. Esse elemento pode ser usado para substituir o nome do disco em uma imagem de máquina virtual. Esse valor não pode ser maior que 1023 GB. INT
lun Especifica o número da unidade lógica do disco de dados. Esse valor é usado para identificar discos de dados dentro da VM e, portanto, deve ser exclusivo para cada disco de dados anexado a uma VM. int (obrigatório)
managedDisk O managedDisk. SubResource
instantâneo O instantâneo. SubResource
storageAccountType Especifica o tipo de conta de armazenamento para o disco gerenciado. OBSERVAÇÃO: UltraSSD_LRS só pode ser usado com discos de dados, ele não pode ser usado com disco do sistema operacional. "PremiumV2_LRS"
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"

DiskEncryptionSetParameters

Nome Descrição Valor
id ID do recurso string

ImageOSDisk

Nome Descrição Valor
blobUri O Disco Rígido Virtual. string
cache Especifica os requisitos de cache. Os valores possíveis são: None,ReadOnly,ReadWrite. Os valores padrão são: Nenhum para armazenamento Standard. ReadOnly para armazenamento Premium. "None"
"ReadOnly"
"ReadWrite"
diskEncryptionSet Especifica a ID do recurso do conjunto de criptografia de disco gerenciado pelo cliente para o disco de imagem gerenciada. DiskEncryptionSetParameters
diskSizeGB Especifica o tamanho de discos de dados vazios em gigabytes. Esse elemento pode ser usado para substituir o nome do disco em uma imagem de máquina virtual. Esse valor não pode ser maior que 1023 GB. INT
managedDisk O managedDisk. SubResource
osState O estado do sistema operacional. Para imagens gerenciadas, use Generalizado. "Generalizado"
"Especializado" (obrigatório)
osType Essa propriedade permite que você especifique o tipo do sistema operacional incluído no disco se estiver criando uma VM de uma imagem personalizada. Os valores possíveis são: Windows,Linux. “Linux”
"Windows" (obrigatório)
instantâneo O instantâneo. SubResource
storageAccountType Especifica o tipo de conta de armazenamento para o disco gerenciado. OBSERVAÇÃO: UltraSSD_LRS só pode ser usado com discos de dados, ele não pode ser usado com disco do sistema operacional. "PremiumV2_LRS"
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"