Partilhar via

Imagens Microsoft.Compute 2023-09-01

  • Artigo

Definição de recurso do Bicep

O tipo de recurso de imagens pode ser implementado com operações que visam:

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

Formato do recurso

Para criar um recurso Microsoft.Compute/images, adicione o seguinte Bicep ao seu 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

imagens

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

Limite de carateres: 1-80

Carateres válidos:
Alfanuméricos, carateres de sublinhado, períodos e hífenes.

Comece com alfanumérico. Termine com caráter alfanumérico ou caráter de sublinhado.
localização Localização do recurso cadeia (obrigatório)
etiquetas Etiquetas de recursos Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
extendedLocation A localização expandida da Imagem. ExtendedLocation
propriedades Descreve as propriedades de uma Imagem. ImageProperties

ExtendedLocation

Nome Descrição Valor
name O nome da localização expandida. string
tipo O tipo de localização expandida. 'EdgeZone'

ImageProperties

Nome Descrição Valor
hyperVGeneration Especifica o HyperVGenerationType da VirtualMachine criada a partir da imagem. A partir da Versão 2019-03-01 da API, se a origem da imagem for um blob, precisamos que o utilizador especifique o valor, se a origem for um recurso gerido como disco ou instantâneo, poderemos exigir que o utilizador especifique a propriedade se não a conseguirmos deduzir do recurso gerido de origem. 'V1'
'V2'
sourceVirtualMachine A máquina virtual de origem a partir da qual a Imagem é criada. Sub-origem
storageProfile Especifica as definições de armazenamento para os discos da máquina virtual. ImageStorageProfile

Sub-origem

Nome Descrição Valor
ID ID do Recurso string

ImageStorageProfile

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

Para obter mais informações sobre discos, veja About disks and VHDs for Azure virtual machines (Acerca de discos e VHDs para máquinas virtuais do Azure).		 ImageDataDisk[]
osDisk Especifica informações sobre o disco do sistema operativo utilizado pela máquina virtual.

Para obter mais informações sobre discos, veja About disks and VHDs for Azure virtual machines (Acerca de discos e VHDs para máquinas virtuais do Azure).		 ImageOSDisk
zoneResilient Especifica se uma imagem é resiliente ou não à zona. A predefinição é falso. As imagens resilientes à zona só podem ser criadas em regiões que fornecem Armazenamento Com Redundância entre Zonas (ZRS). bool

ImageDataDisk

Nome Descrição Valor
blobUri O Disco Rígido Virtual. string
colocação em cache Especifica os requisitos de colocação em cache. Os valores possíveis são: None,ReadOnly,ReadWrite. Os valores predefinidos são: Nenhum para o armazenamento Standard. ReadOnly para armazenamento Premium. "Nenhum"
'ReadOnly'
"ReadWrite"
diskEncryptionSet Especifica o ID de recurso do conjunto de encriptação de disco gerido pelo cliente para o disco de imagem gerida. DiskEncryptionSetParameters
diskSizeGB Especifica o tamanho dos discos de dados vazios em gigabytes. Este elemento pode ser utilizado para substituir o nome do disco numa imagem de máquina virtual. Este valor não pode ser superior a 1023 GB. int
lun Especifica o número de unidade lógica do disco de dados. Este valor é utilizado para identificar discos de dados na VM e, por conseguinte, tem de ser exclusivo para cada disco de dados anexado a uma VM. int (obrigatório)
managedDisk O managedDisk. Sub-origem
instantâneo O instantâneo. Sub-origem
storageAccountType Especifica o tipo de conta de armazenamento para o disco gerido. NOTA: UltraSSD_LRS só podem ser utilizadas com discos de dados, não podem ser utilizadas com o Disco do SO. '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
colocação em cache Especifica os requisitos de colocação em cache. Os valores possíveis são: None,ReadOnly,ReadWrite. Os valores predefinidos são: Nenhum para o armazenamento Standard. ReadOnly para armazenamento Premium. "Nenhum"
'ReadOnly'
"ReadWrite"
diskEncryptionSet Especifica o ID de recurso do conjunto de encriptação de disco gerido pelo cliente para o disco de imagem gerida. DiskEncryptionSetParameters
diskSizeGB Especifica o tamanho dos discos de dados vazios em gigabytes. Este elemento pode ser utilizado para substituir o nome do disco numa imagem de máquina virtual. Este valor não pode ser superior a 1023 GB. int
managedDisk O managedDisk. Sub-origem
osState Estado do SO. Para imagens geridas, utilize Generalized. "Generalizado"
"Especializado" (obrigatório)
osType Esta propriedade permite-lhe especificar o tipo de SO 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-origem
storageAccountType Especifica o tipo de conta de armazenamento para o disco gerido. NOTA: UltraSSD_LRS só podem ser utilizadas com discos de dados, não podem ser utilizadas com o Disco do SO. 'PremiumV2_LRS'
'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'
'UltraSSD_LRS'

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo Description
Criar uma VM a partir da Imagem de Utilizador

