Shared Gallery Image Versions - Get

Serviço:

Compute

Versão da API:

2024-03-03

Obtenha uma versão de 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}/versions/{galleryImageVersionName}?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 Compartilhada a partir da qual as Versões de Imagem devem ser listadas.
galleryImageVersionName	path	True	string	O nome da versão da imagem da galeria a ser criada. Precisa seguir o padrão semântico do nome da versão: Os caracteres permitidos são dígito e ponto. Os dígitos devem estar dentro do intervalo de um inteiro de 32 bits. Formato: <MajorVersion>.<Versão Menor>.<Adesivo>
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 utilizar para esta operação.

Respostas

Name	Tipo	Description
200 OK	SharedGalleryImageVersion	Operação do Azure concluída com êxito.
Other Status Codes	CloudError	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

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

Get a shared gallery image version.

Pedido de amostra

HTTP

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

Resposta da amostra

Código de estado:

200

{
  "properties": {
    "publishedDate": "2018-03-20T09:12:28Z",
    "endOfLifeDate": "2022-03-20T09:12:28Z",
    "excludeFromLatest": false,
    "storageProfile": {
      "osDiskImage": {
        "diskSizeGB": 29,
        "hostCaching": "None"
      }
    },
    "artifactTags": {
      "ShareTag-Official1PGallery": "Official1PGallery"
    }
  },
  "location": "myLocation",
  "name": "myGalleryImageVersionName",
  "identifier": {
    "uniqueId": "/SharedGalleries/galleryUniqueName/Images/myGalleryImageName/Versions/myGalleryImageVersionName"
  }
}

Definições

Name	Description
ApiError	Erro de api.
ApiErrorBase	Base de erro da api.
CloudError	Uma resposta de erro do serviço de computação.
InnerError	Detalhes do erro interno.
SharedGalleryDataDiskImage	Esta é a imagem do disco de dados.
SharedGalleryHostCaching	O cache do host do disco. Os valores válidos são 'None', 'ReadOnly' e 'ReadWrite'
SharedGalleryImageVersion	Especifica informações sobre a versão da imagem da galeria que você deseja criar ou atualizar.
SharedGalleryImageVersionStorageProfile	Este é o perfil de armazenamento de uma versão de imagem da galeria.
SharedGalleryOSDiskImage	Esta é a imagem de disco do SO.

ApiError

Object

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

Object

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.

CloudError

Object

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

Name	Tipo	Description
error	ApiError	Erro de api.

InnerError

Object

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.

SharedGalleryDataDiskImage

Object

Esta é a imagem do disco de dados.

Name	Tipo	Description
diskSizeGB	integer (int32)	Esta propriedade indica o tamanho do VHD a ser criado.
hostCaching	SharedGalleryHostCaching	O cache do host do disco. Os valores válidos são 'None', 'ReadOnly' e 'ReadWrite'
lun	integer (int32)	Esta propriedade especifica o número da unidade lógica do disco de dados. Esse valor é usado para identificar discos de dados dentro da Máquina Virtual e, portanto, deve ser exclusivo para cada disco de dados conectado à Máquina Virtual.

SharedGalleryHostCaching

Enumeração

O cache do host do disco. Os valores válidos são 'None', 'ReadOnly' e 'ReadWrite'

Valor	Description
None
ReadOnly
ReadWrite

SharedGalleryImageVersion

Object

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

Name	Tipo	Description
identifier.uniqueId	string	O id único desta galeria compartilhada.
location	string	Localização do recurso
name	string	Nome do recurso
properties.artifactTags	object	As tags de artefato de um recurso de galeria compartilhado.
properties.endOfLifeDate	string (date-time)	A data de fim da vida útil da versão da imagem da galeria Definição. Esta propriedade pode ser usada para fins de descomissionamento. Esta propriedade é atualizável.
properties.excludeFromLatest	boolean	Se definido como true, as Máquinas Virtuais implantadas a partir da versão mais recente da Definição de Imagem não usarão essa Versão de Imagem.
properties.publishedDate	string (date-time)	A data de publicação da versão da imagem da galeria Definição. Esta propriedade pode ser usada para fins de descomissionamento. Esta propriedade é atualizável.
properties.storageProfile	SharedGalleryImageVersionStorageProfile	Descreve o perfil de armazenamento da versão da imagem.

SharedGalleryImageVersionStorageProfile

Object

Este é o perfil de armazenamento de uma versão de imagem da galeria.

Name	Tipo	Description
dataDiskImages	SharedGalleryDataDiskImage[]	Uma lista de imagens de disco de dados.
osDiskImage	SharedGalleryOSDiskImage	Esta é a imagem de disco do SO.

SharedGalleryOSDiskImage

Object

Esta é a imagem de disco do SO.

Name	Tipo	Description
diskSizeGB	integer (int32)	Esta propriedade indica o tamanho do VHD a ser criado.
hostCaching	SharedGalleryHostCaching	O cache do host do disco. Os valores válidos são 'None', 'ReadOnly' e 'ReadWrite'