命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示可用于预配云电脑的当前组织的库映像资源。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | cloudPcGalleryImage 集合 | 列出 cloudPcGalleryImage 对象的属性和关系。 |
| Get | cloudPcGalleryImage | 读取特定 cloudPcGalleryImage 对象的属性和关系。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| displayName | String | 此库图像的显示名称。 例如，Windows 11 Enterprise + Microsoft 365 Apps 22H2。 只读。 |
| endDate | 日期 | 图像状态变为 supportedWithWarning的日期。 如果当前时间晚于 endDate 且早于 expirationDate，则用户仍可以预配新的云电脑。 例如，假设库映像的 endDate 为 2023-9-14 ， expirationDate 为 2024-3-14，如果今天为 2023-10-01，则用户可以预配新的云电脑。 只读。 |
| expirationDate | 日期 | 映像不再可用的日期。 如果当前时间晚于 expirationDate，则用户无法预配新的云电脑。 该值通常为 endDate 加 6 个月。 例如，如果 startDate 为 2025-10-14，则 expirationDate 通常是 2026-04-14。 只读。 |
| id | String | 云电脑上库映像资源的唯一标识符 (ID) 。 ID 格式为 {publisherName_offerName_skuName}。 例如，MicrosoftWindowsDesktop_windows-ent-cpc_win11-22h2-ent-cpc-m365。 可以在 Azure 市场中找到 publisherName、offerName 和 skuName。 只读。 |
| offerName | String | 传递给 ARM 以检索映像资源的此库映像的套餐名称。 只读。 |
| osVersionNumber | String | 此库映像的作系统版本。 例如，10.0.22000.296。 只读。 |
| publisherName | String | 传递给 ARM 以检索映像资源的此库映像的发布者名称。 只读。 |
| sizeInGB | Int32 | 指示此映像的大小（以 GB 为单位）。 例如，64。 只读。 |
| skuName | String | 传递给 ARM 以检索映像资源的此映像的 SKU 名称。 只读。 |
| startDate | 日期 | 云电脑映像可用于预配新云电脑的日期。 例如，2022-09-20。 只读。 |
| status | cloudPcGalleryImageStatus | 云电脑上库映像的状态。 可能的值包括 supported、supportedWithWarning、notSupported、unknownFutureValue。 默认值为 supported。 只读。 |
| 产品/服务 (已弃用) | String | 传递给 ARM 以检索映像资源的此库映像的套餐名称。 只读。 套餐属性已弃用，将于 2024 年 1 月 31 日停止返回数据。 今后，请使用 offerName 属性。 |
| offerDisplayName (已弃用) | String | 此库图像的官方显示产品/服务名称。 例如，Windows 11 Enterprise。
offerDisplayName 属性已弃用，将于 2024 年 1 月 31 日停止返回数据。 |
| 发布 (已弃用) | String | 传递给 ARM 以检索映像资源的此库映像的发布者名称。 只读。 发布者属性已弃用，将于 2024 年 1 月 31 日停止返回数据。 今后，请使用 publisherName 属性。 |
| recommendedSku (已弃用) | String | 此库映像的建议云电脑 SKU。 只读。 recommendedSku 属性已弃用，将于 2024 年 1 月 31 日停止返回数据。 |
| sku (已弃用) | String | 传递给 ARM 以检索映像资源的此映像的 SKU 名称。 只读。 SKU 属性已弃用，将于 2024 年 1 月 31 日停止返回数据。 今后，请使用 skuName 属性。 |
| skuDisplayName (已弃用) | String | 此库图像的官方显示 SKU 名称。 例如，2004。 只读。
skuDisplayName 属性已弃用，将于 2024 年 1 月 31 日停止返回数据。 |
cloudPcGalleryImageStatus 值
| 成员 | 说明 |
|---|---|
| 支持 | 库映像处于活动状态，已准备好用于预配。 |
| supportedWithWarning | 库映像已过期，但云电脑将继续支持六个月，之后它将不受支持，无法使用。 |
| notSupported | 库映像不受支持。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@odata.type": "#microsoft.graph.cloudPcGalleryImage",
"displayName": "String",
"endDate": "String (Date)",
"expirationDate": "String (Date)",
"id": "String (identifier)",
"offer": "String",
"offerDisplayName": "String",
"offerName": "String",
"osVersionNumber": "String",
"publisher": "String",
"publisherName": "String",
"recommendedSku": "String",
"sizeInGB": "Int32",
"sku": "String",
"skuDisplayName": "String",
"skuName": "String",
"startDate": "String (Date)",
"status": "String"
}