Implementar no Azure		 Este modelo permite-lhe criar um Máquinas Virtuais a partir de uma imagem de Utilizador. Este modelo também implementa um Rede Virtual, endereços IP públicos e uma Interface de Rede.
Criar uma VM numa vnet nova ou existente a partir de um VHD generalizado

Implementar no Azure		 Este modelo cria uma VM a partir de um VHD generalizado e permite-lhe ligá-la a uma VNET nova ou existente que pode residir noutro Grupo de Recursos do que na máquina virtual
Implementar um Conjunto de Dimensionamento de VMs com uma imagem personalizada do Linux

Implementar no Azure		 Este modelo permite-lhe implementar uma imagem do Linux de VM personalizada dentro de um Conjunto de Dimensionamento. Estas VMs estão atrás de um balanceador de carga com balanceamento de carga HTTP (por predefinição na porta 80). O exemplo utiliza um script personalizado para efetuar a implementação e atualização da aplicação. Poderá ter de fornecer o script personalizado para o seu próprio procedimento de atualização. Terá de fornecer uma imagem generalizada da sua VM na mesma subscrição e região onde cria o VMSS.
Implementar um Conjunto de Dimensionamento de VMs com uma imagem personalizada do Windows

Implementar no Azure		 Este modelo permite-lhe implementar um Conjunto de Dimensionamento de VMs simples com uma imagem personalizada do Windows. Estas VMs estão atrás de um balanceador de carga com balanceamento de carga HTTP (por predefinição na porta 80)

Definição de recurso de modelo do ARM

O tipo de recurso de imagens pode ser implementado com operações que visam:

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

Formato do recurso

Para criar um recurso Microsoft.Compute/images, adicione o seguinte JSON ao seu 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

imagens

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 (obrigatório)

Limite de carateres: 1-80

Carateres válidos:
Alfanuméricos, carateres de sublinhado, períodos e hífenes.

Comece com alfanumérico. Termine com caráter alfanumérico ou caráter de sublinhado.
localização Localização do recurso cadeia (obrigatório)
etiquetas Etiquetas de recursos Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
extendedLocation A localização expandida da Imagem. ExtendedLocation
propriedades Descreve as propriedades de uma Imagem. ImageProperties

ExtendedLocation

Nome Descrição Valor
name O nome da localização expandida. string
tipo O tipo de localização expandida. 'EdgeZone'

ImageProperties

Nome Descrição Valor
hyperVGeneration Especifica o HyperVGenerationType da VirtualMachine criada a partir da imagem. A partir da Versão 2019-03-01 da API, se a origem da imagem for um blob, precisamos que o utilizador especifique o valor, se a origem for um recurso gerido como disco ou instantâneo, poderemos exigir que o utilizador especifique a propriedade se não a conseguirmos deduzir do recurso gerido de origem. 'V1'
'V2'
sourceVirtualMachine A máquina virtual de origem a partir da qual a Imagem é criada. Sub-origem
storageProfile Especifica as definições de armazenamento para os discos da máquina virtual. ImageStorageProfile

Sub-origem

Nome Descrição Valor
ID ID do Recurso string

ImageStorageProfile

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

Para obter mais informações sobre discos, veja About disks and VHDs for Azure virtual machines (Acerca de discos e VHDs para máquinas virtuais do Azure).		 ImageDataDisk[]
osDisk Especifica informações sobre o disco do sistema operativo utilizado pela máquina virtual.

Para obter mais informações sobre discos, veja About disks and VHDs for Azure virtual machines (Acerca de discos e VHDs para máquinas virtuais do Azure).		 ImageOSDisk
zoneResilient Especifica se uma imagem é resiliente ou não à zona. A predefinição é falso. As imagens resilientes à zona só podem ser criadas em regiões que fornecem Armazenamento Com Redundância entre Zonas (ZRS). bool

ImageDataDisk

