Microsoft.Compute イメージ 2023-09-01

[アーティクル]
03/13/2024

Bicep リソース定義

イメージリソースの種類は、次を対象とする操作でデプロイできます。

リソースグループ - リソースグループのデプロイコマンドに関するページを参照してください

各 API バージョンの変更されたプロパティの一覧については、「変更ログ」を参照してください。

リソース形式

Microsoft.Compute/images リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.Compute/images@2023-09-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  extendedLocation: {
    name: 'string'
    type: 'EdgeZone'
  }
  properties: {
    hyperVGeneration: 'string'
    sourceVirtualMachine: {
      id: 'string'
    }
    storageProfile: {
      dataDisks: [
        {
          blobUri: 'string'
          caching: 'string'
          diskEncryptionSet: {
            id: 'string'
          }
          diskSizeGB: int
          lun: int
          managedDisk: {
            id: 'string'
          }
          snapshot: {
            id: 'string'
          }
          storageAccountType: 'string'
        }
      ]
      osDisk: {
        blobUri: 'string'
        caching: 'string'
        diskEncryptionSet: {
          id: 'string'
        }
        diskSizeGB: int
        managedDisk: {
          id: 'string'
        }
        osState: 'string'
        osType: 'string'
        snapshot: {
          id: 'string'
        }
        storageAccountType: 'string'
      }
      zoneResilient: bool
    }
  }
}

プロパティ値

images

名前	説明	値
name	リソース名	string (必須) 文字数制限: 1 から 80 有効な文字: 英数字、アンダースコア、ピリオド、およびハイフン。英数字で開始します。英数字またはアンダースコアで終了します。
location	リソースの場所	string (必須)
tags	リソースタグ	タグ名と値のディクショナリ。「テンプレートのタグ」を参照してください
extendedLocation	イメージの拡張された場所。	ExtendedLocation
properties	Image のプロパティについて説明します。	ImageProperties

ExtendedLocation

名前	説明	値
name	拡張場所の名前。	string
type	拡張された場所の型。	'EdgeZone'

ImageProperties

名前	説明	値
hyperVGeneration	イメージから作成された VirtualMachine の HyperVGenerationType を指定します。イメージソースが BLOB の場合は API バージョン 2019-03-01 から、ユーザーが値を指定する必要があります。ソースがディスクやスナップショットなどのマネージドリソースの場合、ソースマネージドリソースから推測できない場合は、ユーザーにプロパティの指定を要求する場合があります。	'V1' 'V2'
sourceVirtualMachine	イメージの作成元となるソース仮想マシン。	サブリソース
storageProfile	仮想マシンのストレージ設定を指定します。	ImageStorageProfile

サブリソース

名前	説明	値
id	リソース ID	string

ImageStorageProfile

名前	説明	値
dataDisks	仮想マシンにデータディスクを追加するために使用されるパラメーターを指定します。ディスクの詳細については、「 Azure 仮想マシンのディスクと VHD について」を参照してください。	ImageDataDisk[]
osDisk	仮想マシンで使用されるオペレーティングシステムディスクに関する情報を指定します。ディスクの詳細については、「 Azure 仮想マシンのディスクと VHD について」を参照してください。	ImageOSDisk
zoneResilient	イメージがゾーン回復性があるかどうかを指定します。既定値は false です。ゾーン回復性のあるイメージは、ゾーン冗長ストレージ (ZRS) を提供するリージョンでのみ作成できます。	[bool]

ImageDataDisk

