cloudPcDeviceImage 资源类型
命名空间:microsoft.graph
表示云电脑上的图像资源。
继承自 entity。
Methods
方法 | 返回类型 | Description |
---|---|---|
List | cloudPcDeviceImage 集合 | 列出 上传到云电脑的 cloudPcDeviceImage 对象的属性和关系 (操作系统映像) 。 |
Get | cloudPcDeviceImage | 读取特定 cloudPcDeviceImage 对象的属性和关系。 |
创建 | cloudPcDeviceImage | 创建新的 cloudPcDeviceImage 对象。 |
删除 | None | 删除 cloudPcDeviceImage 对象。 |
获取源图像 | cloudPcSourceDeviceImage 集合 | 获取可在云电脑上上传和使用的 cloudPcSourceDeviceImage 对象。 |
属性
属性 | 类型 | 说明 |
---|---|---|
displayName | String | 关联设备映像的显示名称。 设备映像显示名称和版本用于唯一标识云电脑设备映像。 只读。 |
errorCode | cloudPcDeviceImageErrorCode | 图像状态的错误代码,指示上传失败的原因(如果适用)。 可取值为:internalServerError 、sourceImageNotFound 、osVersionNotSupported 、sourceImageInvalid 、sourceImageNotGeneralized 、unknownFutureValue 、vmAlreadyAzureAdJoined 、paidSourceImageNotSupport 、sourceImageNotSupportCustomizeVMName 、sourceImageSizeExceedsLimitation 。
Prefer: include-unknown-enum-members 使用请求标头从此可演变枚举中获取以下值:vmAlreadyAzureAdJoined 、paidSourceImageNotSupport 、、sourceImageNotSupportCustomizeVMName sourceImageSizeExceedsLimitation 。 只读。 |
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"
}