Тип ресурса cloudPcDeviceImage

Статья
01/23/2024

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Представляет ресурс образа на облачном компьютере.

Методы

Метод	Тип возвращаемых данных	Описание
Список	коллекция cloudPcDeviceImage	Список свойств и связей объектов cloudPcDeviceImage .
Получение	cloudPcDeviceImage	Чтение свойств и связей объекта cloudPcDeviceImage .
Создание	cloudPcDeviceImage	Создайте объект cloudPcDeviceImage .
удаление;	Нет	Удалите объект cloudPcDeviceImage .
Получение исходных образов	коллекция cloudPcSourceDeviceImage	Получение объектов cloudPcSourceDeviceImage .
Повторная отправка	Нет	Перезагрузите объект cloudPcDeviceImage , который не удалось передать.

Свойства

Свойство	Тип	Описание
displayName	String	Отображаемое имя связанного образа устройства. Отображаемое имя образа устройства и версия используются для уникальной идентификации образа устройства облачного компьютера. Только для чтения.
errorCode	cloudPcDeviceImageErrorCode	Код ошибки состояния изображения, который указывает, почему произошел сбой отправки, если применимо. Возможные значения: `internalServerError`, `sourceImageNotFound`, `osVersionNotSupported`, `sourceImageInvalid`, `sourceImageNotGeneralized`, `unknownFutureValue`, `vmAlreadyAzureAdJoined`, `paidSourceImageNotSupport`, `sourceImageNotSupportCustomizeVMName`, `sourceImageSizeExceedsLimitation`. Обратите внимание, что необходимо использовать `Prefer: include-unknown-enum-members` заголовок запроса, чтобы получить следующие значения из этого развиваемого перечисления: `vmAlreadyAzureAdJoined`, `paidSourceImageNotSupport`, `sourceImageNotSupportCustomizeVMName`, . `sourceImageSizeExceedsLimitation` Только для чтения.
expirationDate	Date	Дата, когда изображение стало недоступным. Только для чтения.
id	String	Уникальный идентификатор ресурса образа на облачном компьютере. Только для чтения.
lastModifiedDateTime	DateTimeOffset	Данные и время последнего изменения изображения. Метка времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: `2014-01-01T00:00:00Z`. Только для чтения.
operatingSystem	String	Операционная система образа. Например, `Windows 10 Enterprise`. Только для чтения.
osBuildNumber	String	Версия сборки ОС образа. Например, `1909`. Только для чтения.
osStatus	cloudPcDeviceImageOsStatus	Состояние ОС этого образа. Возможные значения: `supported`, `supportedWithWarning`, `unknown`, `unknownFutureValue`. Значение по умолчанию — `unknown`. Только для чтения.
osVersionNumber	String	Версия операционной системы этого образа. Например, `10.0.22000.296`. Только для чтения.
sourceImageResourceId	String	Уникальный идентификатор ресурса исходного образа в Azure. Требуемый формат идентификатора: "/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`, `sourceImageNotSupportCustomizeVMName`, . `sourceImageSizeExceedsLimitation` Только для чтения. Свойство statusDetails устарело и перестанет возвращать данные 31 января 2024 г. В дальнейшем используйте свойство errorCode .

значения cloudPcDeviceImageErrorCode

Member	Описание
internalServerError	Во время обработки образа произошла внутренняя ошибка сервера.
sourceImageNotFound	Исходный образ недоступен или не найден.
osVersionNotSupported	Версия ОС не поддерживается.
sourceImageInvalid	Исходный образ недопустим для подготовки виртуальной машины Windows.
sourceImageNotGeneralized	Отправленное изображение не было обобщено. Повторно загрузите образ после выполнения команды sysprep/generalize. Дополнительные сведения см. в статье Удаление сведений о компьютере путем отзыва или обобщения виртуальной машины перед созданием образа.
unknownFutureValue	Изменяемое значение перечисления sentinel. Не используйте.
vmAlreadyAzureAdJoined	Виртуальная машина, которая создает исходный образ для создания образа устройства, уже присоединена к Microsoft Entra. Это не позволяет процессу проверки разрешить создание образа устройства с использованием такого исходного образа.
paidSourceImageNotSupport	Этот исходный образ создан на основе другого платного образа из Azure Marketplace и не поддерживается; используйте другой источник для продолжения.
sourceImageNotSupportCustomizeVMName	В результирующем обобщенном образе возникает проблема с настройкой имени компьютера, которая препятствует настройке имени виртуальной машины с помощью предоставленного образа.
sourceImageSizeExceedsLimitation	Размер загруженного клиентом исходного образа превышает ограничения общей коллекции образов (SIG), что приводит к сбою при создании образа.

значения cloudPcDeviceImageOsStatus

Member	Описание
поддерживается	Указывает, что операционная система образа устройства облачного компьютера активна и готова к использованию для подготовки.
supportedWithWarning	Указывает, что срок действия операционной системы образа устройства "Облачный компьютер" истек, но поддержка облачного компьютера продолжается. Если пользователи продолжают использовать, они могут не получить обновления для системы безопасности.
unknown	Значение, используемое по умолчанию. Указывает, что состояние образа операционной системы для устройства облачного компьютера неизвестно.
unknownFutureValue	Изменяемое значение перечисления sentinel. Не используйте.

Значения cloudPcDeviceImageStatus

Member	Описание
ожидаемый	Идет отправка образа.
готовый	Образ готов для использования на облачных компьютерах.
неудавшийся	Указывает, что не удалось отправить изображение.
unknownFutureValue	Изменяемое значение перечисления sentinel. Не используйте.

значения cloudPcDeviceImageStatusDetails

Member	Описание
internalServerError	Во время обработки образа произошла внутренняя ошибка сервера.
sourceImageNotFound	Исходный образ недоступен или не найден.
osVersionNotSupported	Версия ОС не поддерживается.
sourceImageInvalid	Исходный образ недопустим для подготовки виртуальной машины Windows.
sourceImageNotGeneralized	Отправленное изображение не является обобщенным. Повторно загрузите образ после выполнения команды sysprep/generalize. Дополнительные сведения см. в статье Удаление сведений о компьютере путем отзыва или обобщения виртуальной машины перед созданием образа.
unknownFutureValue	Изменяемое значение перечисления sentinel. Не используйте.
vmAlreadyAzureAdJoined	Виртуальная машина, которая создает исходный образ для создания образа устройства, уже присоединена к Microsoft Entra. Это не позволяет процессу проверки разрешить создание образа устройства с использованием такого исходного образа.
paidSourceImageNotSupport	Этот исходный образ создан на основе другого платного образа из Azure Marketplace и не поддерживается; используйте другой источник для продолжения.
sourceImageNotSupportCustomizeVMName	В результирующем обобщенном образе возникает проблема с настройкой имени компьютера, которая препятствует настройке имени виртуальной машины с помощью предоставленного образа.
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",
  "osVersionNumber": "String",
  "sourceImageResourceId": "String",
  "status": "String",
  "statusDetails": "String",
  "version": "String"
}

Поделиться через