Microsoft.Compute イメージ 2024-07-01
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" |