名前	説明	値
blobUri	仮想ハードディスク。	string
キャッシュ	キャッシュの要件を指定します。使用できる値は、 None、ReadOnly、ReadWrite です。既定値は、 Standard Storage の場合は [なし] です。Premium Storage の ReadOnly。	'None' 'ReadOnly' 'ReadWrite'
diskEncryptionSet	マネージドイメージディスクのカスタマーマネージドディスク暗号化セットリソース ID を指定します。	DiskEncryptionSetParameters
diskSizeGB	空のデータディスクのサイズをギガバイト単位で指定します。この要素を使用して、仮想マシンイメージ内のディスクの名前を上書きできます。この値は 1023 GB を超えることはできません。	INT
lun	データディスクの論理ユニット番号を指定します。この値は、VM 内のデータディスクを識別するために使用されるため、VM に接続されているデータディスクごとに一意である必要があります。	int (必須)
managedDisk	managedDisk。	サブリソース
スナップショット	スナップショット。	サブリソース
storageAccountType	マネージドディスクのストレージアカウントの種類を指定します。注: UltraSSD_LRSはデータディスクでのみ使用できます。OS ディスクでは使用できません。	'PremiumV2_LRS' 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' 'UltraSSD_LRS'

DiskEncryptionSetParameters

名前	説明	値
id	リソース ID	string

ImageOSDisk

名前	説明	値
blobUri	仮想ハードディスク。	string
キャッシュ	キャッシュの要件を指定します。使用できる値は、 None、ReadOnly、ReadWrite です。既定値は、 Standard Storage の場合は [なし] です。Premium Storage の ReadOnly。	'None' 'ReadOnly' 'ReadWrite'
diskEncryptionSet	マネージドイメージディスクのカスタマーマネージドディスク暗号化セットリソース ID を指定します。	DiskEncryptionSetParameters
diskSizeGB	空のデータディスクのサイズをギガバイト単位で指定します。この要素を使用して、仮想マシンイメージ内のディスクの名前を上書きできます。この値は 1023 GB を超えることはできません。	INT
managedDisk	managedDisk。	サブリソース
osState	OS の状態。マネージドイメージの場合は、一般化を使用します。	'一般化' 'Specialized' (必須)
osType	このプロパティを使用すると、カスタムイメージから VM を作成する場合にディスクに含まれる OS の種類を指定できます。使用できる値は、Windows、Linux です。	'Linux' 'Windows' (必須)
スナップショット	スナップショット。	サブリソース
storageAccountType	マネージドディスクのストレージアカウントの種類を指定します。注: UltraSSD_LRSはデータディスクでのみ使用できます。OS ディスクでは使用できません。	'PremiumV2_LRS' 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' 'UltraSSD_LRS'

クイックスタートテンプレート

次のクイックスタートテンプレートでは、このリソースの種類をデプロイします。

Template	説明
ユーザーイメージから VM を作成する	このテンプレートを使用すると、ユーザーイメージからVirtual Machinesを作成できます。このテンプレートでは、Virtual Network、パブリック IP アドレス、ネットワークインターフェイスもデプロイされます。
一般化された VHD から新規または既存の vnet に VM を作成する	このテンプレートは、一般化された VHD から VM を作成し、仮想マシンとは別のリソースグループに存在できる新規または既存の VNET に接続できるようにします
Linux カスタムイメージを使用して VM スケールセットをデプロイする	このテンプレートを使用すると、スケールセット内にカスタム VM Linux イメージをデプロイできます。これらの VM は、HTTP 負荷分散を使用したロードバランサーの背後にあります (既定ではポート 80)。この例では、カスタムスクリプトを使用してアプリケーションのデプロイと更新を行います。独自の更新手順用にカスタムスクリプトを指定する必要がある場合があります。 VMSS を作成するのと同じサブスクリプションとリージョンに、VM の一般化されたイメージを提供する必要があります。
Windows カスタムイメージを使用して VM スケールセットをデプロイする	このテンプレートを使用すると、カスタム Windows イメージを使用して単純な VM スケールセットをデプロイできます。これらの VM は、HTTP 負荷分散を使用するロードバランサーの背後にあります (ポート 80 では既定で)

ARM テンプレートリソース定義

イメージリソースの種類は、次を対象とする操作でデプロイできます。

リソースグループ - リソースグループのデプロイコマンドに関するページを参照してください

各 API バージョンの変更されたプロパティの一覧については、「変更ログ」を参照してください。

