Partilhar via


Gallery Images - Create Or Update

Crie ou atualize uma definição de imagem de galeria.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryImageName}?api-version=2024-03-03

Parâmetros do URI

Name Em Necessário Tipo Description
galleryImageName
path True

string

O nome da definição de imagem da galeria a ser criada ou atualizada. Os caracteres permitidos são alfabetos e números com pontos, traços e pontos permitidos no meio. O comprimento máximo é de 80 caracteres.

galleryName
path True

string

O nome da Galeria de Imagens Compartilhadas na qual a Definição de Imagem deve ser criada.

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. O ID da assinatura faz parte do URI de cada chamada de serviço.

api-version
query True

string

Versão da API do cliente.

Corpo do Pedido

Name Necessário Tipo Description
location True

string

Localização do recurso

properties.identifier True

GalleryImageIdentifier

Este é o identificador de definição de imagem da galeria.

properties.osState True

OperatingSystemStateTypes

Essa propriedade permite que o usuário especifique se as máquinas virtuais criadas sob esta imagem são 'Generalizadas' ou 'Especializadas'.

properties.osType True

OperatingSystemTypes

Essa propriedade permite especificar o tipo de sistema operacional incluído no disco ao criar uma VM a partir de uma imagem gerenciada. Os valores possíveis são: Windows,Linux.

properties.allowUpdateImage

boolean

Opcional. Deve ser definido como true se os recursos de imagem da galeria estiverem sendo atualizados.

properties.architecture

Architecture

A arquitetura da imagem. Aplicável apenas a discos do SO.

properties.description

string

A descrição deste recurso de definição de imagem de galeria. Esta propriedade é atualizável.

properties.disallowed

Disallowed

Descreve os tipos de disco não permitidos.

properties.endOfLifeDate

string

A data de fim da vida útil da definição da imagem da galeria. Esta propriedade pode ser usada para fins de descomissionamento. Esta propriedade é atualizável.

properties.eula

string

O acordo Eula para a definição da imagem da galeria.

properties.features

GalleryImageFeature[]

Uma lista de recursos de imagem da galeria.

properties.hyperVGeneration

HyperVGeneration

A geração do hipervisor da máquina virtual. Aplicável apenas a discos do SO.

properties.privacyStatementUri

string

A declaração de privacidade uri.

properties.purchasePlan

ImagePurchasePlan

Descreve o plano de compra de definição de imagem da galeria. Isso é usado por imagens de mercado.

properties.recommended

RecommendedMachineConfiguration

As propriedades descrevem a configuração de máquina recomendada para esta definição de imagem. Essas propriedades são atualizáveis.

properties.releaseNoteUri

string

A nota de lançamento uri.

tags

object

Tags de recursos

Respostas

Name Tipo Description
200 OK

GalleryImage

OK

201 Created

GalleryImage

Criado

202 Accepted

GalleryImage

Aceito

Other Status Codes

CloudError

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

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

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

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

Pedido de amostra

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName/images/myGalleryImageName?api-version=2024-03-03

{
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    }
  }
}

Resposta da amostra

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/Images/myGalleryImageName",
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myGalleryImageName"
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/Images/myGalleryImageName",
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    },
    "provisioningState": "Creating"
  },
  "location": "West US",
  "name": "myGalleryImageName"
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/Images/myGalleryImageName",
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myGalleryImageName"
}

Definições

Name Description
ApiError

Erro de api.

ApiErrorBase

Base de erro da api.

Architecture

A arquitetura da imagem. Aplicável apenas a discos do SO.

CloudError

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

Disallowed

Descreve os tipos de disco não permitidos.

GalleryImage

Especifica informações sobre a definição de imagem da galeria que você deseja criar ou atualizar.

GalleryImageFeature

Um recurso para imagem de galeria.

GalleryImageIdentifier

Este é o identificador de definição de imagem da galeria.

GalleryProvisioningState

O estado atual da galeria ou artefato de galeria.

HyperVGeneration

A geração do hipervisor da máquina virtual. Aplicável apenas a discos do SO.

ImagePurchasePlan

Descreve o plano de compra de definição de imagem da galeria. Isso é usado por imagens de mercado.

InnerError

Detalhes do erro interno.

OperatingSystemStateTypes

Essa propriedade permite que o usuário especifique se as máquinas virtuais criadas sob esta imagem são 'Generalizadas' ou 'Especializadas'.

OperatingSystemTypes

Esta propriedade permite que você especifique o tipo suportado do sistema operacional para o qual o aplicativo foi criado. Os valores possíveis são: Windows,Linux.

RecommendedMachineConfiguration

As propriedades descrevem a configuração de máquina recomendada para esta definição de imagem. Essas propriedades são atualizáveis.

ResourceRange

Descreve o intervalo de recursos.

ApiError

Erro de api.

Name Tipo Description
code

string

O código de erro.

details

ApiErrorBase[]

Os detalhes do erro Api

innererror

InnerError

O erro interno da Api

message

string

A mensagem de erro.

target

string

O alvo do erro específico.

ApiErrorBase

