Imagens microsoft.compute 2023-09-01

Artigo
12/21/2024

Definição de recurso do Bicep

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

Grupos de recursos - Consulte comandos de implantação do grupo 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 Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.Compute/images@2023-09-01' = {
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  location: 'string'
  name: 'string'
  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
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

DiskEncryptionSetParameters

Nome	Descrição	Valor
id	ID do recurso	corda

ExtendedLocation

Nome	Descrição	Valor
nome	O nome do local estendido.	corda
tipo	O tipo do local estendido.	'EdgeZone'

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'

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'

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

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

Microsoft.Compute/images

Nome	Descrição	Valor
extendedLocation	O local estendido da Imagem.	ExtendedLocation
localização	Local do recurso	cadeia de caracteres (obrigatório)
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades	Descreve as propriedades de uma imagem.	ImageProperties
Tags	Marcas de recurso	Dicionário de nomes e valores de marca. Consulte Marcas em modelos

ResourceTags

Nome	Descrição	Valor

SubResource

Nome	Descrição	Valor
id	ID do recurso	corda

Exemplos de uso

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Módulo	Descrição
Imagem	Módulo de recurso AVM para imagem

Definição de recurso de modelo do ARM

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

Grupos de recursos - Consulte comandos de implantação do grupo 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 JSON a seguir ao modelo.

{
  "type": "Microsoft.Compute/images",
  "apiVersion": "2023-09-01",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "location": "string",
  "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"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

DiskEncryptionSetParameters

Nome	Descrição	Valor
id	ID do recurso	corda

ExtendedLocation

Nome	Descrição	Valor
nome	O nome do local estendido.	corda
tipo	O tipo do local estendido.	'EdgeZone'

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'

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'

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

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

Microsoft.Compute/images

Nome	Descrição	Valor
apiVersion	A versão da API	'2023-09-01'
extendedLocation	O local estendido da Imagem.	ExtendedLocation
localização	Local do recurso	cadeia de caracteres (obrigatório)
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades	Descreve as propriedades de uma imagem.	ImageProperties
Tags	Marcas de recurso	Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo	O tipo de recurso	'Microsoft.Compute/images'

ResourceTags

Nome	Descrição	Valor

SubResource

Nome	Descrição	Valor
id	ID do recurso	corda

Exemplos de uso

Modelos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

Modelo	Descrição
criar uma VM com base em de imagem do usuário	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	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	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	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-09-01"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    extendedLocation = {
      name = "string"
      type = "string"
    }
    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

DiskEncryptionSetParameters

Nome	Descrição	Valor
id	ID do recurso	corda

ExtendedLocation

Nome	Descrição	Valor
nome	O nome do local estendido.	corda
tipo	O tipo do local estendido.	'EdgeZone'

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'

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'

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

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

Microsoft.Compute/images

Nome	Descrição	Valor
extendedLocation	O local estendido da Imagem.	ExtendedLocation
localização	Local do recurso	cadeia de caracteres (obrigatório)
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades	Descreve as propriedades de uma imagem.	ImageProperties
Tags	Marcas de recurso	Dicionário de nomes e valores de marca.
tipo	O tipo de recurso	"Microsoft.Compute/images@2023-09-01"

ResourceTags

Nome	Descrição	Valor

SubResource

Nome	Descrição	Valor
id	ID do recurso	corda

Exemplos de uso

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Módulo	Descrição
Imagem	Módulo de recurso AVM para imagem

Compartilhar via

Imagens microsoft.compute 2023-09-01

Definição de recurso do Bicep

Formato de recurso

Valores de propriedade

DiskEncryptionSetParameters

ExtendedLocation

ImageDataDisk

ImageOSDisk

ImageProperties

ImageStorageProfile

Microsoft.Compute/images

ResourceTags

SubResource

Exemplos de uso

Módulos verificados do Azure

Definição de recurso de modelo do ARM

Formato de recurso

Valores de propriedade

DiskEncryptionSetParameters

ExtendedLocation

ImageDataDisk

ImageOSDisk

ImageProperties

ImageStorageProfile

Microsoft.Compute/images

ResourceTags

SubResource

Exemplos de uso

Modelos de Início Rápido do Azure

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

Formato de recurso

Valores de propriedade

DiskEncryptionSetParameters

ExtendedLocation

ImageDataDisk

ImageOSDisk

ImageProperties

ImageStorageProfile

Microsoft.Compute/images

ResourceTags

SubResource

Exemplos de uso

Módulos verificados do Azure

Comentários

Recursos adicionais