Compartilhar via


Images - Update

Atualizar uma imagem.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/images/{imageName}?api-version=2024-03-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
imageName
path True

string

O nome da imagem.

resourceGroupName
path True

string

O nome do grupo de recursos.

subscriptionId
path True

string

Credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.

api-version
query True

string

Versão da API do cliente.

Corpo da solicitação

Nome Tipo Description
properties.hyperVGeneration

HyperVGenerationTypes

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.

properties.sourceVirtualMachine

SubResource

A máquina virtual de origem da qual a Imagem é criada.

properties.storageProfile

ImageStorageProfile

Especifica as configurações de armazenamento dos discos da máquina virtual.

tags

object

Marcações de recursos

Respostas

Nome Tipo Description
200 OK

Image

OK

201 Created

Image

Criado

Other Status Codes

CloudError

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Updates tags of an Image.

Solicitação de exemplo

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/myImage?api-version=2024-03-01

{
  "properties": {
    "sourceVirtualMachine": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"
    },
    "hyperVGeneration": "V1"
  },
  "tags": {
    "department": "HR"
  }
}

Resposta de exemplo

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/myImage",
  "name": "myImage",
  "type": "Microsoft.Compute/images",
  "location": "West US",
  "tags": {
    "department": "HR"
  },
  "properties": {
    "storageProfile": {
      "osDisk": {
        "osType": "Windows",
        "blobUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd",
        "snapshot": {
          "id": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/snapshots/mySnapshot1"
        },
        "managedDisk": {
          "id": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myManagedDisk1"
        },
        "osState": "Generalized",
        "storageAccountType": "Standard_LRS",
        "diskSizeGB": 20
      },
      "dataDisks": [
        {
          "lun": 1,
          "blobUri": "https://mystorageaccount.blob.core.windows.net/dataimages/dataimage.vhd",
          "snapshot": {
            "id": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/snapshots/mySnapshot2"
          },
          "managedDisk": {
            "id": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myManagedDisk2"
          },
          "storageAccountType": "Standard_LRS"
        }
      ],
      "zoneResilient": true
    },
    "provisioningState": "created"
  }
}
{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/myImage",
  "name": "myImage",
  "type": "Microsoft.Compute/images",
  "location": "West US",
  "tags": {
    "department": "HR"
  },
  "properties": {
    "storageProfile": {
      "osDisk": {
        "osType": "Windows",
        "blobUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd",
        "snapshot": {
          "id": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/snapshots/mySnapshot1"
        },
        "managedDisk": {
          "id": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myManagedDisk1"
        },
        "osState": "Generalized",
        "storageAccountType": "Standard_LRS",
        "diskSizeGB": 20
      },
      "dataDisks": [
        {
          "lun": 1,
          "blobUri": "https://mystorageaccount.blob.core.windows.net/dataimages/dataimage.vhd",
          "snapshot": {
            "id": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/snapshots/mySnapshot2"
          },
          "managedDisk": {
            "id": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myManagedDisk2"
          },
          "storageAccountType": "Standard_LRS"
        }
      ],
      "zoneResilient": true
    },
    "provisioningState": "created"
  }
}

Definições

Nome Description
ApiError

Erro de API.

ApiErrorBase

Base de erros de API.

CachingTypes

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.

CloudError

Uma resposta de erro do serviço de computação.

DiskEncryptionSetParameters

Descreve o parâmetro da ID de recurso do conjunto de criptografia de disco gerenciado pelo cliente que pode ser especificada para o disco. Nota: A ID do recurso do conjunto de criptografia de disco só pode ser especificada para o disco gerenciado. https://aka.ms/mdssewithcmkoverview Consulte para obter mais detalhes.

ExtendedLocation

O tipo complexo do local estendido.

ExtendedLocationTypes

O tipo do local estendido.

HyperVGenerationTypes

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.

Image

O disco rígido virtual da imagem do usuário de origem. O disco rígido virtual será copiado antes de ser anexado à máquina virtual. Se SourceImage for fornecido, o disco rígido virtual de destino não deverá existir.

ImageDataDisk

Descreve um disco de dados.

ImageOSDisk

Descreve um disco do sistema operacional.

ImageStorageProfile

Descreve um perfil de armazenamento.

ImageUpdate

O disco rígido virtual da imagem do usuário de origem. Somente marcas podem ser atualizadas.

InnerError

Detalhes do erro interno.

OperatingSystemStateTypes

O estado do sistema operacional. Para imagens gerenciadas, use Generalizado.

OperatingSystemTypes

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.

StorageAccountTypes

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.

SubResource

ApiError

Erro de API.

Nome Tipo Description
code

string

O código de erro.

details

ApiErrorBase[]

Os detalhes do erro da API

innererror

InnerError

O erro interno da API

message

string

A mensagem de erro.

target

string

O destino do erro específico.

ApiErrorBase

