Aracılığıyla paylaş


Virtual Machine Images - Get

Bir sanal makine görüntüsü alır.

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

URI Parametreleri

Name İçinde Gerekli Tür Description
location
path True

string

Desteklenen bir Azure bölgesinin adı.

offer
path True

string

Geçerli bir görüntü yayımcısı teklifi.

publisherName
path True

string

Geçerli bir görüntü yayımcısı.

skus
path True

string

Geçerli bir görüntü SKU'su.

subscriptionId
path True

string

Microsoft Azure aboneliğini benzersiz olarak tanımlayan abonelik kimlik bilgileri. Abonelik kimliği, her hizmet çağrısı için URI'nin bir parçasını oluşturur.

version
path True

string

Geçerli bir görüntü SKU sürümü.

api-version
query True

string

İstemci Api Sürümü.

Yanıtlar

Name Tür Description
200 OK

VirtualMachineImage

TAMAM

Other Status Codes

CloudError

İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name Description
user_impersonation kullanıcı hesabınızın kimliğine bürünme

Örnekler

VirtualMachineImage_Get_MaximumSet_Gen
VirtualMachineImage_Get_MinimumSet_Gen

VirtualMachineImage_Get_MaximumSet_Gen

Örnek isteği

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

Örnek yanıt

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

Örnek isteği

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

Örnek yanıt

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

Tanımlar

Name Description
AlternativeOption

Bu görüntü kullanım dışı bırakıldığında publisher tarafından bu görüntü için belirtilen alternatif seçeneği açıklar.

AlternativeType

Alternatif seçeneğin türünü açıklar.

ApiError

API hatası.

ApiErrorBase

Api hata tabanı.

ArchitectureTypes

Mimari Türünü belirtir

AutomaticOSUpgradeProperties

Görüntüdeki otomatik işletim sistemi yükseltme özelliklerini açıklar.

CloudError

İşlem hizmetinden bir hata yanıtı.

DataDiskImage

Veri diski görüntüleri bilgilerini içerir.

DisallowedConfiguration

Bir sanal makine görüntüsü için izin verilmeyen yapılandırmayı belirtir.

ExtendedLocation

Genişletilmiş konumun karmaşık türü.

ExtendedLocationTypes

Genişletilmiş konumun türü.

HyperVGenerationTypes

HyperVGeneration Türünü Belirtir

ImageDeprecationStatus

Görüntüdeki görüntü kullanımdan kaldırma durumu özelliklerini açıklar.

ImageState

Görüntünün durumunu açıklar.

InnerError

İç hata ayrıntıları.

OperatingSystemTypes

osDiskImage işletim sistemi.

OSDiskImage

İşletim sistemi disk görüntüsü bilgilerini içerir.

PurchasePlan

MarketPlace aracılığıyla herhangi bir 3. Taraf yapıtın satın alma bağlamını oluşturmak için kullanılır.

VirtualMachineImage

Sanal Makine Görüntüsünü açıklar.

VirtualMachineImageFeature

Görüntü tarafından desteklenen ek özellikleri belirtir

VmDiskTypes

İzin verilmeyen VM disk türleri.

AlternativeOption

Bu görüntü kullanım dışı bırakıldığında publisher tarafından bu görüntü için belirtilen alternatif seçeneği açıklar.

Name Tür Description
type

AlternativeType

Alternatif seçeneğin türünü açıklar.

value

string

Publisher tarafından belirtilen alternatif seçenek değerini gösterir. Bu, tür Teklif olduğunda Teklif adı veya plan türü Plan olduğunda Plan adıdır.

AlternativeType

Alternatif seçeneğin türünü açıklar.

Değer Description
None
Offer
Plan

ApiError

API hatası.

Name Tür Description
code

string

Hata kodu.

details

ApiErrorBase[]

Api hata ayrıntıları

innererror

InnerError

Api iç hatası

message

string

Hata iletisi.

target

string

Belirli bir hatanın hedefi.

ApiErrorBase

Api hata tabanı.

Name Tür Description
code

string

Hata kodu.

message

string

Hata iletisi.

target

string

Belirli bir hatanın hedefi.

ArchitectureTypes

Mimari Türünü belirtir

Değer Description
Arm64
x64

AutomaticOSUpgradeProperties

Görüntüdeki otomatik işletim sistemi yükseltme özelliklerini açıklar.

Name Tür Description
automaticOSUpgradeSupported

boolean

Görüntüde otomatik işletim sistemi yükseltmesinin desteklenip desteklenmediğini belirtir.

CloudError

İşlem hizmetinden bir hata yanıtı.

