更新内容Approval

命名空间:microsoft.graph.windowsUpdates

重要

Microsoft Graph 中版本下的 /beta API 可能会更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 在 v1.0 中是否可用,请使用 版本 选择器。

更新 contentApproval 对象的属性。

权限

调用此 API 需要以下权限之一。 若要了解详细信息,包括如何选择权限的信息,请参阅权限

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) WindowsUpdates.ReadWrite.All
委派(个人 Microsoft 帐户) 不支持。
应用程序 WindowsUpdates.ReadWrite.All

HTTP 请求

PATCH /admin/windows/updates/updatePolicies/{updatePolicyId}/complianceChanges/{complianceChangeId}

请求标头

名称 说明
Authorization 持有者 {token}。 必填。
Content-Type application/json. 必需。

请求正文

在请求正文中,提供应更新的属性的值。 请求正文中不包括的现有属性将保留其以前的值,或根据对其他属性值的更改重新计算。

下表指定可更新的属性。

属性 类型 说明
deploymentSettings microsoft.graph.windowsUpdates.deploymentSettings 用于管理如何部署 内容的设置。
isRevoked Boolean True 指示已撤销合规性更改,从而阻止进一步应用。 撤销合规性更改是最后一项操作。 继承自 microsoft.graph.windowsUpdates.complianceChange

响应

如果成功,此方法在 200 OK 响应正文中返回响应代码和更新的 microsoft.graph.windowsUpdates.contentApproval 对象。

示例

请求

请求示例如下所示。

PATCH https://graph.microsoft.com/beta/admin/windows/updates/updatePolicies/983f03cd-03cd-983f-cd03-3f98cd033f98/complianceChanges/bba2a340-1e32-b5ed-186e-678e16033319
Content-Type: application/json
Content-length: 91

{
  "@odata.type": "#microsoft.graph.windowsUpdates.contentApproval",
  "isRevoked": true
}

响应

下面展示了示例响应。

注意:为了提高可读性,可能缩短了此处显示的响应对象。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.windowsUpdates.contentApproval",
  "id": "bba2a340-1e32-b5ed-186e-678e16033319",
  "createdDateTime": "2020-06-09T10:00:00Z",
  "isRevoked": true,
  "revokedDateTime": "2020-06-09T11:00:00Z",
  "updatePolicy": { "@odata.id": "updatePolicies/983f03cd-03cd-983f-cd03-3f98cd033f98" },
  "content": {
            "@odata.type": "#microsoft.graph.windowsUpdates.featureUpdateCatalogEntry",
            "id": "f341705b-0b15-4ce3-aaf2-6a1681d78606"
  },
  "deploymentSettings": {
    "contentApplicability": {
      "offerWhileRecommendedBy": ["Microsoft"]
    },
    "schedule": {
      "startDateTime": "2020-06-09T10:00:00Z",
      "gradualRollout": {
        "@odata.type": "#microsoft.graph.windowsUpdates.dateDrivenRolloutSettings",
        "endDateTime": "2020-06-16T10:00:00Z"
      }
    }
  },
  "deployments": [
      { "id": "e481b11b-3b18-4282-906e-9d7efd27711d" }
  ]
}