Base de erros de API.

Nome Tipo Description
code

string

O código de erro.

message

string

A mensagem de erro.

target

string

O destino do erro específico.

CachingTypes

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.

Nome Tipo Description
None

string

ReadOnly

string

ReadWrite

string

CloudError

Uma resposta de erro do serviço de computação.

Nome Tipo Description
error

ApiError

Erro de API.

DiskEncryptionSetParameters

Descreve o parâmetro da ID de recurso do conjunto de criptografia de disco gerenciado pelo cliente que pode ser especificada para o disco. Nota: A ID do recurso do conjunto de criptografia de disco só pode ser especificada para o disco gerenciado. https://aka.ms/mdssewithcmkoverview Consulte para obter mais detalhes.

Nome Tipo Description
id

string

ID do recurso

ExtendedLocation

O tipo complexo do local estendido.

Nome Tipo Description
name

string

O nome do local estendido.

type

ExtendedLocationTypes

O tipo do local estendido.

ExtendedLocationTypes

O tipo do local estendido.

Nome Tipo Description
EdgeZone

string

HyperVGenerationTypes

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.

Nome Tipo Description
V1

string

V2

string

Image

O disco rígido virtual da imagem do usuário de origem. O disco rígido virtual será copiado antes de ser anexado à máquina virtual. Se SourceImage for fornecido, o disco rígido virtual de destino não deverá existir.

Nome Tipo Description
extendedLocation

ExtendedLocation

O local estendido da Imagem.

id

string

ID do recurso

location

string

Localização do recurso

name

string

Nome do recurso

properties.hyperVGeneration

HyperVGenerationTypes

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.

properties.provisioningState

string

O estado de provisionamento.

properties.sourceVirtualMachine

SubResource

A máquina virtual de origem da qual a Imagem é criada.

properties.storageProfile

ImageStorageProfile

Especifica as configurações de armazenamento dos discos da máquina virtual.

tags

object

Marcações de recursos

type

string

Tipo de recurso

ImageDataDisk

Descreve um disco de dados.

Nome Tipo Description
blobUri

string

O disco rígido virtual.

caching

CachingTypes

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.

diskEncryptionSet

DiskEncryptionSetParameters

Especifica a ID do recurso do conjunto de criptografia de disco gerenciado pelo cliente para o disco de imagem gerenciada.

diskSizeGB

integer

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.

lun

integer

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.

managedDisk

SubResource

O managedDisk.

snapshot

SubResource

O instantâneo.

storageAccountType

StorageAccountTypes

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.

ImageOSDisk

Descreve um disco do sistema operacional.

Nome Tipo Description
blobUri

string

O disco rígido virtual.

caching

CachingTypes

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.

diskEncryptionSet

DiskEncryptionSetParameters

Especifica a ID do recurso do conjunto de criptografia de disco gerenciado pelo cliente para o disco de imagem gerenciada.

diskSizeGB

integer

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.

managedDisk

SubResource

O managedDisk.

osState

OperatingSystemStateTypes

O estado do sistema operacional. Para imagens gerenciadas, use Generalizado.

osType

OperatingSystemTypes

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.

snapshot

SubResource

O instantâneo.

storageAccountType

StorageAccountTypes

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.

ImageStorageProfile

Descreve um perfil de armazenamento.

Nome Tipo Description
dataDisks

ImageDataDisk[]

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.

osDisk

ImageOSDisk

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.

zoneResilient

boolean

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).

ImageUpdate

O disco rígido virtual da imagem do usuário de origem. Somente marcas podem ser atualizadas.

Nome Tipo Description
properties.hyperVGeneration

HyperVGenerationTypes

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.

properties.provisioningState

string

O estado de provisionamento.

properties.sourceVirtualMachine

SubResource

A máquina virtual de origem da qual a Imagem é criada.

properties.storageProfile

ImageStorageProfile

Especifica as configurações de armazenamento dos discos da máquina virtual.

tags

object

Marcações de recursos

InnerError

Detalhes do erro interno.

Nome Tipo Description
errordetail

string

A mensagem de erro interna ou o despejo de exceção.

exceptiontype

string

O tipo de exceção.

OperatingSystemStateTypes

O estado do sistema operacional. Para imagens gerenciadas, use Generalizado.

Nome Tipo Description
Generalized

string

Imagem generalizada. Precisa ser provisionado durante o tempo de implantação.

Specialized

string

Imagem especializada. Contém o disco do sistema operacional já provisionado.

OperatingSystemTypes

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.

Nome Tipo Description
Linux

string

Windows

string

StorageAccountTypes

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.

Nome Tipo Description
PremiumV2_LRS

string

Premium_LRS

string

Premium_ZRS

string

StandardSSD_LRS

string

StandardSSD_ZRS

string

Standard_LRS

string

UltraSSD_LRS

string

SubResource

Nome Tipo Description
id

string

ID do recurso