Nome Descrição Valor
blobUri O Disco Rígido Virtual. string
colocação em cache Especifica os requisitos de colocação em cache. Os valores possíveis são: None,ReadOnly,ReadWrite. Os valores predefinidos são: Nenhum para armazenamento Standard. ReadOnly para armazenamento Premium. "Nenhum"
"Só de Leitura"
"ReadWrite"
diskEncryptionSet Especifica o ID de recurso do conjunto de encriptação de discos geridos pelo cliente para o disco de imagem gerida. DiskEncryptionSetParameters
diskSizeGB Especifica o tamanho dos discos de dados vazios em gigabytes. Este elemento pode ser utilizado para substituir o nome do disco numa imagem de máquina virtual. Este valor não pode ser superior a 1023 GB. int
lun Especifica o número de unidade lógica do disco de dados. Este valor é utilizado para identificar discos de dados na VM e, por conseguinte, tem de ser exclusivo para cada disco de dados anexado a uma VM. int (obrigatório)
managedDisk O managedDisk. Sub-origem
instantâneo O instantâneo. Sub-origem
storageAccountType Especifica o tipo de conta de armazenamento para o disco gerido. NOTA: UltraSSD_LRS só podem ser utilizadas com discos de dados, não podem ser utilizadas com o Disco do SO. '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
colocação em cache Especifica os requisitos de colocação em cache. Os valores possíveis são: None,ReadOnly,ReadWrite. Os valores predefinidos são: Nenhum para armazenamento Standard. ReadOnly para armazenamento Premium. "Nenhum"
"Só de Leitura"
"ReadWrite"
diskEncryptionSet Especifica o ID de recurso do conjunto de encriptação de discos geridos pelo cliente para o disco de imagem gerida. DiskEncryptionSetParameters
diskSizeGB Especifica o tamanho dos discos de dados vazios em gigabytes. Este elemento pode ser utilizado para substituir o nome do disco numa imagem de máquina virtual. Este valor não pode ser superior a 1023 GB. int
managedDisk O managedDisk. Sub-origem
osState O Estado do SO. Para imagens geridas, utilize Generalized. "Generalizado"
"Especializado" (obrigatório)
osType Esta propriedade permite-lhe especificar o tipo de SO 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-origem
storageAccountType Especifica o tipo de conta de armazenamento para o disco gerido. NOTA: UltraSSD_LRS só podem ser utilizadas com discos de dados, não podem ser utilizadas com o Disco do SO. 'PremiumV2_LRS'
'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'
'UltraSSD_LRS'

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo Description
Criar uma VM a partir da Imagem de Utilizador

Implementar no Azure		 Este modelo permite-lhe criar uma Máquinas Virtuais a partir de uma imagem de Utilizador. Este modelo também implementa um Rede Virtual, endereços IP públicos e uma Interface de Rede.
Criar uma VM numa vnet nova ou existente a partir de um VHD generalizado

Implementar no Azure		 Este modelo cria uma VM a partir de um VHD generalizado e permite-lhe ligá-la a uma VNET nova ou existente que pode residir noutro Grupo de Recursos do que na máquina virtual
Implementar um Conjunto de Dimensionamento de VMs com uma imagem personalizada do Linux

Implementar no Azure		 Este modelo permite-lhe implementar uma imagem personalizada do Linux de VM dentro de um Conjunto de Dimensionamento. Estas VMs estão protegidas por um balanceador de carga com balanceamento de carga HTTP (por predefinição, na porta 80). O exemplo utiliza um script personalizado para efetuar a implementação e atualização da aplicação. Poderá ter de fornecer o script personalizado para o seu próprio procedimento de atualização. Terá de fornecer uma imagem generalizada da sua VM na mesma subscrição e região onde cria o VMSS.
Implementar um Conjunto de Dimensionamento de VMs com uma imagem personalizada do Windows

Implementar no Azure		 Este modelo permite-lhe implementar um Conjunto de Dimensionamento de VMs simples com uma imagem personalizada do Windows. Estas VMs estão protegidas por um balanceador de carga com balanceamento de carga HTTP (por predefinição, na porta 80)

Definição de recurso terraform (fornecedor AzAPI)

O tipo de recurso de imagens pode ser implementado com operações que visam:

  • Grupos de recursos

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

Formato do recurso

Para criar um recurso Microsoft.Compute/images, adicione o seguinte Terraform ao seu 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

imagens

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

Limite de carateres: 1-80

Carateres válidos:
Alfanuméricos, carateres de sublinhado, períodos e hífenes.

