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:
- 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-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. | |
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 |
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 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-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. | |
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 |
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-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
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" |