Microsoft.Compute イメージ 2023-03-01
Bicep リソース定義
イメージ リソースの種類は、次を対象とする操作でデプロイできます。
- リソース グループ - リソース グループのデプロイ コマンドに関するページを参照してください
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.Compute/images リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.Compute/images@2023-03-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 テンプレート リソース定義
images リソースの種類は、次をターゲットとする操作でデプロイできます。
- リソース グループ - リソース グループのデプロイ コマンドを参照してください
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.Compute/images リソースを作成するには、次の JSON をテンプレートに追加します。
{
"type": "Microsoft.Compute/images",
"apiVersion": "2023-03-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-03-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 です。 既定値は、 標準ストレージの場合は [なし] です。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 の状態。 マネージド イメージの場合は、一般化を使用します。 | '一般化' '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 プロバイダー) リソース定義
イメージ リソースの種類は、次を対象とする操作でデプロイできます。
- リソース グループ
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.Compute/images リソースを作成するには、次の Terraform をテンプレートに追加します。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/images@2023-03-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-03-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" |
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示