Compartilhar via


Gallery Images - Create Or Update

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

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

Parâmetros de URI

Nome Em Obrigató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 períodos 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. 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 Obrigatório Tipo Description
location True

string

Local do recurso

properties.identifier True

GalleryImageIdentifier

Esse é 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 essa imagem são "Generalizadas" ou "Especializadas".

properties.osType True

OperatingSystemTypes

Essa propriedade permite que você especifique o tipo do 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 somente a discos do sistema operacional.

properties.description

string

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

properties.disallowed

Disallowed

Descreve os tipos de disco não permitidos.

properties.endOfLifeDate

string

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

properties.eula

string

O contrato Eula para a definição de 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 somente a discos do sistema operacional.

properties.privacyStatementUri

string

O uri da política de privacidade.

properties.purchasePlan

ImagePurchasePlan

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

properties.recommended

RecommendedMachineConfiguration

As propriedades descrevem a configuração de computador recomendada para essa Definição de Imagem. Essas propriedades são atualizáveis.

properties.releaseNoteUri

string

O uri da nota de versão.

tags

object

Marcas de recurso

Respostas

Nome Tipo Description
200 OK

GalleryImage

OKEY

201 Created

GalleryImage

Criado

202 Accepted

GalleryImage

Aceitado

Other Status Codes

CloudError

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

Segurança

azure_auth

Fluxo 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

Solicitação de exemplo

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 de exemplo

{
  "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

Nome Description
ApiError

Erro de API.

ApiErrorBase

Base de erros de API.

Architecture

A arquitetura da imagem. Aplicável somente a discos do sistema operacional.

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 da galeria.

GalleryImageIdentifier

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

GalleryProvisioningState

O estado atual da galeria ou do artefato da galeria.

HyperVGeneration

A geração do hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional.

ImagePurchasePlan

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

InnerError

Detalhes do erro interno.

OperatingSystemStateTypes

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

OperatingSystemTypes

Essa propriedade permite que você especifique o tipo com suporte 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 computador recomendada para essa Definição de Imagem. Essas propriedades são atualizáveis.

ResourceRange

Descreve o intervalo de recursos.

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.

Architecture

A arquitetura da imagem. Aplicável somente a discos do sistema operacional.

Nome Tipo Description
Arm64

string

x64

string

CloudError

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

Nome Tipo Description
error

ApiError

Erro de API.

Disallowed

Descreve os tipos de disco não permitidos.

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

Nome Tipo Description
id

string

ID do recurso

location

string

Local 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 somente a discos do sistema operacional.

properties.description

string

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

properties.disallowed

Disallowed

Descreve os tipos de disco não permitidos.

properties.endOfLifeDate

string

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

properties.eula

string

O contrato Eula para a definição de 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 somente a discos do sistema operacional.

properties.identifier

GalleryImageIdentifier

Esse é 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 essa imagem são "Generalizadas" ou "Especializadas".

properties.osType

OperatingSystemTypes

Essa propriedade permite que você especifique o tipo do 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

O uri da política de privacidade.

properties.provisioningState

GalleryProvisioningState

O estado atual da galeria ou do artefato da galeria.
O estado de provisionamento, que aparece apenas na resposta.

properties.purchasePlan

ImagePurchasePlan

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

properties.recommended

RecommendedMachineConfiguration

As propriedades descrevem a configuração de computador recomendada para essa Definição de Imagem. Essas propriedades são atualizáveis.

properties.releaseNoteUri

string

O uri da nota de versão.

tags

object

Marcas de recurso

type

string

Tipo de recurso

GalleryImageFeature

Um recurso para imagem da galeria.

Nome Tipo Description
name

string

O nome do recurso de imagem da galeria.

startsAtVersion

string

A versão mínima da imagem da galeria que dá suporte a esse recurso.

value

string

O valor do recurso de imagem da galeria.

GalleryImageIdentifier

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

Nome 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 SKU de definição de imagem da galeria.

GalleryProvisioningState

O estado atual da galeria ou do artefato da galeria.

Nome 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 somente a discos do sistema operacional.

Nome Tipo Description
V1

string

V2

string

ImagePurchasePlan

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

Nome Tipo Description
name

string

A ID do plano.

product

string

A ID do produto.

publisher

string

A ID do editor.

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

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

Nome Tipo Description
Generalized

string

Specialized

string

OperatingSystemTypes

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

Nome Tipo Description
Linux

string

Windows

string

RecommendedMachineConfiguration

As propriedades descrevem a configuração de computador recomendada para essa Definição de Imagem. Essas propriedades são atualizáveis.

Nome Tipo Description
memory

ResourceRange

Descreve o intervalo de recursos.

vCPUs

ResourceRange

Descreve o intervalo de recursos.

ResourceRange

Descreve o intervalo de recursos.

Nome Tipo Description
max

integer

O número máximo do recurso.

min

integer

O número mínimo do recurso.