Base de erro da api.

Name Tipo Description
code

string

O código de erro.

message

string

A mensagem de erro.

target

string

O alvo do erro específico.

Architecture

A arquitetura da imagem. Aplicável apenas a discos do SO.

Name Tipo Description
Arm64

string

x64

string

CloudError

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

Name Tipo Description
error

ApiError

Erro de api.

Disallowed

Descreve os tipos de disco não permitidos.

Name Tipo Description
diskTypes

string[]

Uma lista de tipos de disco.

GalleryImage

Especifica informações sobre a definição de imagem da galeria que você deseja criar ou atualizar.

Name Tipo Description
id

string

ID do recurso

location

string

Localização do recurso

name

string

Nome do recurso

properties.allowUpdateImage

boolean

Opcional. Deve ser definido como true se os recursos de imagem da galeria estiverem sendo atualizados.

properties.architecture

Architecture

A arquitetura da imagem. Aplicável apenas a discos do SO.

properties.description

string

A descrição deste recurso de definição de imagem de galeria. Esta propriedade é atualizável.

properties.disallowed

Disallowed

Descreve os tipos de disco não permitidos.

properties.endOfLifeDate

string

A data de fim da vida útil da definição da imagem da galeria. Esta propriedade pode ser usada para fins de descomissionamento. Esta propriedade é atualizável.

properties.eula

string

O acordo Eula para a definição da imagem da galeria.

properties.features

GalleryImageFeature[]

Uma lista de recursos de imagem da galeria.

properties.hyperVGeneration

HyperVGeneration

A geração do hipervisor da máquina virtual. Aplicável apenas a discos do SO.

properties.identifier

GalleryImageIdentifier

Este é o identificador de definição de imagem da galeria.

properties.osState

OperatingSystemStateTypes

Essa propriedade permite que o usuário especifique se as máquinas virtuais criadas sob esta imagem são 'Generalizadas' ou 'Especializadas'.

properties.osType

OperatingSystemTypes

Essa propriedade permite especificar o tipo de sistema operacional incluído no disco ao criar uma VM a partir de uma imagem gerenciada. Os valores possíveis são: Windows,Linux.

properties.privacyStatementUri

string

A declaração de privacidade uri.

properties.provisioningState

GalleryProvisioningState

O estado atual da galeria ou artefato de galeria.
O estado de provisionamento, que só aparece na resposta.

properties.purchasePlan

ImagePurchasePlan

Descreve o plano de compra de definição de imagem da galeria. Isso é usado por imagens de mercado.

properties.recommended

RecommendedMachineConfiguration

As propriedades descrevem a configuração de máquina recomendada para esta definição de imagem. Essas propriedades são atualizáveis.

properties.releaseNoteUri

string

A nota de lançamento uri.

tags

object

Tags de recursos

type

string

Tipo de recurso

GalleryImageFeature

Um recurso para imagem de galeria.

Name Tipo Description
name

string

O nome do recurso de imagem da galeria.

startsAtVersion

string

A versão mínima da imagem da galeria que suporta este recurso.

value

string

O valor do recurso de imagem da galeria.

GalleryImageIdentifier

Este é o identificador de definição de imagem da galeria.

Name Tipo Description
offer

string

O nome da oferta de definição de imagem da galeria.

publisher

string

O nome do editor de definição de imagem da galeria.

sku

string

O nome da definição de imagem da galeria SKU.

GalleryProvisioningState

O estado atual da galeria ou artefato de galeria.

Name Tipo Description
Creating

string

Deleting

string

Failed

string

Migrating

string

Succeeded

string

Updating

string

HyperVGeneration

A geração do hipervisor da máquina virtual. Aplicável apenas a discos do SO.

Name Tipo Description
V1

string

V2

string

ImagePurchasePlan

Descreve o plano de compra de definição de imagem da galeria. Isso é usado por imagens de mercado.

Name Tipo Description
name

string

O ID do plano.

product

string

O ID do produto.

publisher

string

O ID do editor.

InnerError

Detalhes do erro interno.

Name Tipo Description
errordetail

string

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

exceptiontype

string

O tipo de exceção.

OperatingSystemStateTypes

Essa propriedade permite que o usuário especifique se as máquinas virtuais criadas sob esta imagem são 'Generalizadas' ou 'Especializadas'.

Name Tipo Description
Generalized

string

Specialized

string

OperatingSystemTypes

Esta propriedade permite que você especifique o tipo suportado do sistema operacional para o qual o aplicativo foi criado. Os valores possíveis são: Windows,Linux.

Name Tipo Description
Linux

string

Windows

string

RecommendedMachineConfiguration

As propriedades descrevem a configuração de máquina recomendada para esta definição de imagem. Essas propriedades são atualizáveis.

Name Tipo Description
memory

ResourceRange

Descreve o intervalo de recursos.

vCPUs

ResourceRange

Descreve o intervalo de recursos.

ResourceRange

Descreve o intervalo de recursos.

Name Tipo Description
max

integer

O número máximo do recurso.

min

integer

O número mínimo do recurso.