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

Microsoft.计算映像 2023-03-01

项目
08/16/2024

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
    }
  }
}

属性值

图像

名字	描述	价值
名字	资源名称	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	资源 ID	字符串

ImageStorageProfile

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

ImageDataDisk

名字	描述	价值
blobUri	虚拟硬盘。	字符串
缓存	指定缓存要求。可能的值为：None、ReadOnly、ReadWrite。默认值为：标准存储的 None。高级存储的 ReadOnly。	“None” “ReadOnly” “ReadWrite”
diskEncryptionSet	指定托管映像磁盘的客户托管磁盘加密集资源 ID。	DiskEncryptionSetParameters
diskSizeGB	指定空数据磁盘的大小（以 GB 为单位）。此元素可用于覆盖虚拟机映像中的磁盘名称。此值不能大于 1023 GB。	int
伦	指定数据磁盘的逻辑单元号。此值用于标识 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	资源 ID	字符串

ImageOSDisk

名字	描述	价值
blobUri	虚拟硬盘。	字符串
缓存	指定缓存要求。可能的值为：None、ReadOnly、ReadWrite。默认值为：标准存储的 None。高级存储的 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 磁盘一起使用。	“PremiumV2_LRS” “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 位于具有 HTTP 负载均衡的负载均衡器后面（默认情况下在端口 80 上）。该示例使用自定义脚本执行应用程序部署和更新，可能需要为自己的更新过程提供自定义脚本。必须在创建 VMSS 的同一订阅和区域中提供 VM 的通用化映像。
使用 Windows 自定义映像部署 VM 规模集	使用此模板可以部署简单的 VM 规模集，从而部署自定义 Windows 映像。这些 VM 位于具有 HTTP 负载均衡的负载均衡器后面（默认情况下在端口 80 上）

ARM 模板资源定义

可以使用目标操作部署映像资源类型：

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

有关每个 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"
    }
  }
}

属性值

图像

名字	描述	价值
类型	资源类型	“Microsoft.Compute/images”
apiVersion	资源 API 版本	'2023-03-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	资源 ID	字符串

ImageStorageProfile

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

ImageDataDisk

名字	描述	价值
blobUri	虚拟硬盘。	字符串
缓存	指定缓存要求。可能的值为：None、ReadOnly、ReadWrite。默认值为：标准存储的 None。高级存储的 ReadOnly。	“None” “ReadOnly” “ReadWrite”
diskEncryptionSet	指定托管映像磁盘的客户托管磁盘加密集资源 ID。	DiskEncryptionSetParameters
diskSizeGB	指定空数据磁盘的大小（以 GB 为单位）。此元素可用于覆盖虚拟机映像中的磁盘名称。此值不能大于 1023 GB。	int
伦	指定数据磁盘的逻辑单元号。此值用于标识 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	资源 ID	字符串

ImageOSDisk

名字	描述	价值
blobUri	虚拟硬盘。	字符串
缓存	指定缓存要求。可能的值为：None、ReadOnly、ReadWrite。默认值为：标准存储的 None。高级存储的 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 磁盘一起使用。	“PremiumV2_LRS” “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 位于具有 HTTP 负载均衡的负载均衡器后面（默认情况下在端口 80 上）。该示例使用自定义脚本执行应用程序部署和更新，可能需要为自己的更新过程提供自定义脚本。必须在创建 VMSS 的同一订阅和区域中提供 VM 的通用化映像。
使用 Windows 自定义映像部署 VM 规模集	使用此模板可以部署简单的 VM 规模集，从而部署自定义 Windows 映像。这些 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"
    }
  })
}

属性值

图像

名字	描述	价值
类型	资源类型	“Microsoft.Compute/images@2023-03-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	资源 ID	字符串

ImageStorageProfile

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

ImageDataDisk

名字	描述	价值
blobUri	虚拟硬盘。	字符串
缓存	指定缓存要求。可能的值为：None、ReadOnly、ReadWrite。默认值为：标准存储的 None。高级存储的 ReadOnly。	“None” “ReadOnly” “ReadWrite”
diskEncryptionSet	指定托管映像磁盘的客户托管磁盘加密集资源 ID。	DiskEncryptionSetParameters
diskSizeGB	指定空数据磁盘的大小（以 GB 为单位）。此元素可用于覆盖虚拟机映像中的磁盘名称。此值不能大于 1023 GB。	int
伦	指定数据磁盘的逻辑单元号。此值用于标识 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	资源 ID	字符串

ImageOSDisk

名字	描述	价值
blobUri	虚拟硬盘。	字符串
缓存	指定缓存要求。可能的值为：None、ReadOnly、ReadWrite。默认值为：标准存储的 None。高级存储的 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 磁盘一起使用。	“PremiumV2_LRS” “Premium_LRS” “Premium_ZRS” “StandardSSD_LRS” “StandardSSD_ZRS” “Standard_LRS” “UltraSSD_LRS”

通过

Microsoft.计算映像 2023-03-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

反馈

其他资源