你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Microsoft.Compute images 2021-03-01

项目
03/09/2024

Bicep 资源定义

可以使用针对以下操作部署映像资源类型：

资源组 - 请参阅资源组部署命令

有关每个 API 版本中更改的属性的列表，请参阅更改日志。

资源格式

若要创建 Microsoft.Compute/images 资源，请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.Compute/images@2021-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	资源名称	字符串 (必需) 字符限制：1-80 有效字符：字母数字、下划线字符、句点和连字符。以字母数字开头。以字母数字或下划线结尾。
location	资源位置	字符串 (必需)
标记	资源标记	标记名称和值的字典。请参阅模板中的标记
extendedLocation	映像的扩展位置。	ExtendedLocation
properties	描述 Image 的属性。	ImageProperties

ExtendedLocation

名称	说明	值
name	扩展位置的名称。	字符串
type	扩展位置的类型。	“EdgeZone”

ImageProperties

名称	说明	值
hyperVGeneration	指定从映像创建的 VirtualMachine 的 HyperVGenerationType。从 API 版本 2019-03-01（如果映像源是 Blob），那么我们需要用户指定值，如果源是托管资源（如磁盘或快照），如果无法从源托管资源推断它，则可能需要用户指定属性。	“V1” “V2”
sourceVirtualMachine	从中创建映像的源虚拟机。	SubResource
storageProfile	指定虚拟机磁盘的存储设置。	ImageStorageProfile

SubResource

名称	说明	Value
id	资源 ID	字符串

ImageStorageProfile

名称	说明	值
dataDisks	指定用于将数据磁盘添加到虚拟机的参数。有关磁盘的详细信息，请参阅关于 Azure 虚拟机的磁盘和 VHD。	ImageDataDisk[]
osDisk	指定有关虚拟机使用的操作系统磁盘的信息。有关磁盘的详细信息，请参阅关于 Azure 虚拟机的磁盘和 VHD。	ImageOSDisk
zoneResilient	指定映像是否具有区域复原能力。默认值为 false。只能在提供区域冗余存储 (ZRS) 的区域中创建区域可复原映像。	bool

ImageDataDisk

名称	说明	值
blobUri	虚拟硬盘。	字符串
缓存	指定缓存要求。可能的值为：无 ReadOnly ReadWrite 默认值：对于标准存储，无。适用于高级存储的 ReadOnly	“None” “ReadOnly” “ReadWrite”
diskEncryptionSet	指定托管映像磁盘的客户托管磁盘加密集资源 ID。	DiskEncryptionSetParameters
diskSizeGB	指定空数据磁盘的大小（以 GB 为单位）。此元素可用于覆盖虚拟机映像中的磁盘名称。此值不能大于 1023 GB	int
lun	指定数据磁盘的逻辑单元号。此值用于标识 VM 中的数据磁盘，因此对于附加到 VM 的每个数据磁盘必须是唯一的。	int (必需)
managedDisk	managedDisk。	SubResource
快照	快照。	SubResource
storageAccountType	指定托管磁盘的存储帐户类型。注意：UltraSSD_LRS只能与数据磁盘一起使用，它不能与 OS 磁盘一起使用。	“Premium_LRS” “Premium_ZRS” “StandardSSD_LRS” “StandardSSD_ZRS” “Standard_LRS” “UltraSSD_LRS”

DiskEncryptionSetParameters

名称	说明	Value
id	资源 ID	字符串

ImageOSDisk

名称	说明	值
blobUri	虚拟硬盘。	字符串
缓存	指定缓存要求。可能的值为：无 ReadOnly ReadWrite 默认值：对于标准存储，无。适用于高级存储的 ReadOnly	“None” “ReadOnly” “ReadWrite”
diskEncryptionSet	指定托管映像磁盘的客户托管磁盘加密集资源 ID。	DiskEncryptionSetParameters
diskSizeGB	指定空数据磁盘的大小（以 GB 为单位）。此元素可用于覆盖虚拟机映像中的磁盘名称。此值不能大于 1023 GB	int
managedDisk	managedDisk。	SubResource
osState	OS 状态。	“通用化” 需要“专用” ()
osType	此属性允许指定从自定义映像创建 VM 时磁盘中包含的 OS 的类型。可能的值为： Windows Linux	“Linux” “Windows” (必需)
快照	快照。	SubResource
storageAccountType	指定托管磁盘的存储帐户类型。注意：UltraSSD_LRS只能与数据磁盘一起使用，它不能与 OS 磁盘一起使用。	“Premium_LRS” “Premium_ZRS” “StandardSSD_LRS” “StandardSSD_ZRS” “Standard_LRS” “UltraSSD_LRS”

