Compartilhar via


Platform Images - Get

Retorna a imagem da plataforma solicitada.
Retorna o editor, a oferta, o skus e a versão específicos da imagem da plataforma.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute.Admin/locations/{location}/artifactTypes/platformImage/publishers/{publisher}/offers/{offer}/skus/{sku}/versions/{version}?api-version=2015-12-01-preview

Parâmetros de URI

Nome Em Obrigatório Tipo Description
location
path True

string

Local do recurso.

offer
path True

string

Nome da oferta.

publisher
path True

string

Nome do editor.

sku
path True

string

Nome da SKU.

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.

version
path True

string

A versão do recurso.

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

PlatformImage

OKEY

Other Status Codes

CrpErrorResponse

Resposta de erro comum para todas as APIs do Azure Resource Manager retornarem detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.).

Segurança

azure_auth

A autorização usa um 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 platform image by name.

Solicitação de exemplo

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Compute.Admin/locations/local/artifactTypes/platformImage/publishers/Canonical/offers/UbuntuServer/skus/16.04-:LTS/versions/16.04?api-version=2015-12-01-preview

Resposta de exemplo

{
  "id": "/subscriptions/8158498d-27b1-4ccf-9aa1-de0f925731e6/providers/Microsoft.Compute.Admin/locations/local/artifactTypes/platformImage/publishers/Canonical/offers/UbuntuServer/skus/16.04-LTS/versions/1.0.0",
  "type": "Microsoft.Compute.Admin/locations/artifactTypes/publishers/offers/skus/versions",
  "location": "local",
  "properties": {
    "osDisk": {
      "osType": "Linux",
      "uri": "https://test.blob.local.azurestack.external/test/medium.vhd"
    },
    "provisioningState": "Creating"
  }
}

Definições

Nome Description
CrpErrorResponse

Resposta de erro

DataDisk

Informações sobre o datadisk.

ErrorDetail

O detalhe do erro.

ImageDetails

Informações sobre a imagem de disco.

OsDisk

Disco do sistema operacional.

OsType

Tipo de sistema operacional.

PlatformImage

A imagem da plataforma representa uma máquina virtual.

ProvisioningState

O estado de provisionamento do recurso.

CrpErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

DataDisk

Informações sobre o datadisk.

Nome Tipo Description
lun

integer (int32)

Número da unidade lógica.

uri

string

Local do modelo de disco.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
code

string

O código de erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ImageDetails

Informações sobre a imagem de disco.

Nome Tipo Description
billingPartNumber

string

O número da parte é usado para cobrar os custos de software.

OsDisk

Disco do sistema operacional.

Nome Tipo Description
osType

OsType

Tipo de sistema operacional.

uri

string

Local do disco.

OsType

Tipo de sistema operacional.

Valor Description
Linux
Unknown
Windows

PlatformImage

A imagem da plataforma representa uma máquina virtual.

Nome Tipo Description
id

string

ID do recurso.

location

string

Local do recurso.

name

string

Nome do recurso.

properties.dataDisks

DataDisk[]

Discos de dados usados pela imagem da plataforma.

properties.details

ImageDetails

Informações sobre a imagem.

properties.osDisk

OsDisk

Sistema operacional usado para esta imagem de plataforma.

properties.provisioningState

ProvisioningState

Status de provisionamento da imagem da plataforma.

type

string

Tipo de recurso.

ProvisioningState

O estado de provisionamento do recurso.

Valor Description
Canceled
Creating
Failed
Succeeded