Comece com alfanumérico. Termine com alfanumérico ou caráter de sublinhado.
localização Localização do recurso cadeia (obrigatório)
parent_id Para implementar num grupo de recursos, utilize o ID desse grupo de recursos. cadeia (obrigatório)
etiquetas Etiquetas de recursos Dicionário de nomes e valores de etiquetas.
extendedLocation A localização expandida da Imagem. ExtendedLocation
propriedades Descreve as propriedades de uma Imagem. Propriedades da Imagem

ExtendedLocation

Nome Descrição Valor
name O nome da localização expandida. string
tipo O tipo de localização expandida. "EdgeZone"

Propriedades da Imagem

Nome Descrição Valor
hyperVGeneration Especifica o HyperVGenerationType do VirtualMachine criado a partir da imagem. Na Versão 2019-03-01 da API, se a origem da imagem for um blob, precisamos que o utilizador especifique o valor. Se a origem for um recurso gerido, como o disco ou o instantâneo, poderemos exigir que o utilizador especifique a propriedade se não a conseguirmos deduzir do recurso gerido de origem. "V1"
"V2"
sourceVirtualMachine A máquina virtual de origem a partir da qual a Imagem é criada. Sub-origem
storageProfile Especifica as definições de armazenamento para os discos da máquina virtual. ImageStorageProfile

Sub-origem

Nome Descrição Valor
ID ID do Recurso string

ImageStorageProfile

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

Para obter mais informações sobre discos, veja About disks and VHDs for Azure virtual machines (Acerca de discos e VHDs para máquinas virtuais do Azure).		 ImageDataDisk[]
osDisk Especifica informações sobre o disco do sistema operativo utilizado pela máquina virtual.

Para obter mais informações sobre discos, veja About disks and VHDs for Azure virtual machines (Acerca de discos e VHDs para máquinas virtuais do Azure).		 ImageOSDisk
zoneResilient Especifica se uma imagem é resiliente ou não à zona. A predefinição é falso. As imagens resilientes à zona só podem ser criadas em regiões que fornecem Armazenamento Com Redundância entre Zonas (ZRS). bool

ImageDataDisk

Nome Descrição Valor
blobUri O Disco Rígido Virtual. string
colocação em cache Especifica os requisitos de colocação em cache. Os valores possíveis são: None,ReadOnly,ReadWrite. Os valores predefinidos são: Nenhum para armazenamento Standard. ReadOnly para armazenamento Premium. "Nenhum"
"Só de Leitura"
"ReadWrite"
diskEncryptionSet Especifica o ID de recurso do conjunto de encriptação de discos geridos pelo cliente para o disco de imagem gerida. DiskEncryptionSetParameters
diskSizeGB Especifica o tamanho dos discos de dados vazios em gigabytes. Este elemento pode ser utilizado para substituir o nome do disco numa imagem de máquina virtual. Este valor não pode ser superior a 1023 GB. int
lun Especifica o número de unidade lógica do disco de dados. Este valor é utilizado para identificar discos de dados na VM e, por conseguinte, tem de ser exclusivo para cada disco de dados anexado a uma VM. int (obrigatório)
managedDisk O managedDisk. Sub-origem
instantâneo O instantâneo. Sub-origem
storageAccountType Especifica o tipo de conta de armazenamento para o disco gerido. NOTA: UltraSSD_LRS só podem ser utilizadas com discos de dados, não podem ser utilizadas com o Disco do SO. "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
colocação em cache Especifica os requisitos de colocação em cache. Os valores possíveis são: None,ReadOnly,ReadWrite. Os valores predefinidos são: Nenhum para armazenamento Standard. ReadOnly para armazenamento Premium. "Nenhum"
"Só de Leitura"
"ReadWrite"
diskEncryptionSet Especifica o ID de recurso do conjunto de encriptação de discos geridos pelo cliente para o disco de imagem gerida. DiskEncryptionSetParameters
diskSizeGB Especifica o tamanho dos discos de dados vazios em gigabytes. Este elemento pode ser utilizado para substituir o nome do disco numa imagem de máquina virtual. Este valor não pode ser superior a 1023 GB. int
managedDisk O managedDisk. Sub-origem
osState O Estado do SO. Para imagens geridas, utilize Generalized. "Generalizado"
"Especializado" (obrigatório)
osType Esta propriedade permite-lhe especificar o tipo de SO 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-origem
storageAccountType Especifica o tipo de conta de armazenamento para o disco gerido. NOTA: UltraSSD_LRS só podem ser utilizadas com discos de dados, não podem ser utilizadas com o Disco do SO. "PremiumV2_LRS"
"Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"
"UltraSSD_LRS"