リソース形式

Microsoft.Compute/images リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.Compute/images",
  "apiVersion": "2023-09-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "extendedLocation": {
    "name": "string",
    "type": "EdgeZone"
  },
  "properties": {
    "hyperVGeneration": "string",
    "sourceVirtualMachine": {
      "id": "string"
    },
    "storageProfile": {
      "dataDisks": [
        {
          "blobUri": "string",
          "caching": "string",
          "diskEncryptionSet": {
            "id": "string"
          },
          "diskSizeGB": "int",
          "lun": "int",
          "managedDisk": {
            "id": "string"
          },
          "snapshot": {
            "id": "string"
          },
          "storageAccountType": "string"
        }
      ],
      "osDisk": {
        "blobUri": "string",
        "caching": "string",
        "diskEncryptionSet": {
          "id": "string"
        },
        "diskSizeGB": "int",
        "managedDisk": {
          "id": "string"
        },
        "osState": "string",
        "osType": "string",
        "snapshot": {
          "id": "string"
        },
        "storageAccountType": "string"
      },
      "zoneResilient": "bool"
    }
  }
}

プロパティ値

images

名前	説明	値
type	リソースの種類	'Microsoft.Compute/images'
apiVersion	リソース API のバージョン	'2023-09-01'
name	リソース名	string (必須) 文字数制限: 1 から 80 有効な文字: 英数字、アンダースコア、ピリオド、およびハイフン。英数字で開始します。英数字またはアンダースコアで終了します。
location	リソースの場所	string (必須)
tags	リソースタグ	タグ名と値のディクショナリ。「テンプレートのタグ」を参照してください
extendedLocation	イメージの拡張された場所。	ExtendedLocation
properties	Image のプロパティについて説明します。	ImageProperties

ExtendedLocation

名前	説明	値
name	拡張場所の名前。	string
type	拡張された場所の型。	'EdgeZone'

ImageProperties

名前	説明	値
hyperVGeneration	イメージから作成された VirtualMachine の HyperVGenerationType を指定します。イメージソースが BLOB の場合は API バージョン 2019-03-01 から、ユーザーが値を指定する必要があります。ソースがディスクやスナップショットなどのマネージドリソースの場合、ソースマネージドリソースから推測できない場合は、ユーザーにプロパティの指定を要求する場合があります。	'V1' 'V2'
sourceVirtualMachine	イメージの作成元となるソース仮想マシン。	サブリソース
storageProfile	仮想マシンのストレージ設定を指定します。	ImageStorageProfile

サブリソース

名前	説明	値
id	リソース ID	string

ImageStorageProfile

名前	説明	値
dataDisks	仮想マシンにデータディスクを追加するために使用されるパラメーターを指定します。ディスクの詳細については、「 Azure 仮想マシンのディスクと VHD について」を参照してください。	ImageDataDisk[]
osDisk	仮想マシンで使用されるオペレーティングシステムディスクに関する情報を指定します。ディスクの詳細については、「 Azure 仮想マシンのディスクと VHD について」を参照してください。	ImageOSDisk
zoneResilient	イメージがゾーン回復性があるかどうかを指定します。既定値は false です。ゾーン回復性のあるイメージは、ゾーン冗長ストレージ (ZRS) を提供するリージョンでのみ作成できます。	[bool]

ImageDataDisk

