Method: customer.devices.chromeos.batchChangeStatus

更改一批 ChromeOS 设备的状态。如需详细了解如何更改 ChromeOS 设备的状态，请维修 ChromeOS 设备、将 ChromeOS 设备改作他用或弃用。

HTTP 请求

POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos:batchChangeStatus

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

必需。Google Workspace 帐号的不可变 ID。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "deviceIds": [
    string
  ],
  "changeChromeOsDeviceStatusAction": enum (ChangeChromeOsDeviceStatusAction),
  "deprovisionReason": enum (DeprovisionReason)
}
字段
deviceIds[]

string

必需。要更改的 ChromeOS 设备的 ID 列表。最多 50 个。
changeChromeOsDeviceStatusAction

enum (ChangeChromeOsDeviceStatusAction)

必需。在 ChromeOS 设备上为更改其状态而执行的操作。
deprovisionReason

enum (DeprovisionReason)

可选。取消配置设备的原因。如果“changeChromeOsDeviceStatusAction”设置为“CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION”，则必须提供。否则，请忽略此字段。

响应正文

对一批 ChromeOS 设备的状态进行更改的响应。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "changeChromeOsDeviceStatusResults": [
    {
      object (ChangeChromeOsDeviceStatusResult)
    }
  ]
}
字段
changeChromeOsDeviceStatusResults[]

object (ChangeChromeOsDeviceStatusResult)

请求中提供的每款 ChromeOS 设备的结果。

授权范围

需要以下 OAuth 作用域：

  • https://www.googleapis.com/auth/admin.directory.device.chromeos

有关详情，请参阅授权指南。

ChangeChromeOsDeviceStatusAction

为更改 ChromeOS 设备状态而要执行的操作。

枚举
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED 默认值。值未使用。
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION 取消配置 ChromeOS 设备。如果您的组织中有不再使用的 ChromeOS 设备，那么您应取消配置这些设备，这样就不用再对其进行管理。取消配置设备后，系统会移除该设备上的所有政策、设备级打印机以及将设备用作自助服务终端的功能。根据与设备关联的升级许可，此操作可能会将许可释放回许可池；这样一来，您就可以在其他设备上使用该许可。
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE 停用 ChromeOS 设备。如果用户的设备丢失或被盗，请使用此操作，使设备仍然处于受管理状态，这样设备就仍然会接收政策，但任何人都无法使用。根据与设备关联的升级许可，此操作可能会将许可释放回许可池；这样一来，您就可以在其他设备上使用该许可。
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE 重新启用已停用后可供使用的 ChromeOS 设备。当设备不再丢失或恢复后，重新启用设备。这样即可再次使用该设备。根据与设备关联的升级许可，系统可能会消耗许可池中的一个许可，这意味着如果没有足够的可用许可，操作将会失败。

ChangeChromeOsDeviceStatusResult

单个 ChromeOS 设备执行“更改状态”操作的结果。

JSON 表示法 
{
  "deviceId": string,

  // Union field result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    object (ChangeChromeOsDeviceStatusSucceeded)
  }
  // End of list of possible types for union field result.
}
字段
deviceId

string

ChromeOS 设备的唯一 ID。

联合字段 result。

result 只能是下列其中一项：
error

object (Status)

操作失败时返回的错误结果。
response

object (ChangeChromeOsDeviceStatusSucceeded)

设备可以成功更改其状态。

状态

Status 类型定义了适用于不同编程环境（包括 REST API 和 RPC API）的逻辑错误模型。此类型供 gRPC 使用。每条 Status 消息包含三部分数据：错误代码、错误消息和错误详细信息。

如需详细了解该错误模型及其使用方法，请参阅 API 设计指南。

JSON 表示法 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
字段
code

integer

状态代码，应为 google.rpc.Code 的枚举值。
message

string

面向开发者的错误消息（应采用英语）。任何向用户显示的错误消息都应进行本地化并通过 google.rpc.Status.details 字段发送，或者由客户端进行本地化。
details[]

object

包含错误详细信息的消息列表。有一组通用的消息类型可供 API 使用。

可以包含任意类型字段的对象。附加字段 "@type" 包含用于标示相应类型的 URI。示例：{ "id": 1234, "@type": "types.example.com/standard/id" }。

ChangeChromeOsDeviceStatusSucceeded

此类型没有任何字段。

ChromeOS 设备状态更改成功的响应。