Shared Gallery Images - Get

Obtenha uma imagem de galeria compartilhada por ID de assinatura ou ID de locatário.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/sharedGalleries/{galleryUniqueName}/images/{galleryImageName}?api-version=2022-01-03

Parâmetros de URI

Name In Required Type Description
galleryImageName
path True
  • string

O nome da Definição de Imagem da Galeria Compartilhada da qual as versões de imagem devem ser listadas.

galleryUniqueName
path True
  • string

O nome exclusivo da Galeria Compartilhada.

location
path True
  • string

Local do recurso.

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.

Respostas

Name Type Description
200 OK

OK

Other Status Codes

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

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation representar sua conta de usuário

Exemplos

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/myLocation/sharedGalleries/galleryUniqueName/images/myGalleryImageName?api-version=2022-01-03

Sample Response

{
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    }
  },
  "location": "myLocation",
  "name": "myGalleryImageName",
  "identifier": {
    "uniqueId": "/SharedGalleries/galleryUniqueName/Images/myGalleryImageName"
  }
}

Definições

ApiError

Erro de API.

ApiErrorBase

Base de erros da 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.

GalleryImageFeature

Um recurso para a imagem da galeria.

GalleryImageIdentifier

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

HyperVGeneration

A geração de 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 do sistema operacional incluído no disco ao criar uma VM de uma imagem gerenciada.

Os valores possíveis são:

Windows

Linux

RecommendedMachineConfiguration

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

ResourceRange

Descreve o intervalo de recursos.

SharedGalleryImage

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

ApiError

Erro de API.

Name Type 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 da API.

Name Type 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.

Name Type Description
Arm64
  • string
x64
  • string

CloudError

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

Name Type Description
error

Erro de API.

Disallowed

Descreve os tipos de disco não permitidos.

Name Type Description
diskTypes
  • string[]

Uma lista de tipos de disco.

GalleryImageFeature

Um recurso para a imagem da galeria.

Name Type Description
name
  • string

O nome do recurso de imagem da galeria.

value
  • string

O valor do recurso de imagem da galeria.

GalleryImageIdentifier

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

Name Type 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.

HyperVGeneration

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

Name Type Description
V1
  • string
V2
  • string

ImagePurchasePlan

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

Name Type Description
name
  • string

A ID do plano.

product
  • string

A identificação do produto.

publisher
  • string

A ID do editor.

InnerError

Detalhes do erro interno.

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

Name Type Description
Generalized
  • string
Specialized
  • string

OperatingSystemTypes

Essa propriedade permite que você especifique o tipo do sistema operacional incluído no disco ao criar uma VM de uma imagem gerenciada.

Os valores possíveis são:

Windows

Linux

Name Type Description
Linux
  • string
Windows
  • string

RecommendedMachineConfiguration

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

Name Type Description
memory

Descreve o intervalo de recursos.

vCPUs

Descreve o intervalo de recursos.

ResourceRange

Descreve o intervalo de recursos.

Name Type Description
max
  • integer

O número máximo do recurso.

min
  • integer

O número mínimo do recurso.

SharedGalleryImage

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

Name Type Description
identifier.uniqueId
  • string

A ID exclusiva desta galeria compartilhada.

location
  • string

Localização do recurso

name
  • string

Nome do recurso

properties.architecture

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

properties.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.features

Uma lista de recursos de imagem da galeria.

properties.hyperVGeneration

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

properties.identifier

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

properties.osState

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

properties.osType

Essa propriedade permite que você especifique o tipo do sistema operacional incluído no disco ao criar uma VM de uma imagem gerenciada.

Os valores possíveis são:

Windows

Linux

properties.purchasePlan

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

properties.recommended

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