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

[アーティクル]
08/16/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
    }
  }
}

プロパティ値

画像

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

ExtendedLocation

名前	形容	価値
名前	拡張された場所の名前。	糸
種類	拡張された場所の型。	'EdgeZone'

ImageProperties

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

SubResource

名前	形容	価値
身分証明書	リソース ID	糸

ImageStorageProfile

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

ImageDataDisk

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

DiskEncryptionSetParameters

名前	形容	価値
身分証明書	リソース ID	糸

ImageOSDisk

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

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

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

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

プロパティ値

画像

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

ExtendedLocation

名前	形容	価値
名前	拡張された場所の名前。	糸
種類	拡張された場所の型。	'EdgeZone'

ImageProperties

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

SubResource

名前	形容	価値
身分証明書	リソース ID	糸

ImageStorageProfile

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

ImageDataDisk

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

DiskEncryptionSetParameters

名前	形容	価値
身分証明書	リソース ID	糸

ImageOSDisk

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

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

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

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

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

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

リソースグループの

各 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"
    }
  })
}

プロパティ値

画像

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

ExtendedLocation

名前	形容	価値
名前	拡張された場所の名前。	糸
種類	拡張された場所の型。	"EdgeZone"

ImageProperties

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

SubResource

名前	形容	価値
身分証明書	リソース ID	糸

ImageStorageProfile

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

ImageDataDisk

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

DiskEncryptionSetParameters

名前	形容	価値
身分証明書	リソース ID	糸

ImageOSDisk

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

次の方法で共有

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

Bicep リソース定義

リソースの形式

プロパティ値

画像

ExtendedLocation

ImageProperties

SubResource

ImageStorageProfile

ImageDataDisk

DiskEncryptionSetParameters

ImageOSDisk

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

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

リソースの形式

プロパティ値

画像

ExtendedLocation

ImageProperties

SubResource

ImageStorageProfile

ImageDataDisk

DiskEncryptionSetParameters

ImageOSDisk

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

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

リソースの形式

プロパティ値

画像

ExtendedLocation

ImageProperties

SubResource

ImageStorageProfile

ImageDataDisk

DiskEncryptionSetParameters

ImageOSDisk

フィードバック

その他のリソース

次の方法で共有

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

Bicep リソース定義

リソースの形式

プロパティ値

画像

ExtendedLocation

ImageProperties

SubResource

ImageStorageProfile

ImageDataDisk

DiskEncryptionSetParameters

ImageOSDisk

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

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

リソースの形式

プロパティ値

画像

ExtendedLocation

ImageProperties

SubResource

ImageStorageProfile

ImageDataDisk

DiskEncryptionSetParameters

ImageOSDisk

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

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

リソースの形式

プロパティ値

画像

ExtendedLocation

ImageProperties

SubResource

ImageStorageProfile

ImageDataDisk

DiskEncryptionSetParameters

ImageOSDisk

フィードバック

その他のリソース

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

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

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