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 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.
galleryImageVersionName	path	True	string	O nome da versão da imagem da galeria a ser criada. Precisa seguir o padrão de nome de versão semântica: 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>.<MinorVersion>.<Remendo>
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	SharedGalleryImageVersion	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 version.

Solicitação de exemplo

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

Código de status:

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

Nome	Description
ApiError	Erro de API.
ApiErrorBase	Base de erros da API.
CloudError	Uma resposta de erro do serviço Compute.
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	Esse é o perfil de armazenamento de uma Versão de Imagem da Galeria.
SharedGalleryOSDiskImage	Esta é a imagem de disco do sistema operacional.

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.

CloudError

Objeto

Uma resposta de erro do serviço Compute.

Nome	Tipo	Description
error	ApiError	Erro de API.

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.

SharedGalleryDataDiskImage

Objeto

Esta é a imagem do disco de dados.

Nome	Tipo	Description
diskSizeGB	integer (int32)	Essa 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)	Essa propriedade especifica o número de 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 anexado à 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

Objeto

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

Nome	Tipo	Description
identifier.uniqueId	string	O ID exclusivo desta galeria compartilhada.
location	string	Local 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. Essa propriedade pode ser usada para fins de descomissionamento. Essa 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 da Imagem.
properties.publishedDate	string (date-time)	A data de publicação da versão da imagem da galeria Definição. Essa propriedade pode ser usada para fins de descomissionamento. Essa propriedade é atualizável.
properties.storageProfile	SharedGalleryImageVersionStorageProfile	Descreve o perfil de armazenamento da versão da imagem.

SharedGalleryImageVersionStorageProfile

Objeto

Esse é o perfil de armazenamento de uma Versão de Imagem da Galeria.

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

SharedGalleryOSDiskImage

Objeto

Esta é a imagem de disco do sistema operacional.

Nome	Tipo	Description
diskSizeGB	integer (int32)	Essa 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'