cloudPcDeviceImage 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

表示云电脑上的图像资源。

方法

方法	返回类型	说明
列出 deviceImages	cloudPcDeviceImage 集合	列出 cloudPcDeviceImage 对象的属性和关系。
获取 cloudPcDeviceImage	cloudPcDeviceImage	读取 cloudPcDeviceImage 对象的属性和关系。
创建 cloudPcDeviceImage	cloudPcDeviceImage	创建新的 cloudPcDeviceImage 对象。
删除 cloudPcDeviceImage	无	删除 cloudPcDeviceImage 对象。
getSourceImages	cloudPcSourceDeviceImage 集合	获取 cloudPcSourceDeviceImage 对象。
重新上传 cloudPcDeviceImage	无	重新加载无法上传的 cloudPcDeviceImage 对象。

属性

属性	类型	说明
displayName	String	关联设备映像的显示名称。 设备映像显示名称和版本用于唯一标识云电脑设备映像。 此为只读属性。
errorCode	cloudPcDeviceImageErrorCode	图像状态的错误代码，指示上传失败的原因（如果适用）。 可取值为：internalServerError、sourceImageNotFound、osVersionNotSupported、sourceImageInvalid、sourceImageNotGeneralized、unknownFutureValue、vmAlreadyAzureAdJoined、paidSourceImageNotSupport、sourceImageNotSupportCustomizeVMName、sourceImageSizeExceedsLimitation。 请注意，必须使用Prefer: include-unknown-enum-members请求标头从此可演变枚举中获取以下值：vmAlreadyAzureAdJoined、、paidSourceImageNotSupport、sourceImageNotSupportCustomizeVMNamesourceImageSizeExceedsLimitation。 此为只读属性。
expirationDate	日期	映像不可用的日期。 只读。
id	String	云电脑上映像资源的唯一标识符 (ID) 。 只读。
lastModifiedDateTime	DateTimeOffset	上次修改图像的数据和时间。 时间戳使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 只读。
operatingSystem	String	映像的操作系统。 例如，Windows 10 Enterprise。 此为只读属性。
osBuildNumber	String	映像的 OS 内部版本。 例如，1909。 此为只读属性。
osStatus	cloudPcDeviceImageOsStatus	此映像的 OS 状态。 可能的值是：supported、supportedWithWarning、unknown、unknownFutureValue。 默认值为 unknown。 此为只读属性。
sourceImageResourceId	String	Azure 上源映像资源的唯一标识符 (ID) 。 所需的 ID 格式为：“/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/images/{imageName}”。 此为只读属性。
status	cloudPcDeviceImageStatus	云电脑上映像的状态。 可能的值是：pending、ready、failed、unknownFutureValue。 此为只读属性。
version	String	映像版本。 例如， 0.0.1 和 1.5.13。 此为只读属性。
statusDetails (已弃用)	cloudPcDeviceImageStatusDetails	图像状态的详细信息，指示上传失败的原因（如果适用）。 可取值为：internalServerError、sourceImageNotFound、osVersionNotSupported、sourceImageInvalid、sourceImageNotGeneralized、unknownFutureValue、vmAlreadyAzureAdJoined、paidSourceImageNotSupport、sourceImageNotSupportCustomizeVMName、sourceImageSizeExceedsLimitation。 请注意，必须使用Prefer: include-unknown-enum-members请求标头从此可演变枚举中获取以下值：vmAlreadyAzureAdJoined、、paidSourceImageNotSupport、sourceImageNotSupportCustomizeVMNamesourceImageSizeExceedsLimitation。 此为只读属性。 statusDetails 属性已弃用，将于 2024 年 1 月 31 日停止返回数据。 今后，请使用 errorCode 属性。

cloudPcDeviceImageErrorCode 值

成员	说明
internalServerError	处理图像期间发生内部服务器错误。
sourceImageNotFound	源图像不可访问或找不到。
osVersionNotSupported	不支持 OS 版本。
sourceImageInvalid	源映像对于预配 Windows 虚拟机 (VM) 无效。
sourceImageNotGeneralized	上传的图像尚未通用化。 运行 sysprep/generalize 命令后重新上传映像。 若要了解详细信息，请参阅 在创建映像之前通过取消预配或通用化 VM 来删除特定于计算机的信息。
unknownFutureValue	可演变枚举 sentinel 值。 请勿使用。
vmAlreadyAzureAdJoined	已将生成用于创建设备映像的源映像的 VM 联接到Microsoft Entra。 这可以防止验证过程允许使用此类源映像创建设备映像。
paidSourceImageNotSupport	此源映像是从Azure 市场的另一个付费映像生成的，不受支持;请使用其他源继续。
sourceImageNotSupportCustomizeVMName	生成的通用化映像上存在计算机名称设置问题，这阻止使用提供的映像自定义 VM 名称。
sourceImageSizeExceedsLimitation	客户上传的源映像的大小超出了共享映像库 (SIG) 限制，从而导致映像创建失败。

cloudPcDeviceImageOsStatus 值

成员	说明
支持	指示云电脑设备映像操作系统处于活动状态并已准备好用于预配。
supportedWithWarning	指示云电脑设备映像操作系统已过期，但云电脑继续支持。 如果用户继续使用，他们可能无法获取安全更新。
unknown	默认值。 指示云电脑设备的操作系统映像状态未知。
unknownFutureValue	可演变枚举 sentinel 值。 请勿使用。

cloudPcDeviceImageStatus 值

成员	说明
等待	图像上传正在进行中。
准备	映像已准备好在云电脑上使用。
失败	指示无法上传映像。
unknownFutureValue	可演变枚举 sentinel 值。 请勿使用。

cloudPcDeviceImageStatusDetails 值

成员	说明
internalServerError	处理图像期间发生内部服务器错误。
sourceImageNotFound	源图像不可访问或找不到。
osVersionNotSupported	不支持 OS 版本。
sourceImageInvalid	源映像对于预配 Windows 虚拟机 (VM) 无效。
sourceImageNotGeneralized	上传的图像未通用化。 运行 sysprep/generalize 命令后重新上传映像。 若要了解详细信息，请参阅 在创建映像之前通过取消预配或通用化 VM 来删除特定于计算机的信息。
unknownFutureValue	可演变枚举 sentinel 值。 请勿使用。
vmAlreadyAzureAdJoined	已将生成用于创建设备映像的源映像的 VM 联接到Microsoft Entra。 这可以防止验证过程允许使用此类源映像创建设备映像。
paidSourceImageNotSupport	此源映像是从Azure 市场的另一个付费映像生成的，不受支持;请使用其他源继续。
sourceImageNotSupportCustomizeVMName	生成的通用化映像上存在计算机名称设置问题，这阻止使用提供的映像自定义 VM 名称。
sourceImageSizeExceedsLimitation	客户上传的源映像的大小超出了共享映像库 (SIG) 限制，从而导致映像创建失败。

关系

无。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "@odata.type": "#microsoft.graph.cloudPcDeviceImage",
  "displayName": "String",
  "errorCode": "String",
  "expirationDate": "String (timestamp)",
  "id": "String (identifier)",
  "lastModifiedDateTime": "String (timestamp)",
  "operatingSystem": "String",
  "osBuildNumber": "String",
  "osStatus": "String",
  "sourceImageResourceId": "String",
  "status": "String",
  "statusDetails": "String",
  "version": "String"
}