cloudPcDeviceImage 资源类型

命名空间：microsoft.graph

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

继承自 entity。

Methods

方法	返回类型	说明
列出 deviceImages	cloudPcDeviceImage 集合	列出 上传到云电脑的 cloudPcDeviceImage 对象的属性和关系 (操作系统映像) 。
获取 cloudPcDeviceImage	cloudPcDeviceImage	读取特定 cloudPcDeviceImage 对象的属性和关系。
创建 cloudPcDeviceImage	cloudPcDeviceImage	创建新的 cloudPcDeviceImage 对象。
删除 cloudPcDeviceImage	无	删除 cloudPcDeviceImage 对象。
getSourceImages	cloudPcSourceDeviceImage 集合	获取可在云电脑上上传和使用的 cloudPcSourceDeviceImage 对象。

属性

属性	类型	说明
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) 。 只读。 继承自 entity。
lastModifiedDateTime	DateTimeOffset	上次修改图像的数据和时间。 时间戳使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 只读。
operatingSystem	String	操作系统 (映像的 OS) 。 例如，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。 此为只读属性。

cloudPcDeviceImageErrorCode 值

成员	说明
internalServerError	指示处理图像时发生内部服务器错误。
sourceImageNotFound	指示源图像不可访问或找不到。
osVersionNotSupported	指示操作系统版本不受支持。
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 值。 请勿使用。

关系

无。

JSON 表示形式

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

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