名前	説明	値
blobUri	仮想ハードディスク。	string
キャッシュ	キャッシュの要件を指定します。使用できる値は、 None、ReadOnly、ReadWrite です。既定値は、 Standard Storage の場合は [なし] です。Premium Storage の ReadOnly。	'None' 'ReadOnly' 'ReadWrite'
diskEncryptionSet	マネージドイメージディスクのカスタマーマネージドディスク暗号化セットリソース ID を指定します。	DiskEncryptionSetParameters
diskSizeGB	空のデータディスクのサイズをギガバイト単位で指定します。この要素を使用して、仮想マシンイメージ内のディスクの名前を上書きできます。この値は 1023 GB を超えることはできません。	INT
lun	データディスクの論理ユニット番号を指定します。この値は、VM 内のデータディスクを識別するために使用されるため、VM に接続されているデータディスクごとに一意である必要があります。	int (必須)
managedDisk	managedDisk。	サブリソース
スナップショット	スナップショット。	サブリソース
storageAccountType	マネージドディスクのストレージアカウントの種類を指定します。注: UltraSSD_LRSはデータディスクでのみ使用できます。OS ディスクでは使用できません。	'PremiumV2_LRS' 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' 'UltraSSD_LRS'

DiskEncryptionSetParameters

名前	説明	値
id	リソース ID	string

ImageOSDisk

名前	説明	値
blobUri	仮想ハードディスク。	string
キャッシュ	キャッシュの要件を指定します。使用できる値は、 None、ReadOnly、ReadWrite です。既定値は、 Standard Storage の場合は [なし] です。Premium Storage の ReadOnly。	'None' 'ReadOnly' 'ReadWrite'
diskEncryptionSet	マネージドイメージディスクのカスタマーマネージドディスク暗号化セットリソース ID を指定します。	DiskEncryptionSetParameters
diskSizeGB	空のデータディスクのサイズをギガバイト単位で指定します。この要素を使用して、仮想マシンイメージ内のディスクの名前を上書きできます。この値は 1023 GB を超えることはできません。	INT
managedDisk	managedDisk。	サブリソース
osState	OS の状態。マネージドイメージの場合は、一般化を使用します。	'一般化' 'Specialized' (必須)
osType	このプロパティを使用すると、カスタムイメージから VM を作成する場合にディスクに含まれる OS の種類を指定できます。使用できる値は、Windows、Linux です。	'Linux' 'Windows' (必須)
スナップショット	スナップショット。	サブリソース
storageAccountType	マネージドディスクのストレージアカウントの種類を指定します。注: UltraSSD_LRSはデータディスクでのみ使用できます。OS ディスクでは使用できません。	'PremiumV2_LRS' 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' 'UltraSSD_LRS'

クイックスタートテンプレート

次のクイックスタートテンプレートでは、このリソースの種類をデプロイします。

Template	説明
ユーザーイメージから VM を作成する	このテンプレートを使用すると、ユーザーイメージからVirtual Machinesを作成できます。このテンプレートでは、Virtual Network、パブリック IP アドレス、ネットワークインターフェイスもデプロイされます。
一般化された VHD から新規または既存の vnet に VM を作成する	このテンプレートは、一般化された VHD から VM を作成し、仮想マシンとは別のリソースグループに存在できる新規または既存の VNET に接続できるようにします
Linux カスタムイメージを使用して VM スケールセットをデプロイする	このテンプレートを使用すると、スケールセット内にカスタム VM Linux イメージをデプロイできます。これらの VM は、HTTP 負荷分散を使用したロードバランサーの背後にあります (既定ではポート 80)。この例では、カスタムスクリプトを使用してアプリケーションのデプロイと更新を行います。独自の更新手順にカスタムスクリプトを指定する必要がある場合があります。 VMSS を作成するのと同じサブスクリプションとリージョンに、VM の一般化されたイメージを提供する必要があります。
Windows カスタムイメージを使用して VM スケールセットをデプロイする	このテンプレートを使用すると、カスタム Windows イメージを使用して単純な VM スケールセットをデプロイできます。これらの VM は、HTTP 負荷分散を使用するロードバランサーの背後にあります (ポート 80 では既定で)

Terraform (AzAPI プロバイダー) リソース定義

images リソースの種類は、次をターゲットとする操作でデプロイできます。

リソースグループ

各 API バージョンの変更されたプロパティの一覧については、「変更ログ」を参照してください。

リソース形式

