Compartilhar via


Shared Gallery Images - Get

Obtenha uma imagem da 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=2023-07-03

Parâmetros de URI

Nome Em Obrigatório Tipo 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

Nome Tipo Description
200 OK

SharedGalleryImage

OK

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

Solicitação de exemplo

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

Resposta de exemplo

{
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    },
    "eula": "https://www.microsoft.com/en-us/",
    "artifactTags": {
      "ShareTag-Official1PGallery": "Official1PGallery"
    }
  },
  "location": "myLocation",
  "name": "myGalleryImageName",
  "identifier": {
    "uniqueId": "/SharedGalleries/galleryUniqueName/Images/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.

GalleryImageFeature

Um recurso para 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 nessa 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 de computador recomendada 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.

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.

GalleryImageFeature

Um recurso para imagem da galeria.

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

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.

HyperVGeneration

A geração de 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 identificação 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 nessa imagem são "Generalizadas" ou "Especializadas".

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

Nome Tipo Description
Linux

string

Windows

string

RecommendedMachineConfiguration

As propriedades descrevem a configuração de computador recomendada para esta 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.

SharedGalleryImage

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

Nome Tipo Description
identifier.uniqueId

string

A ID exclusiva desta galeria compartilhada.

location

string

Localização do recurso

name

string

Nome do recurso

properties.architecture

Architecture

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

properties.artifactTags

object

As marcas de artefato de um recurso de galeria compartilhada.

properties.disallowed

Disallowed

Descreve os tipos de disco não permitidos.

properties.endOfLifeDate

string

A data de fim 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

Contrato de licença do usuário final para a imagem atual da galeria da comunidade.

properties.features

GalleryImageFeature[]

Uma lista de recursos de imagem da galeria.

properties.hyperVGeneration

HyperVGeneration

A geração de 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 nessa 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 de uma imagem gerenciada. Os valores possíveis são: Windows,Linux.

properties.privacyStatementUri

string

URI da política de privacidade para a imagem atual da galeria da comunidade.

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 esta Definição de Imagem. Essas propriedades são atualizáveis.