Microsoft.Compute イメージ

Bicep リソース定義

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

  • リソース グループの - リソース グループのデプロイ コマンド 参照

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

リソースの形式

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

resource symbolicname 'Microsoft.Compute/images@2024-07-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": "2024-07-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 のバージョン '2024-07-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@2024-07-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@2024-07-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"