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 |
---|---|---|---|---|
image
|
path | True |
string |
O nome da imagem. |
resource
|
path | True |
string |
O nome do grupo de recursos. |
subscription
|
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 |
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 |
A máquina virtual de origem da qual a Imagem é criada. |
|
properties.storageProfile |
Especifica as configurações de armazenamento dos discos da máquina virtual. |
|
tags |
object |
Marcações de recursos |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OK |
|
201 Created |
Criado |
|
Other Status Codes |
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 |
---|---|
Api |
Erro de API. |
Api |
Base de erros de API. |
Caching |
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. |
Cloud |
Uma resposta de erro do serviço de computação. |
Disk |
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. |
Extended |
O tipo complexo do local estendido. |
Extended |
O tipo do local estendido. |
Hyper |
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. |
Image |
Descreve um disco de dados. |
Image |
Descreve um disco do sistema operacional. |
Image |
Descreve um perfil de armazenamento. |
Image |
O disco rígido virtual da imagem do usuário de origem. Somente marcas podem ser atualizadas. |
Inner |
Detalhes do erro interno. |
Operating |
O estado do sistema operacional. Para imagens gerenciadas, use Generalizado. |
Operating |
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. |
Storage |
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. |
Sub |
ApiError
Erro de API.
Nome | Tipo | Description |
---|---|---|
code |
string |
O código de erro. |
details |
Os detalhes do erro da API |
|
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 |
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 |
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 |
O local estendido da Imagem. |
|
id |
string |
ID do recurso |
location |
string |
Localização do recurso |
name |
string |
Nome do recurso |
properties.hyperVGeneration |
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 |
A máquina virtual de origem da qual a Imagem é criada. |
|
properties.storageProfile |
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 |
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 |
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 |
O managedDisk. |
|
snapshot |
O instantâneo. |
|
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. |
ImageOSDisk
Descreve um disco do sistema operacional.
Nome | Tipo | Description |
---|---|---|
blobUri |
string |
O disco rígido virtual. |
caching |
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 |
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 |
O managedDisk. |
|
osState |
O estado do sistema operacional. Para imagens gerenciadas, use Generalizado. |
|
osType |
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 |
O instantâneo. |
|
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. |
ImageStorageProfile
Descreve um perfil de armazenamento.
Nome | Tipo | Description |
---|---|---|
dataDisks |
Especifica os parâmetros que são usados para adicionar um disco de dados a uma máquina virtual. |
|
osDisk |
Especifica informações sobre o disco do sistema operacional usado pela máquina virtual. |
|
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 |
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 |
A máquina virtual de origem da qual a Imagem é criada. |
|
properties.storageProfile |
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 |