Name Tür Description
error

ApiError

API hatası.

DataDiskImage

Veri diski görüntüleri bilgilerini içerir.

Name Tür Description
lun

integer

Veri diskinin mantıksal birim numarasını belirtir. Bu değer VM içindeki veri disklerini tanımlamak için kullanılır ve bu nedenle vm'ye bağlı her veri diski için benzersiz olmalıdır.

DisallowedConfiguration

Bir sanal makine görüntüsü için izin verilmeyen yapılandırmayı belirtir.

Name Tür Description
vmDiskType

VmDiskTypes

İzin verilmeyen VM disk türleri.

ExtendedLocation

Genişletilmiş konumun karmaşık türü.

Name Tür Description
name

string

Genişletilmiş konumun adı.

type

ExtendedLocationTypes

Genişletilmiş konumun türü.

ExtendedLocationTypes

Genişletilmiş konumun türü.

Değer Description
EdgeZone

HyperVGenerationTypes

HyperVGeneration Türünü Belirtir

Değer Description
V1
V2

ImageDeprecationStatus

Görüntüdeki görüntü kullanımdan kaldırma durumu özelliklerini açıklar.

Name Tür Description
alternativeOption

AlternativeOption

Bu görüntü kullanım dışı bırakıldığında publisher tarafından bu görüntü için belirtilen alternatif seçeneği açıklar.

imageState

ImageState

Görüntünün durumunu açıklar.

scheduledDeprecationTime

string

Gelecekte bu görüntünün kullanım dışı olarak işaretleneceği zaman. Bu zamanlanmış saat Yayımcı tarafından seçilir.

ImageState

Görüntünün durumunu açıklar.

Değer Description
Active
Deprecated
ScheduledForDeprecation

InnerError

İç hata ayrıntıları.

Name Tür Description
errordetail

string

İç hata iletisi veya özel durum dökümü.

exceptiontype

string

Özel durum türü.

OperatingSystemTypes

osDiskImage işletim sistemi.

Değer Description
Linux
Windows

OSDiskImage

İşletim sistemi disk görüntüsü bilgilerini içerir.

Name Tür Description
operatingSystem

OperatingSystemTypes

osDiskImage işletim sistemi.

PurchasePlan

MarketPlace aracılığıyla herhangi bir 3. Taraf yapıtın satın alma bağlamını oluşturmak için kullanılır.

Name Tür Description
name

string

Plan kimliği.

product

string

Marketten alınan görüntünün çarpımını belirtir. Bu, imageReference öğesi altındaki Offer ile aynı değerdir.

publisher

string

Yayımcı kimliği.

VirtualMachineImage

Sanal Makine Görüntüsünü açıklar.

Name Tür Description
extendedLocation

ExtendedLocation

Sanal Makinenin genişletilmiş konumu.

id

string

Kaynak Kimliği

location

string

Kaynağın desteklenen Azure konumu.

name

string

Kaynağın adı.

properties.architecture

ArchitectureTypes

Mimari Türünü belirtir

properties.automaticOSUpgradeProperties

AutomaticOSUpgradeProperties

Görüntüdeki otomatik işletim sistemi yükseltme özelliklerini açıklar.

properties.dataDiskImages

DataDiskImage[]

Veri diski görüntüleri bilgilerini içerir.

properties.disallowed

DisallowedConfiguration

Görüntüden oluşturulan VirtualMachine için izin verilmeyen yapılandırmayı belirtir

properties.features

VirtualMachineImageFeature[]

Görüntü tarafından desteklenen ek özellikleri belirtir

properties.hyperVGeneration

HyperVGenerationTypes

HyperVGeneration Türünü Belirtir

properties.imageDeprecationStatus

ImageDeprecationStatus

Görüntüdeki görüntü kullanımdan kaldırma durumu özelliklerini açıklar.

properties.osDiskImage

OSDiskImage

İşletim sistemi disk görüntüsü bilgilerini içerir.

properties.plan

PurchasePlan

MarketPlace aracılığıyla herhangi bir 3. Taraf yapıtın satın alma bağlamını oluşturmak için kullanılır.

tags

object

Sanal makineye atanan etiketleri belirtir. Etiketleri kullanma hakkında daha fazla bilgi için bkz.Azure kaynaklarınızı düzenlemek için etiketleri kullanma .

VirtualMachineImageFeature

Görüntü tarafından desteklenen ek özellikleri belirtir

Name Tür Description
name

string

Özelliğin adı.

value

string

Özellik için karşılık gelen değer.

VmDiskTypes

İzin verilmeyen VM disk türleri.

Değer Description
None
Unmanaged