Shared Gallery Images - Get

Serviço:: Compute

Versão da API:: 2024-03-03

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=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 Compartilhada a partir da qual as Versões de Imagem devem ser listadas.
galleryUniqueName	path	True	string	O nome exclusivo da Galeria Compartilhada.
location	path	True	string minLength: 1	O nome da região do Azure.
subscriptionId	path	True	string minLength: 1	A ID da assinatura de destino.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Description
200 OK	SharedGalleryImage	A operação do Azure foi concluída com êxito.
Other Status Codes	CloudError	Uma resposta de erro inesperada.

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

Get a shared gallery image.

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 200

{
  "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 da API.
Architecture	A arquitetura da imagem. Aplicável somente a discos do sistema operacional.
CloudError	Uma resposta de erro do serviço Compute.
Disallowed	Descreve os tipos de disco não permitidos.
GalleryImageFeature	Um recurso para imagem de galeria.
GalleryImageIdentifier	Esse é o identificador de definição de imagem 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 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.
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.
SharedGalleryImage	Especifica informações sobre a definição de imagem da galeria que você deseja criar ou atualizar.

ApiError

Objeto

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

Objeto

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

Enumeração

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

Valor	Description
x64
Arm64

CloudError

Objeto

Uma resposta de erro do serviço Compute.

Nome	Tipo	Description
error	ApiError	Erro de API.

Disallowed

Objeto

Descreve os tipos de disco não permitidos.

Nome	Tipo	Description
diskTypes	string[]	Uma lista de tipos de disco.

GalleryImageFeature

Objeto

Um recurso para imagem de 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

Objeto

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

Enumeração

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

Valor	Description
V1
V2

ImagePurchasePlan

Objeto

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

Objeto

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

Enumeração

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

Valor	Description
Generalized	Imagem generalizada. Precisa ser provisionado durante o tempo de implantação.
Specialized	Imagem especializada. Contém o disco do sistema operacional já provisionado.

OperatingSystemTypes

Enumeração

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.

Valor	Description
Windows
Linux

RecommendedMachineConfiguration

Objeto

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

Objeto

Descreve o intervalo de recursos.

Nome	Tipo	Description
max	integer (int32)	O número máximo do recurso.
min	integer (int32)	O número mínimo do recurso.