快速入门模板

以下快速入门模板部署此资源类型。

模板	说明
从用户映像创建 VM	此模板允许你从用户映像创建虚拟机。此模板还部署虚拟网络、公共 IP 地址和网络接口。
从通用 VHD 在新的或现有的 VNet 中创建 VM	此模板从通用 VHD 创建 VM，并允许将其连接到可以驻留在虚拟机以外的其他资源组中的新 VNET 或现有 VNET
使用 Linux 自定义映像部署 VM 规模集	此模板允许在规模集中部署自定义 VM Linux 映像。这些 VM 位于负载均衡器后面，默认情况下端口 80) 上的 HTTP 负载均衡 (。此示例使用自定义脚本执行应用程序部署和更新，可能需要为自己的更新过程提供自定义脚本。必须在创建 VMSS 的同一订阅和区域中提供 VM 的通用映像。
使用 Windows 自定义映像部署 VM 规模集	此模板允许部署简单的 VM 规模集，并自定义 Windows 映像。这些 VM 位于负载均衡器后面，默认情况下端口 80 (上的 HTTP 负载均衡)

ARM 模板资源定义

可以使用面向以下操作部署映像资源类型：

资源组 - 请参阅资源组部署命令

有关每个 API 版本中已更改属性的列表，请参阅更改日志。

资源格式

若要创建 Microsoft.Compute/images 资源，请将以下 JSON 添加到模板。

{
  "type": "Microsoft.Compute/images",
  "apiVersion": "2021-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

名称	说明	Value
type	资源类型	“Microsoft.Compute/images”
apiVersion	资源 API 版本	'2021-03-01'
name	资源名称	字符串 (必需) 字符限制：1-80 有效字符：字母数字、下划线字符、句点和连字符。以字母数字开头。以字母数字或下划线结尾。
location	资源位置	字符串 (必需)
标记	资源标记	标记名称和值的字典。请参阅模板中的标记
extendedLocation	映像的扩展位置。	ExtendedLocation
properties	描述图像的属性。	ImageProperties

ExtendedLocation

名称	说明	值
name	扩展位置的名称。	字符串
type	扩展位置的类型。	“EdgeZone”

ImageProperties

名称	说明	值
hyperVGeneration	指定从映像创建的 VirtualMachine 的 HyperVGenerationType。从 API 版本 2019-03-01 开始，如果映像源是 Blob，则我们需要用户指定值，如果源是托管资源（如磁盘或快照），则如果我们无法从源托管资源推断它，则可能需要用户指定属性。	“V1” “V2”
sourceVirtualMachine	从中创建映像的源虚拟机。	SubResource
storageProfile	指定虚拟机磁盘的存储设置。	ImageStorageProfile

SubResource

名称	说明	Value
id	资源 ID	字符串

ImageStorageProfile

名称	说明	值
dataDisks	指定用于将数据磁盘添加到虚拟机的参数。有关磁盘的详细信息，请参阅关于 Azure 虚拟机的磁盘和 VHD。	ImageDataDisk[]
osDisk	指定有关虚拟机使用的操作系统磁盘的信息。有关磁盘的详细信息，请参阅关于 Azure 虚拟机的磁盘和 VHD。	ImageOSDisk
zoneResilient	指定映像是否具有区域复原能力。默认值为 false。只能在提供区域冗余存储 (ZRS) 的区域中创建区域复原映像。	bool

ImageDataDisk

名称	说明	值
blobUri	虚拟硬盘。	字符串
缓存	指定缓存要求。可能的值为：无 ReadOnly ReadWrite 默认值：对于标准存储，无。高级存储的 ReadOnly	“None” “ReadOnly” “ReadWrite”
diskEncryptionSet	指定托管映像磁盘的客户托管磁盘加密集资源 ID。	DiskEncryptionSetParameters
diskSizeGB	指定空数据磁盘的大小（以 GB 为单位）。此元素可用于覆盖虚拟机映像中的磁盘名称。此值不能大于 1023 GB	int
lun	指定数据磁盘的逻辑单元号。此值用于标识 VM 中的数据磁盘，因此对于附加到 VM 的每个数据磁盘必须是唯一的。	int (必需)
managedDisk	managedDisk。	SubResource
快照	快照。	SubResource
storageAccountType	指定托管磁盘的存储帐户类型。注意：UltraSSD_LRS只能与数据磁盘一起使用，不能与 OS 磁盘一起使用。	“Premium_LRS” “Premium_ZRS” “StandardSSD_LRS” “StandardSSD_ZRS” “Standard_LRS” “UltraSSD_LRS”

DiskEncryptionSetParameters

名称	说明	Value
id	资源 ID	字符串

ImageOSDisk

名称	说明	值
blobUri	虚拟硬盘。	字符串
缓存	指定缓存要求。可能的值为：无 ReadOnly ReadWrite 默认值：对于标准存储，无。高级存储的 ReadOnly	“None” “ReadOnly” “ReadWrite”
diskEncryptionSet	指定托管映像磁盘的客户托管磁盘加密集资源 ID。	DiskEncryptionSetParameters
diskSizeGB	指定空数据磁盘的大小（以 GB 为单位）。此元素可用于覆盖虚拟机映像中的磁盘名称。此值不能大于 1023 GB	int
managedDisk	managedDisk。	SubResource
osState	OS 状态。	“通用化” “专用化” ()
osType	此属性允许指定磁盘中包含的 OS 类型（如果从自定义映像创建 VM）。可能的值为： Windows Linux	'Linux' “Windows” (必需)
快照	快照。	SubResource
storageAccountType	指定托管磁盘的存储帐户类型。注意：UltraSSD_LRS只能与数据磁盘一起使用，不能与 OS 磁盘一起使用。	“Premium_LRS” “Premium_ZRS” “StandardSSD_LRS” “StandardSSD_ZRS” “Standard_LRS” “UltraSSD_LRS”

快速入门模板

以下快速入门模板部署此资源类型。

模板	说明
从用户映像创建 VM	此模板允许你从用户映像创建虚拟机。此模板还部署虚拟网络、公共 IP 地址和网络接口。
从通用 VHD 在新的或现有的 VNet 中创建 VM	此模板从通用 VHD 创建 VM，并允许将其连接到可以驻留在虚拟机以外的其他资源组中的新 VNET 或现有 VNET
使用 Linux 自定义映像部署 VM 规模集	此模板允许在规模集中部署自定义 VM Linux 映像。这些 VM 位于负载均衡器后面，默认情况下端口 80) 上的 HTTP 负载均衡 (。此示例使用自定义脚本执行应用程序部署和更新，可能需要为自己的更新过程提供自定义脚本。必须在创建 VMSS 的同一订阅和区域中提供 VM 的通用映像。
使用 Windows 自定义映像部署 VM 规模集	此模板允许部署简单的 VM 规模集，并自定义 Windows 映像。这些 VM 位于负载均衡器后面，默认情况下端口 80 (上的 HTTP 负载均衡)

Terraform (AzAPI 提供程序) 资源定义

可以使用面向以下操作部署映像资源类型：

资源组

有关每个 API 版本中已更改属性的列表，请参阅更改日志。

资源格式

若要创建 Microsoft.Compute/images 资源，请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/images@2021-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

名称	说明	Value
type	资源类型	“Microsoft.Compute/images@2021-03-01”
name	资源名称	字符串 (必需) 字符限制：1-80 有效字符：字母数字、下划线字符、句点和连字符。以字母数字开头。以字母数字或下划线结尾。
location	资源位置	字符串 (必需)
parent_id	若要部署到资源组，请使用该资源组的 ID。	字符串 (必需)
标记	资源标记	标记名称和值的字典。
extendedLocation	映像的扩展位置。	ExtendedLocation
properties	描述图像的属性。	ImageProperties

ExtendedLocation

名称	说明	值
name	扩展位置的名称。	字符串
type	扩展位置的类型。	“EdgeZone”

ImageProperties

名称	说明	值
hyperVGeneration	指定从映像创建的 VirtualMachine 的 HyperVGenerationType。从 API 版本 2019-03-01 开始，如果映像源是 Blob，则我们需要用户指定值，如果源是托管资源（如磁盘或快照），则如果我们无法从源托管资源推断它，则可能需要用户指定属性。	“V1” “V2”
sourceVirtualMachine	从中创建映像的源虚拟机。	SubResource
storageProfile	指定虚拟机磁盘的存储设置。	ImageStorageProfile

SubResource

名称	说明	Value
id	资源 ID	字符串

ImageStorageProfile

名称	说明	值
dataDisks	指定用于将数据磁盘添加到虚拟机的参数。有关磁盘的详细信息，请参阅关于 Azure 虚拟机的磁盘和 VHD。	ImageDataDisk[]
osDisk	指定有关虚拟机使用的操作系统磁盘的信息。有关磁盘的详细信息，请参阅关于 Azure 虚拟机的磁盘和 VHD。	ImageOSDisk
zoneResilient	指定映像是否具有区域复原能力。默认值为 false。只能在提供区域冗余存储 (ZRS) 的区域中创建区域复原映像。	bool

ImageDataDisk

名称	说明	值
blobUri	虚拟硬盘。	字符串
缓存	指定缓存要求。可能的值为：无 ReadOnly ReadWrite 默认值：对于标准存储，无。高级存储的 ReadOnly	"None" “ReadOnly” “ReadWrite”
diskEncryptionSet	指定托管映像磁盘的客户托管磁盘加密集资源 ID。	DiskEncryptionSetParameters
diskSizeGB	指定空数据磁盘的大小（以 GB 为单位）。此元素可用于覆盖虚拟机映像中的磁盘名称。此值不能大于 1023 GB	int
lun	指定数据磁盘的逻辑单元号。此值用于标识 VM 中的数据磁盘，因此对于附加到 VM 的每个数据磁盘必须是唯一的。	int (必需)
managedDisk	managedDisk。	SubResource
快照	快照。	SubResource
storageAccountType	指定托管磁盘的存储帐户类型。注意：UltraSSD_LRS只能与数据磁盘一起使用，不能与 OS 磁盘一起使用。	“Premium_LRS” “Premium_ZRS” “StandardSSD_LRS” “StandardSSD_ZRS” “Standard_LRS” “UltraSSD_LRS”

DiskEncryptionSetParameters

名称	说明	Value
id	资源 ID	字符串

ImageOSDisk

名称	说明	值
blobUri	虚拟硬盘。	字符串
缓存	指定缓存要求。可能的值为：无 ReadOnly ReadWrite 默认值：对于标准存储，无。高级存储的 ReadOnly	"None" “ReadOnly” “ReadWrite”
diskEncryptionSet	指定托管映像磁盘的客户托管磁盘加密集资源 ID。	DiskEncryptionSetParameters
diskSizeGB	指定空数据磁盘的大小（以 GB 为单位）。此元素可用于覆盖虚拟机映像中的磁盘名称。此值不能大于 1023 GB	int
managedDisk	managedDisk。	SubResource
osState	OS 状态。	“通用化” 需要“专用化” ()
osType	此属性允许指定磁盘中包含的 OS 类型（如果从自定义映像创建 VM）。可能的值为： Windows Linux	“Linux” “Windows” (必需)
快照	快照。	SubResource
storageAccountType	指定托管磁盘的存储帐户类型。注意：UltraSSD_LRS只能与数据磁盘一起使用，不能与 OS 磁盘一起使用。	“Premium_LRS” “Premium_ZRS” “StandardSSD_LRS” “StandardSSD_ZRS” “Standard_LRS” “UltraSSD_LRS”

Microsoft.Compute images 2021-03-01

Bicep 资源定义

资源格式

属性值

images

ExtendedLocation

ImageProperties

SubResource

ImageStorageProfile

ImageDataDisk

DiskEncryptionSetParameters

ImageOSDisk

快速入门模板

ARM 模板资源定义

资源格式

属性值

images

ExtendedLocation

ImageProperties

SubResource

ImageStorageProfile

ImageDataDisk

DiskEncryptionSetParameters

ImageOSDisk

快速入门模板

Terraform (AzAPI 提供程序) 资源定义

资源格式

属性值

images

ExtendedLocation

ImageProperties

SubResource

ImageStorageProfile

ImageDataDisk

DiskEncryptionSetParameters

ImageOSDisk

反馈

反馈

其他资源