更新 userExperienceAnalyticsAppHealthOSVersionPerformanceUpdate userExperienceAnalyticsAppHealthOSVersionPerformance
命名空间:microsoft.graphNamespace: microsoft.graph
重要说明: /Beta 版本下的 Microsoft Graph Api 可能会发生更改;不支持生产使用。Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
注意: 适用于 Intune 的 Microsoft Graph API 需要适用于租户的 活动 Intune 许可证。Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.
更新 userExperienceAnalyticsAppHealthOSVersionPerformance 对象的属性。Update the properties of a userExperienceAnalyticsAppHealthOSVersionPerformance object.
先决条件Prerequisites
要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
权限类型Permission type | 权限(从最高特权到最低特权)Permissions (from most to least privileged) |
---|---|
委派(工作或学校帐户)Delegated (work or school account) | DeviceManagementManagedDevices.ReadWrite.AllDeviceManagementManagedDevices.ReadWrite.All |
委派(个人 Microsoft 帐户)Delegated (personal Microsoft account) | 不支持。Not supported. |
应用程序Application | DeviceManagementManagedDevices.ReadWrite.AllDeviceManagementManagedDevices.ReadWrite.All |
HTTP 请求HTTP Request
PATCH /deviceManagement/userExperienceAnalyticsAppHealthOSVersionPerformance/{userExperienceAnalyticsAppHealthOSVersionPerformanceId}
请求标头Request headers
标头Header | 值Value |
---|---|
AuthorizationAuthorization | Bearer <token>。必需。Bearer <token> Required. |
接受Accept | application/jsonapplication/json |
请求正文Request body
在请求正文中,提供 userExperienceAnalyticsAppHealthOSVersionPerformance 对象的 JSON 表示形式。In the request body, supply a JSON representation for the userExperienceAnalyticsAppHealthOSVersionPerformance object.
下表显示创建 userExperienceAnalyticsAppHealthOSVersionPerformance时所需的属性。The following table shows the properties that are required when you create the userExperienceAnalyticsAppHealthOSVersionPerformance.
属性Property | 类型Type | 说明Description |
---|---|---|
idid | StringString | User experience analytics OS 版本性能对象的唯一标识符。The unique identifier of the user experience analytics OS version performance object. |
osVersionosVersion | StringString | 设备上安装的 OS 版本。The OS version installed on the device. |
osBuildNumberosBuildNumber | StringString | 安装在设备上的操作系统内部版本号。The OS build number installed on the device. |
activeDeviceCountactiveDeviceCount | Int32Int32 | OS 版本的活动设备数。The number of active devices for the OS version. 有效值-2147483648 到2147483647Valid values -2147483648 to 2147483647 |
meanTimeToFailureInMinutesmeanTimeToFailureInMinutes | Int32Int32 | OS 版本失败的平均时间,以分钟为单位。The mean time to failure for the OS version in minutes. 有效值-2147483648 到2147483647Valid values -2147483648 to 2147483647 |
osVersionAppHealthScoreosVersionAppHealthScore | 双精度Double | 操作系统版本的应用运行状况分数。The app health score of the OS version. 有效值-1.79769313486232 E + 308 到 1.79769313486232 E + 308Valid values -1.79769313486232E+308 to 1.79769313486232E+308 |
osVersionAppHealthStatusosVersionAppHealthStatus | StringString | OS 版本的总体应用程序运行状况状态。The overall app health status of the OS version. |
响应Response
如果成功,此方法 200 OK
在响应正文中返回响应代码和更新的 userExperienceAnalyticsAppHealthOSVersionPerformance 对象。If successful, this method returns a 200 OK
response code and an updated userExperienceAnalyticsAppHealthOSVersionPerformance object in the response body.
示例Example
请求Request
下面是一个请求示例。Here is an example of the request.
PATCH https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsAppHealthOSVersionPerformance/{userExperienceAnalyticsAppHealthOSVersionPerformanceId}
Content-type: application/json
Content-length: 357
{
"@odata.type": "#microsoft.graph.userExperienceAnalyticsAppHealthOSVersionPerformance",
"osVersion": "Os Version value",
"osBuildNumber": "Os Build Number value",
"activeDeviceCount": 1,
"meanTimeToFailureInMinutes": 10,
"osVersionAppHealthScore": 7.666666666666667,
"osVersionAppHealthStatus": "Os Version App Health Status value"
}
响应Response
下面是一个响应示例。注意:为了简单起见,可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 406
{
"@odata.type": "#microsoft.graph.userExperienceAnalyticsAppHealthOSVersionPerformance",
"id": "7c28e16b-e16b-7c28-6be1-287c6be1287c",
"osVersion": "Os Version value",
"osBuildNumber": "Os Build Number value",
"activeDeviceCount": 1,
"meanTimeToFailureInMinutes": 10,
"osVersionAppHealthScore": 7.666666666666667,
"osVersionAppHealthStatus": "Os Version App Health Status value"
}