次の方法で共有


Virtual Machine Images - Get

仮想マシン イメージを取得します。

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 パラメーター

名前 / 必須 説明
location
path True

string

サポートされている Azure リージョンの名前。

offer
path True

string

有効なイメージ発行元オファー。

publisherName
path True

string

有効なイメージ発行元。

skus
path True

string

有効なイメージ SKU。

subscriptionId
path True

string

Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報。 サブスクリプション ID は、すべてのサービス呼び出しの URI の一部を形成します。

version
path True

string

有効なイメージ SKU バージョン。

api-version
query True

string

クライアント API のバージョン。

応答

名前 説明
200 OK

VirtualMachineImage

わかりました

Other Status Codes

CloudError

操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装する

VirtualMachineImage_Get_MaximumSet_Gen
VirtualMachineImage_Get_MinimumSet_Gen

VirtualMachineImage_Get_MaximumSet_Gen

要求のサンプル

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

応答のサンプル

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

要求のサンプル

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

応答のサンプル

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

定義

名前 説明
AlternativeOption

このイメージが非推奨になった場合に、パブリッシャーによってこのイメージに対して指定された代替オプションについて説明します。

AlternativeType

代替オプションの種類について説明します。

ApiError

API エラー。

ApiErrorBase

API エラーベース。

ArchitectureTypes

アーキテクチャの種類を指定します

AutomaticOSUpgradeProperties

イメージの OS の自動アップグレード プロパティについて説明します。

CloudError

コンピューティング サービスからのエラー応答。

DataDiskImage

データ ディスク イメージ情報を格納します。

DisallowedConfiguration

仮想マシン イメージの許可されていない構成を指定します。

ExtendedLocation

拡張された場所の複合型。

ExtendedLocationTypes

拡張された場所の型。

HyperVGenerationTypes

HyperVGeneration の種類を指定します。

ImageDeprecationStatus

イメージの非推奨状態プロパティについて説明します。

ImageState

イメージの状態について説明します。

InnerError

内部エラーの詳細。

OperatingSystemTypes

osDiskImage のオペレーティング システム。

OSDiskImage

os ディスク イメージの情報が含まれています。

PurchasePlan

MarketPlace を通じてサード パーティの成果物の購入コンテキストを確立するために使用されます。

VirtualMachineImage

仮想マシン イメージについて説明します。

VirtualMachineImageFeature

イメージでサポートされる追加機能を指定します

VmDiskTypes

許可されていない VM ディスクの種類。

AlternativeOption

このイメージが非推奨になった場合に、パブリッシャーによってこのイメージに対して指定された代替オプションについて説明します。

名前 説明
type

AlternativeType

代替オプションの種類について説明します。

value

string

パブリッシャーによって指定された代替オプション値を示します。 種類がプランの場合はプラン名、種類がプランの場合はプラン名です。

AlternativeType

代替オプションの種類について説明します。

名前 説明
None

string

Offer

string

Plan

string

ApiError

API エラー。

名前 説明
code

string

エラー コード。

details

ApiErrorBase[]

Api エラーの詳細

innererror

InnerError

Api 内部エラー

message

string

エラー メッセージ。

target

string

特定のエラーのターゲット。

ApiErrorBase

API エラーベース。

名前 説明
code

string

エラー コード。

message

string

エラー メッセージ。

target

string

特定のエラーのターゲット。

ArchitectureTypes

アーキテクチャの種類を指定します

名前 説明
Arm64

string

x64

string

AutomaticOSUpgradeProperties

イメージの OS の自動アップグレード プロパティについて説明します。

名前 説明
automaticOSUpgradeSupported

boolean

イメージで OS の自動アップグレードをサポートするかどうかを指定します。

CloudError

コンピューティング サービスからのエラー応答。

名前 説明
error

ApiError

API エラー。

DataDiskImage

データ ディスク イメージ情報を格納します。

名前 説明
lun

integer

データ ディスクの論理ユニット番号を指定します。 この値は、VM 内のデータ ディスクを識別するために使用されるため、VM に接続されているデータ ディスクごとに一意である必要があります。

DisallowedConfiguration

仮想マシン イメージの許可されていない構成を指定します。

名前 説明
vmDiskType

VmDiskTypes

許可されていない VM ディスクの種類。

ExtendedLocation

拡張された場所の複合型。

名前 説明
name

string

拡張された場所の名前。

type

ExtendedLocationTypes

拡張された場所の型。

ExtendedLocationTypes

拡張された場所の型。

名前 説明
EdgeZone

string

HyperVGenerationTypes

HyperVGeneration の種類を指定します。

名前 説明
V1

string

V2

string

ImageDeprecationStatus

イメージの非推奨状態プロパティについて説明します。

名前 説明
alternativeOption

AlternativeOption

このイメージが非推奨になった場合に、パブリッシャーによってこのイメージに対して指定された代替オプションについて説明します。

imageState

ImageState

イメージの状態について説明します。

scheduledDeprecationTime

string

このイメージが非推奨としてマークされる将来の時刻。 このスケジュールされた時刻は、パブリッシャーによって選択されます。

ImageState

イメージの状態について説明します。

名前 説明
Active

string

Deprecated

string

ScheduledForDeprecation

string

InnerError

内部エラーの詳細。

名前 説明
errordetail

string

内部エラー メッセージまたは例外ダンプ。

exceptiontype

string

例外の種類。

OperatingSystemTypes

osDiskImage のオペレーティング システム。

名前 説明
Linux

string

Windows

string

OSDiskImage

os ディスク イメージの情報が含まれています。

名前 説明
operatingSystem

OperatingSystemTypes

osDiskImage のオペレーティング システム。

PurchasePlan

MarketPlace を通じてサード パーティの成果物の購入コンテキストを確立するために使用されます。

名前 説明
name

string

プラン ID。

product

string

マーケットプレースからのイメージの製品を指定します。 これは、imageReference 要素の下の Offer と同じ値です。

publisher

string

発行元 ID。

VirtualMachineImage

仮想マシン イメージについて説明します。

名前 説明
extendedLocation

ExtendedLocation

仮想マシンの拡張された場所。

id

string

リソース ID

location

string

サポートされているリソースの Azure の場所。

name

string

リソースの名前。

properties.architecture

ArchitectureTypes

アーキテクチャの種類を指定します

properties.automaticOSUpgradeProperties

AutomaticOSUpgradeProperties

イメージの OS の自動アップグレード プロパティについて説明します。

properties.dataDiskImages

DataDiskImage[]

データ ディスク イメージ情報を格納します。

properties.disallowed

DisallowedConfiguration

イメージから作成された VirtualMachine の許可されていない構成を指定します

properties.features

VirtualMachineImageFeature[]

イメージでサポートされる追加機能を指定します

properties.hyperVGeneration

HyperVGenerationTypes

HyperVGeneration の種類を指定します。

properties.imageDeprecationStatus

ImageDeprecationStatus

イメージの非推奨状態プロパティについて説明します。

properties.osDiskImage

OSDiskImage

os ディスク イメージの情報が含まれています。

properties.plan

PurchasePlan

MarketPlace を通じてサード パーティの成果物の購入コンテキストを確立するために使用されます。

tags

object

仮想マシンに割り当てられるタグを指定します。 タグの使用の詳細については、「タグを使用した Azure リソースのの整理」を参照してください。

VirtualMachineImageFeature

イメージでサポートされる追加機能を指定します

名前 説明
name

string

機能の名前。

value

string

機能の対応する値。

VmDiskTypes

許可されていない VM ディスクの種類。

名前 説明
None

string

Unmanaged

string