Bagikan melalui


Virtual Machine Images - Get

Mendapatkan gambar komputer 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-07-01

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
location
path True

string

Nama wilayah Azure yang didukung.

offer
path True

string

Penawaran penerbit gambar yang valid.

publisherName
path True

string

Penerbit gambar yang valid.

skus
path True

string

SKU gambar yang valid.

subscriptionId
path True

string

Kredensial langganan yang secara unik mengidentifikasi langganan Microsoft Azure. ID langganan membentuk bagian dari URI untuk setiap panggilan layanan.

version
path True

string

Versi SKU gambar yang valid.

api-version
query True

string

Versi Api Klien.

Respons

Nama Jenis Deskripsi
200 OK

VirtualMachineImage

OKE

Other Status Codes

CloudError

Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

VirtualMachineImage_Get_MaximumSet_Gen
VirtualMachineImage_Get_MinimumSet_Gen

VirtualMachineImage_Get_MaximumSet_Gen

Permintaan sampel

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-07-01

Respon sampel

{
  "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

Permintaan sampel

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-07-01

Respon sampel

{
  "name": "aaaaaaaaa",
  "location": "aaaaa",
  "id": "aaaaaaaaaaa"
}

Definisi

Nama Deskripsi
AlternativeOption

Menjelaskan opsi alternatif yang ditentukan oleh Publisher untuk gambar ini ketika gambar ini tidak digunakan lagi.

AlternativeType

Menjelaskan jenis opsi alternatif.

ApiError

Kesalahan api.

ApiErrorBase

Basis kesalahan api.

ArchitectureTypes

Menentukan Jenis Arsitektur

AutomaticOSUpgradeProperties

Menjelaskan properti peningkatan OS otomatis pada gambar.

CloudError

Respons kesalahan dari layanan Komputasi.

DataDiskImage

Berisi informasi gambar disk data.

DisallowedConfiguration

Menentukan konfigurasi yang tidak diizinkan untuk gambar komputer virtual.

ExtendedLocation

Jenis kompleks lokasi yang diperluas.

ExtendedLocationTypes

Jenis lokasi yang diperluas.

HyperVGenerationTypes

Menentukan Jenis HyperVGeneration

ImageDeprecationStatus

Menjelaskan properti status penghentian gambar pada gambar.

ImageState

Menjelaskan status gambar.

InnerError

Detail kesalahan dalam.

OperatingSystemTypes

Sistem operasi osDiskImage.

OSDiskImage

Berisi informasi gambar disk os.

PurchasePlan

Digunakan untuk menetapkan konteks pembelian artefak Pihak ke-3 apa pun melalui MarketPlace.

VirtualMachineImage

Menjelaskan Gambar Komputer Virtual.

VirtualMachineImageFeature

Menentukan kemampuan tambahan yang didukung oleh gambar

VmDiskTypes

Jenis disk VM yang tidak diizinkan.

AlternativeOption

Menjelaskan opsi alternatif yang ditentukan oleh Publisher untuk gambar ini ketika gambar ini tidak digunakan lagi.

Nama Jenis Deskripsi
type

AlternativeType

Menjelaskan jenis opsi alternatif.

value

string

Menunjukkan nilai opsi alternatif yang ditentukan oleh Publisher. Ini adalah Nama penawaran saat jenisnya adalah Penawaran atau nama Paket saat jenisnya adalah Paket.

AlternativeType

Menjelaskan jenis opsi alternatif.

Nilai Deskripsi
None
Offer
Plan

ApiError

Kesalahan api.

Nama Jenis Deskripsi
code

string

Kode kesalahan.

details

ApiErrorBase[]

Detail kesalahan Api

innererror

InnerError

Kesalahan dalam Api

message

string

Pesan kesalahan.

target

string

Target kesalahan tertentu.

ApiErrorBase

Basis kesalahan api.

Nama Jenis Deskripsi
code

string

Kode kesalahan.

message

string

Pesan kesalahan.

target

string

Target kesalahan tertentu.

ArchitectureTypes

Menentukan Jenis Arsitektur

Nilai Deskripsi
Arm64
x64

AutomaticOSUpgradeProperties

Menjelaskan properti peningkatan OS otomatis pada gambar.

Nama Jenis Deskripsi
automaticOSUpgradeSupported

boolean

Menentukan apakah peningkatan OS otomatis didukung pada gambar.

CloudError

Respons kesalahan dari layanan Komputasi.

Nama Jenis Deskripsi
error

ApiError

Kesalahan api.

DataDiskImage

Berisi informasi gambar disk data.

Nama Jenis Deskripsi
lun

integer

Menentukan nomor unit logis disk data. Nilai ini digunakan untuk mengidentifikasi disk data dalam VM dan oleh karena itu harus unik untuk setiap disk data yang terpasang pada VM.

DisallowedConfiguration

Menentukan konfigurasi yang tidak diizinkan untuk gambar komputer virtual.

Nama Jenis Deskripsi
vmDiskType

VmDiskTypes

Jenis disk VM yang tidak diizinkan.

ExtendedLocation

Jenis kompleks lokasi yang diperluas.

Nama Jenis Deskripsi
name

string

Nama lokasi yang diperluas.

type

ExtendedLocationTypes

Jenis lokasi yang diperluas.

ExtendedLocationTypes

Jenis lokasi yang diperluas.

Nilai Deskripsi
EdgeZone

HyperVGenerationTypes

Menentukan Jenis HyperVGeneration

Nilai Deskripsi
V1
V2

ImageDeprecationStatus

Menjelaskan properti status penghentian gambar pada gambar.

Nama Jenis Deskripsi
alternativeOption

AlternativeOption

Menjelaskan opsi alternatif yang ditentukan oleh Publisher untuk gambar ini ketika gambar ini tidak digunakan lagi.

imageState

ImageState

Menjelaskan status gambar.

scheduledDeprecationTime

string

Waktu, di masa depan, di mana gambar ini akan ditandai sebagai tidak digunakan lagi. Waktu terjadwal ini dipilih oleh Publisher.

ImageState

Menjelaskan status gambar.

Nilai Deskripsi
Active
Deprecated
ScheduledForDeprecation

InnerError

Detail kesalahan dalam.

Nama Jenis Deskripsi
errordetail

string

Pesan kesalahan internal atau cadangan pengecualian.

exceptiontype

string

Jenis pengecualian.

OperatingSystemTypes

Sistem operasi osDiskImage.

Nilai Deskripsi
Linux
Windows

OSDiskImage

Berisi informasi gambar disk os.

Nama Jenis Deskripsi
operatingSystem

OperatingSystemTypes

Sistem operasi osDiskImage.

PurchasePlan

Digunakan untuk menetapkan konteks pembelian artefak Pihak ke-3 apa pun melalui MarketPlace.

Nama Jenis Deskripsi
name

string

ID paket.

product

string

Menentukan produk gambar dari marketplace. Ini adalah nilai yang sama dengan Penawaran di bawah elemen imageReference.

publisher

string

ID penerbit.

VirtualMachineImage

Menjelaskan Gambar Komputer Virtual.

Nama Jenis Deskripsi
extendedLocation

ExtendedLocation

Lokasi Komputer Virtual yang diperluas.

id

string

Id Sumber Daya

location

string

Lokasi sumber daya Azure yang didukung.

name

string

Nama sumber daya.

properties.architecture

ArchitectureTypes

Menentukan Jenis Arsitektur

properties.automaticOSUpgradeProperties

AutomaticOSUpgradeProperties

Menjelaskan properti peningkatan OS otomatis pada gambar.

properties.dataDiskImages

DataDiskImage[]

Berisi informasi gambar disk data.

properties.disallowed

DisallowedConfiguration

Menentukan konfigurasi yang tidak diizinkan untuk VirtualMachine yang dibuat dari gambar

properties.features

VirtualMachineImageFeature[]

Menentukan kemampuan tambahan yang didukung oleh gambar

properties.hyperVGeneration

HyperVGenerationTypes

Menentukan Jenis HyperVGeneration

properties.imageDeprecationStatus

ImageDeprecationStatus

Menjelaskan properti status penghentian gambar pada gambar.

properties.osDiskImage

OSDiskImage

Berisi informasi gambar disk os.

properties.plan

PurchasePlan

Digunakan untuk menetapkan konteks pembelian artefak Pihak ke-3 apa pun melalui MarketPlace.

tags

object

Menentukan tag yang ditetapkan ke komputer virtual. Untuk informasi selengkapnya tentang menggunakan tag, lihat Menggunakan tag untuk mengatur sumber daya Azure Anda.

VirtualMachineImageFeature

Menentukan kemampuan tambahan yang didukung oleh gambar

Nama Jenis Deskripsi
name

string

Nama fitur.

value

string

Nilai yang sesuai untuk fitur tersebut.

VmDiskTypes

Jenis disk VM yang tidak diizinkan.

Nilai Deskripsi
None
Unmanaged