Microsoft.Compute/images リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/images@2023-09-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      hyperVGeneration = "string"
      sourceVirtualMachine = {
        id = "string"
      }
      storageProfile = {
        dataDisks = [
          {
            blobUri = "string"
            caching = "string"
            diskEncryptionSet = {
              id = "string"
            }
            diskSizeGB = int
            lun = int
            managedDisk = {
              id = "string"
            }
            snapshot = {
              id = "string"
            }
            storageAccountType = "string"
          }
        ]
        osDisk = {
          blobUri = "string"
          caching = "string"
          diskEncryptionSet = {
            id = "string"
          }
          diskSizeGB = int
          managedDisk = {
            id = "string"
          }
          osState = "string"
          osType = "string"
          snapshot = {
            id = "string"
          }
          storageAccountType = "string"
        }
        zoneResilient = bool
      }
    }
    extendedLocation = {
      name = "string"
      type = "EdgeZone"
    }
  })
}

プロパティ値

images

名前	説明	値
type	リソースの種類	"Microsoft.Compute/images@2023-09-01"
name	リソース名	string (必須) 文字制限: 1 から 80 有効な文字: 英数字、アンダースコア、ピリオド、およびハイフン。英数字で開始します。英数字またはアンダースコアで終了します。
location	リソースの場所	string (必須)
parent_id	リソースグループにデプロイするには、そのリソースグループの ID を使用します。	string (必須)
tags	リソースタグ	タグの名前と値のディクショナリ。
extendedLocation	イメージの拡張された場所。	ExtendedLocation
properties	Image のプロパティについて説明します。	ImageProperties

ExtendedLocation

名前	説明	値
name	拡張場所の名前。	string
type	拡張場所の型。	"EdgeZone"

ImageProperties

名前	説明	値
hyperVGeneration	イメージから作成された VirtualMachine の HyperVGenerationType を指定します。イメージソースが BLOB の場合は API バージョン 2019-03-01 から、ユーザーに値を指定する必要があります。ソースがディスクやスナップショットなどのマネージドリソースの場合、ソース管理リソースから推測できない場合は、ユーザーにプロパティの指定を求める場合があります。	"V1" "V2"
sourceVirtualMachine	イメージの作成元となるソース仮想マシン。	サブリソース
storageProfile	仮想マシンのストレージ設定を指定します。	ImageStorageProfile

サブリソース

名前	説明	値
id	リソース ID	string

ImageStorageProfile

名前	説明	値
dataDisks	仮想マシンにデータディスクを追加するために使用されるパラメーターを指定します。ディスクの詳細については、「 Azure 仮想マシンのディスクと VHD について」を参照してください。	ImageDataDisk[]
osDisk	仮想マシンで使用されるオペレーティングシステムディスクに関する情報を指定します。ディスクの詳細については、「 Azure 仮想マシンのディスクと VHD について」を参照してください。	ImageOSDisk
zoneResilient	イメージがゾーンの回復性を持つかどうかを指定します。既定値は false です。ゾーン回復性のあるイメージは、ゾーン冗長ストレージ (ZRS) を提供するリージョンでのみ作成できます。	[bool]

ImageDataDisk

名前	説明	値
blobUri	仮想ハードディスク。	string
キャッシュ	キャッシュの要件を指定します。使用できる値は、 None、ReadOnly、ReadWrite です。既定値は、標準ストレージの場合は [なし] です。Premium Storage の ReadOnly。	"None" "ReadOnly" "ReadWrite"
diskEncryptionSet	マネージドイメージディスクのカスタマーマネージドディスク暗号化セットリソース ID を指定します。	DiskEncryptionSetParameters
diskSizeGB	空のデータディスクのサイズをギガバイト単位で指定します。この要素を使用して、仮想マシンイメージ内のディスクの名前を上書きできます。この値は 1023 GB を超えることはできません。	INT
lun	データディスクの論理ユニット番号を指定します。この値は、VM 内のデータディスクを識別するために使用されるため、VM に接続されているデータディスクごとに一意である必要があります。	int (必須)
managedDisk	managedDisk。	サブリソース
スナップショット	スナップショット。	サブリソース
storageAccountType	マネージドディスクのストレージアカウントの種類を指定します。注: UltraSSD_LRSはデータディスクでのみ使用できますが、OS ディスクでは使用できません。	"PremiumV2_LRS" "Premium_LRS" "Premium_ZRS" "StandardSSD_LRS" "StandardSSD_ZRS" "Standard_LRS" "UltraSSD_LRS"

