Compartilhar via


Imagens microsoft.compute 2023-07-01

Definição de recurso do Bicep

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 de log de alterações.

Formato de recurso

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

resource symbolicname 'Microsoft.Compute/images@2023-07-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

Imagens

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

Limite de caracteres: 1 a 80

Caracteres válidos:
Alfanuméricos, sublinhados, períodos e hifens.

Comece com alfanumérico. Termine com alfanumérico ou sublinhado.
localização Local do recurso cadeia de caracteres (obrigatório)
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos
extendedLocation O local estendido da Imagem. ExtendedLocation
Propriedades Descreve as propriedades de uma imagem. ImageProperties

ExtendedLocation

Nome Descrição Valor
nome O nome do local estendido. corda
tipo 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 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. sub-recurso
storageProfile Especifica as configurações de armazenamento para os discos da máquina virtual. ImageStorageProfile

SubResource

Nome Descrição Valor
id ID do recurso corda

ImageStorageProfile

Nome Descrição Valor
dataDisks Especifica os parâmetros 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. corda
Cache Especifica os requisitos de cache. Os valores possíveis são: None,ReadOnlyReadWrite. 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 de 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. sub-recurso
instantâneo O instantâneo. sub-recurso
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 corda

ImageOSDisk

Nome Descrição Valor
blobUri O Disco Rígido Virtual. corda
Cache Especifica os requisitos de cache. Os valores possíveis são: None,ReadOnlyReadWrite. 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. sub-recurso
osState O estado do sistema operacional. Para imagens gerenciadas, use Generalized. 'Generalizado'
'Especializado' (obrigatório)
osType Essa propriedade permite que você especifique o tipo do sistema operacional incluído no disco se criar uma VM a partir de uma imagem personalizada. Os valores possíveis são: Windows,Linux. 'Linux'
'Windows' (obrigatório)
instantâneo O instantâneo. sub-recurso
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 em de imagem do usuário

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

Implantar no Azure
Esse modelo cria uma VM com base em 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 VM 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 a 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 sua VM na mesma assinatura e região em que você cria o VMSS.
implantar um conjunto de dimensionamento de VM com uma imagem personalizada do Windows

Implantar no Azure
Esse modelo permite implantar um conjunto de dimensionamento de VM simples que usa uma imagem personalizada do Windows. Essas VMs estão por trá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 de 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-07-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

Imagens

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

Limite de caracteres: 1 a 80

Caracteres válidos:
Alfanuméricos, sublinhados, períodos e hifens.

Comece com alfanumérico. Termine com alfanumérico ou sublinhado.
localização Local do recurso cadeia de caracteres (obrigatório)
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos
extendedLocation O local estendido da Imagem. ExtendedLocation
Propriedades Descreve as propriedades de uma imagem. ImageProperties

ExtendedLocation

Nome Descrição Valor
nome O nome do local estendido. corda
tipo 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 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. sub-recurso
storageProfile Especifica as configurações de armazenamento para os discos da máquina virtual. ImageStorageProfile

SubResource

Nome Descrição Valor
id ID do recurso corda

ImageStorageProfile

Nome Descrição Valor
dataDisks Especifica os parâmetros 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. corda
Cache Especifica os requisitos de cache. Os valores possíveis são: None,ReadOnlyReadWrite. 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 de 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. sub-recurso
instantâneo O instantâneo. sub-recurso
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 corda

ImageOSDisk

Nome Descrição Valor
blobUri O Disco Rígido Virtual. corda
Cache Especifica os requisitos de cache. Os valores possíveis são: None,ReadOnlyReadWrite. 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. sub-recurso
osState O estado do sistema operacional. Para imagens gerenciadas, use Generalized. 'Generalizado'
'Especializado' (obrigatório)
osType Essa propriedade permite que você especifique o tipo do sistema operacional incluído no disco se criar uma VM a partir de uma imagem personalizada. Os valores possíveis são: Windows,Linux. 'Linux'
'Windows' (obrigatório)
instantâneo O instantâneo. sub-recurso
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 em de imagem do usuário

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

Implantar no Azure
Esse modelo cria uma VM com base em 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 VM 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 a 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 sua VM na mesma assinatura e região em que você cria o VMSS.
implantar um conjunto de dimensionamento de VM com uma imagem personalizada do Windows

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

Definição de recurso do Terraform (provedor de 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 de log de alterações.

Formato de recurso

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/images@2023-07-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

Imagens

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

Limite de caracteres: 1 a 80

Caracteres válidos:
Alfanuméricos, sublinhados, períodos e hifens.

Comece com alfanumérico. Termine com alfanumérico ou sublinhado.
localização Local 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)
Tags Marcas de recurso Dicionário de nomes e valores de marca.
extendedLocation O local estendido da Imagem. ExtendedLocation
Propriedades Descreve as propriedades de uma imagem. ImageProperties

ExtendedLocation

Nome Descrição Valor
nome O nome do local estendido. corda
tipo 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 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. sub-recurso
storageProfile Especifica as configurações de armazenamento para os discos da máquina virtual. ImageStorageProfile

SubResource

Nome Descrição Valor
id ID do recurso corda

ImageStorageProfile

Nome Descrição Valor
dataDisks Especifica os parâmetros 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. corda
Cache Especifica os requisitos de cache. Os valores possíveis são: None,ReadOnlyReadWrite. Os valores padrão são: Nenhum para armazenamento Standard. ReadOnly para armazenamento Premium. "Nenhum"
"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 de 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. sub-recurso
instantâneo O instantâneo. sub-recurso
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 corda

ImageOSDisk

Nome Descrição Valor
blobUri O Disco Rígido Virtual. corda
Cache Especifica os requisitos de cache. Os valores possíveis são: None,ReadOnlyReadWrite. Os valores padrão são: Nenhum para armazenamento Standard. ReadOnly para armazenamento Premium. "Nenhum"
"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. sub-recurso
osState O estado do sistema operacional. Para imagens gerenciadas, use Generalized. "Generalizado"
"Especializado" (obrigatório)
osType Essa propriedade permite que você especifique o tipo do sistema operacional incluído no disco se criar uma VM a partir de uma imagem personalizada. Os valores possíveis são: Windows,Linux. "Linux"
"Windows" (obrigatório)
instantâneo O instantâneo. sub-recurso
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"