Virtual Machine Images - Get
Obtém uma imagem de máquina virtual.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/publishers/{publisherName}/artifacttypes/vmimage/offers/{offer}/skus/{skus}/versions/{version}?api-version=2024-03-01
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
location
|
path | True |
string |
O nome de uma região do Azure com suporte. |
offer
|
path | True |
string |
Uma oferta válida do editor de imagens. |
publisher
|
path | True |
string |
Um editor de imagens válido. |
skus
|
path | True |
string |
Um SKU de imagem válido. |
subscription
|
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. |
version
|
path | True |
string |
Uma versão de SKU de imagem válida. |
api-version
|
query | True |
string |
Versão da API do cliente. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Segurança
azure_auth
Fluxo do OAuth2 do Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | Description |
---|---|
user_impersonation | representar sua conta de usuário |
Exemplos
Virtual |
Virtual |
VirtualMachineImage_Get_MaximumSet_Gen
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/aaaaaa/publishers/aaa/artifacttypes/vmimage/offers/aaaaaaaaaaaaaaaaaaaaaaaaaaaaa/skus/aaaaaaaaaaaaaaaaaaaaaaaaaaa/versions/aaaaaaaaaaaaaaaaaaa?api-version=2024-03-01
Sample Response
{
"properties": {
"plan": {
"publisher": "aaaaaaaaaaaaaaaaaaa",
"name": "aaaaaaaaa",
"product": "aaaaaaaaaaaaaa"
},
"osDiskImage": {
"operatingSystem": "Windows"
},
"dataDiskImages": [
{
"lun": 17
}
],
"automaticOSUpgradeProperties": {
"automaticOSUpgradeSupported": true
},
"hyperVGeneration": "V1",
"disallowed": {
"vmDiskType": "None"
},
"features": [
{
"name": "aaaaaaaaaaaaaaaaaaaaa",
"value": "aaaaaaaaaaaaaaaaaaaa"
}
],
"imageDeprecationStatus": {
"imageState": "ScheduledForDeprecation",
"scheduledDeprecationTime": "2023-01-13T00:00:00+00:00",
"alternativeOption": {
"type": "Offer",
"value": "aaaaaaa"
}
}
},
"name": "aaaaaaaaa",
"location": "aaaaa",
"tags": {
"key6817": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
},
"extendedLocation": {
"name": "aaaaaaaaaaaaaaaaaaaaa",
"type": "EdgeZone"
},
"id": "aaaaaaaaaaa"
}
VirtualMachineImage_Get_MinimumSet_Gen
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/aaaaaaaaaaaa/publishers/aaaaaaaaaaa/artifacttypes/vmimage/offers/aa/skus/aaaaaaaaa/versions/aaaaaaaaaaaaaaaaaaaaaaaaaaaaa?api-version=2024-03-01
Sample Response
{
"name": "aaaaaaaaa",
"location": "aaaaa",
"id": "aaaaaaaaaaa"
}
Definições
Nome | Description |
---|---|
Alternative |
Descreve a opção alternativa especificada pelo Publicador para esta imagem quando essa imagem é preterida. |
Alternative |
Descreve o tipo da opção alternativa. |
Api |
Erro de API. |
Api |
Base de erros de API. |
Architecture |
Especifica o tipo de arquitetura |
Automatic |
Descreve as propriedades de atualização automática do sistema operacional na imagem. |
Cloud |
Uma resposta de erro do serviço de computação. |
Data |
Contém as informações de imagens de disco de dados. |
Disallowed |
Especifica a configuração não permitida para uma imagem de máquina virtual. |
Extended |
O tipo complexo do local estendido. |
Extended |
O tipo do local estendido. |
Hyper |
Especifica o tipo HyperVGeneration |
Image |
Descreve a substituição de imagem status propriedades na imagem. |
Image |
Descreve o estado da imagem. |
Inner |
Detalhes do erro interno. |
Operating |
O sistema operacional do osDiskImage. |
OSDisk |
Contém as informações de imagem de disco do sistema operacional. |
Purchase |
Usado para estabelecer o contexto de compra de qualquer artefato de terceiros por meio do MarketPlace. |
Virtual |
Descreve uma imagem de máquina virtual. |
Virtual |
Especifica recursos adicionais compatíveis com a imagem |
Vm |
Tipos de disco de VM que não são permitidos. |
AlternativeOption
Descreve a opção alternativa especificada pelo Publicador para esta imagem quando essa imagem é preterida.
Nome | Tipo | Description |
---|---|---|
type |
Descreve o tipo da opção alternativa. |
|
value |
string |
Indica o valor de opção alternativo especificado pelo Publicador. Esse é o nome da oferta quando o tipo é Offer ou o Nome do plano quando o tipo é Plan. |
AlternativeType
Descreve o tipo da opção alternativa.
Nome | Tipo | Description |
---|---|---|
None |
string |
|
Offer |
string |
|
Plan |
string |
ApiError
Erro de API.
Nome | Tipo | 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 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. |
ArchitectureTypes
Especifica o tipo de arquitetura
Nome | Tipo | Description |
---|---|---|
Arm64 |
string |
|
x64 |
string |
AutomaticOSUpgradeProperties
Descreve as propriedades de atualização automática do sistema operacional na imagem.
Nome | Tipo | Description |
---|---|---|
automaticOSUpgradeSupported |
boolean |
Especifica se há suporte para a atualização automática do sistema operacional na imagem. |
CloudError
Uma resposta de erro do serviço de computação.
Nome | Tipo | Description |
---|---|---|
error |
Erro de API. |
DataDiskImage
Contém as informações de imagens de disco de dados.
Nome | Tipo | Description |
---|---|---|
lun |
integer |
Especifica o número da unidade lógica do disco de dados. Esse valor é usado para identificar discos de dados dentro da VM e, portanto, deve ser exclusivo para cada disco de dados anexado a uma VM. |
DisallowedConfiguration
Especifica a configuração não permitida para uma imagem de máquina virtual.
Nome | Tipo | Description |
---|---|---|
vmDiskType |
Tipos de disco de VM que não são permitidos. |
ExtendedLocation
O tipo complexo do local estendido.
Nome | Tipo | Description |
---|---|---|
name |
string |
O nome do local estendido. |
type |
O tipo do local estendido. |
ExtendedLocationTypes
O tipo do local estendido.
Nome | Tipo | Description |
---|---|---|
EdgeZone |
string |
HyperVGenerationTypes
Especifica o tipo HyperVGeneration
Nome | Tipo | Description |
---|---|---|
V1 |
string |
|
V2 |
string |
ImageDeprecationStatus
Descreve a substituição de imagem status propriedades na imagem.
Nome | Tipo | Description |
---|---|---|
alternativeOption |
Descreve a opção alternativa especificada pelo Publicador para esta imagem quando essa imagem é preterida. |
|
imageState |
Descreve o estado da imagem. |
|
scheduledDeprecationTime |
string |
A hora, no futuro, em que essa imagem será marcada como preterida. Essa hora agendada é escolhida pelo Publicador. |
ImageState
Descreve o estado da imagem.
Nome | Tipo | Description |
---|---|---|
Active |
string |
|
Deprecated |
string |
|
ScheduledForDeprecation |
string |
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. |
OperatingSystemTypes
O sistema operacional do osDiskImage.
Nome | Tipo | Description |
---|---|---|
Linux |
string |
|
Windows |
string |
OSDiskImage
Contém as informações de imagem de disco do sistema operacional.
Nome | Tipo | Description |
---|---|---|
operatingSystem |
O sistema operacional do osDiskImage. |
PurchasePlan
Usado para estabelecer o contexto de compra de qualquer artefato de terceiros por meio do MarketPlace.
Nome | Tipo | Description |
---|---|---|
name |
string |
A ID do plano. |
product |
string |
Especifica o produto da imagem do marketplace. Esse é o mesmo valor que Offer no elemento imageReference. |
publisher |
string |
A ID do editor. |
VirtualMachineImage
Descreve uma imagem de máquina virtual.
Nome | Tipo | Description |
---|---|---|
extendedLocation |
O local estendido da Máquina Virtual. |
|
id |
string |
ID do recurso |
location |
string |
O local do Azure com suporte do recurso. |
name |
string |
O nome do recurso. |
properties.architecture |
Especifica o tipo de arquitetura |
|
properties.automaticOSUpgradeProperties |
Descreve as propriedades de atualização automática do sistema operacional na imagem. |
|
properties.dataDiskImages |
Contém as informações de imagens de disco de dados. |
|
properties.disallowed |
Especifica a configuração não permitida para o VirtualMachine criado com base na imagem |
|
properties.features |
Especifica recursos adicionais compatíveis com a imagem |
|
properties.hyperVGeneration |
Especifica o tipo HyperVGeneration |
|
properties.imageDeprecationStatus |
Descreve a substituição de imagem status propriedades na imagem. |
|
properties.osDiskImage |
Contém as informações de imagem de disco do sistema operacional. |
|
properties.plan |
Usado para estabelecer o contexto de compra de qualquer artefato de terceiros por meio do MarketPlace. |
|
tags |
object |
Especifica as marcas atribuídas à máquina virtual. Para obter mais informações sobre como usar marcas, consulte Usando marcas para organizar seus recursos do Azure. |
VirtualMachineImageFeature
Especifica recursos adicionais compatíveis com a imagem
Nome | Tipo | Description |
---|---|---|
name |
string |
O nome do recurso. |
value |
string |
O valor correspondente para o recurso. |
VmDiskTypes
Tipos de disco de VM que não são permitidos.
Nome | Tipo | Description |
---|---|---|
None |
string |
|
Unmanaged |
string |