DiskEncryptionSetParameters

名前	説明	値
id	リソース ID	string

ImageOSDisk

名前	説明	値
blobUri	仮想ハードディスク。	string
キャッシュ	キャッシュの要件を指定します。使用できる値は、 None、ReadOnly、ReadWrite です。既定値は、標準ストレージの場合は [なし] です。Premium Storage の ReadOnly。	"None" "ReadOnly" "ReadWrite"
diskEncryptionSet	マネージドイメージディスクのカスタマーマネージドディスク暗号化セットリソース ID を指定します。	DiskEncryptionSetParameters
diskSizeGB	空のデータディスクのサイズをギガバイト単位で指定します。この要素を使用して、仮想マシンイメージ内のディスクの名前を上書きできます。この値は 1023 GB を超えることはできません。	INT
managedDisk	managedDisk。	サブリソース
osState	OS の状態。マネージドイメージの場合は、一般化を使用します。	"一般化" "特殊化" (必須)
osType	このプロパティを使用すると、カスタムイメージから VM を作成する場合に、ディスクに含まれる OS の種類を指定できます。使用できる値は、 Windows、Linux です。	"Linux" "Windows" (必須)
スナップショット	スナップショット。	サブリソース
storageAccountType	マネージドディスクのストレージアカウントの種類を指定します。注: UltraSSD_LRSはデータディスクでのみ使用できますが、OS ディスクでは使用できません。	"PremiumV2_LRS" "Premium_LRS" "Premium_ZRS" "StandardSSD_LRS" "StandardSSD_ZRS" "Standard_LRS" "UltraSSD_LRS"

Microsoft.Compute イメージ 2023-09-01

Bicep リソース定義

リソース形式

プロパティ値

images

ExtendedLocation

ImageProperties

サブリソース

ImageStorageProfile

ImageDataDisk

DiskEncryptionSetParameters

ImageOSDisk

クイックスタートテンプレート

ARM テンプレートリソース定義

リソース形式

プロパティ値

images

ExtendedLocation

ImageProperties

サブリソース

ImageStorageProfile

ImageDataDisk

DiskEncryptionSetParameters

ImageOSDisk

クイックスタートテンプレート

Terraform (AzAPI プロバイダー) リソース定義

リソース形式

プロパティ値

images

ExtendedLocation

ImageProperties

サブリソース

ImageStorageProfile

ImageDataDisk

DiskEncryptionSetParameters

ImageOSDisk

フィードバック

フィードバック

その他のリソース

Microsoft.Compute イメージ 2023-09-01

Bicep リソース定義

リソース形式

プロパティ値

images

ExtendedLocation

ImageProperties

サブリソース

ImageStorageProfile

ImageDataDisk

DiskEncryptionSetParameters

ImageOSDisk

クイック スタート テンプレート

ARM テンプレート リソース定義

リソース形式

プロパティ値

images

ExtendedLocation

ImageProperties

サブリソース

ImageStorageProfile

ImageDataDisk

DiskEncryptionSetParameters

ImageOSDisk

クイック スタート テンプレート

Terraform (AzAPI プロバイダー) リソース定義

リソース形式

プロパティ値

images

ExtendedLocation

ImageProperties

サブリソース

ImageStorageProfile

ImageDataDisk

DiskEncryptionSetParameters

ImageOSDisk

フィードバック

フィードバック

その他のリソース

クイックスタートテンプレート

ARM テンプレートリソース定義

クイックスタートテンプレート