cloudPcRemoteActionResult resource type

Article
06/26/2024

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a remote action result specified by a Cloud PC.

Methods

Method	Return type	Description
Retrieve remote action results	cloudPcRemoteActionResult collection	Retrieve remote action results and check the status of a specific remote action performed on the associated Cloud PC device.
Get remote action results (deprecated)	cloudPcRemoteActionResult	Check the Cloud PC-specified remote action results for a Cloud PC device. This API is deprecated and will stop returning data on February 28, 2025. Going forward, use the retrieveCloudPcRemoteActionResults API.

Properties

Property	Type	Description
actionName	String	The specified action. Supported values in the Microsoft Endpoint Manager portal are: `Reprovision`, `Resize`, `Restore`. Supported values in enterprise Cloud PC devices are: `Reboot`, `Rename`, `Reprovision`, `Troubleshoot`.
actionState	actionState	State of the action. Possible values are: `None`, `pending`, `canceled`, `active`, `done`, `failed`, `notSupported`. Read-only.
cloudPcId	String	The ID of the Cloud PC device on which the remote action is performed. Read-only.
managedDeviceId	String	The ID of the Intune managed device on which the remote action is performed. Read-only.
startDateTime	DateTimeOffset	Time the action was initiated. The Timestamp is shown in ISO 8601 format and Coordinated Universal Time (UTC). For example, midnight UTC on Jan 1, 2014 appears as '2014-01-01T00:00:00Z'.
lastUpdatedDateTime	DateTimeOffset	Last update time for action. The Timestamp is shown in ISO 8601 format and Coordinated Universal Time (UTC). For example, midnight UTC on Jan 1, 2014 appears as '2014-01-01T00:00:00Z'.
statusDetail	cloudPcStatusDetail	The extended details of the action status, including error code, error message, and additional information. For example, `"statusDetail": {"code": "internalServerError","message": "There was an internal server error. Please contact support xxx.","additionalInformation": [ { "@odata.type":"microsoft.graph.keyValuePair","name": "correlationId","value": "52367774-cfb7-4e9c-ab51-1b864c31f2d1"} ]}`
statusDetails (deprecated)	cloudPcStatusDetails	The details of the Cloud PC status. This property is deprecated and will no longer be supported effective August 31, 2024. Use statusDetail instead.

actionState values

Member	Description
none	Not a valid action state.
pending	The action is pending.
canceled	The action is canceled.
active	The action is active.
done	The action completed without errors.
failed	The action failed.
notSupported	The action isn't supported.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.cloudPcRemoteActionResult",
  "actionName": "String",
  "actionState": "String",
  "startDateTime": "String (timestamp)",
  "lastUpdatedDateTime": "String (timestamp)",
  "cloudPcId": "String",
  "managedDeviceId": "String",
  "statusDetails": {
    "@odata.type": "microsoft.graph.cloudPcStatusDetails"
  },
  "statusDetail": {
    "@odata.type": "microsoft.graph.cloudPcStatusDetail"
  }
}

Share via