REST Resource: enterprises.enrollmentTokens

资源：EnrollmentToken

注册令牌。

JSON 表示法 
{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}
字段
name

string

注册令牌的名称，由服务器在创建期间生成，格式为 enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}。
value

string

传递给设备并授权设备注册的令牌值。这是服务器生成的只读字段。
duration

string (Duration format)

注册令牌的有效期是从 1 分钟到 Durations.MAX_VALUE，大约 1 万年。如果未指定，则默认时长为 1 小时。请注意，如果请求的时长导致生成的 expirationTimestamp 超过 Timestamps.MAX_VALUE，则 expirationTimestamp 会被强制转换为 Timestamps.MAX_VALUE。

此时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。
expirationTimestamp

string (Timestamp format)

令牌的到期时间。这是服务器生成的只读字段。

采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式的时间戳，采用纳秒级精度，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
policyName

string

最初应用于已注册设备的政策的名称，格式为 enterprises/{enterpriseId}/policies/{policyId}。如果未指定，则应用设备用户的 policyName。如果未指定 userName，则默认应用 enterprises/{enterpriseId}/policies/default。更新此字段时，您可以仅指定 policyId，前提是 policyId 不包含任何斜杠。将推断政策名称的其余部分。
additionalData

string

与注册令牌关联的任意数据（可选）。例如，其中可以包含设备在注册后分配到的组织部门的 ID。设备使用令牌注册后，这些数据将显示在 Device 资源的 enrollmentTokenData 字段中。数据长度不得超过 1024 个字符，否则创建请求将会失败。
qrCode

string

一个 JSON 字符串，其 UTF-8 表示法可用于生成二维码，以便使用此注册令牌注册设备。如需使用 NFC 注册设备，NFC 记录必须包含 JSON 中属性的序列化 java.util.Properties 表示法。
oneTimeOnly

boolean

注册令牌是否仅供一次性使用。如果标志设置为 true，则只有一台设备可以使用它进行注册。
user
(deprecated)

object (User)

此字段已弃用，系统会忽略其值。
allowPersonalUsage

enum (AllowPersonalUsage)

控制是否允许在配置了此注册令牌的设备上使用个人用途。

对于公司自有设备：

  • 启用个人用途后，用户便可在设备上设置工作资料。
  • 如需停用个人使用功能，用户需要将设备配置为完全受管设备。

对于个人拥有的设备：

  • 启用个人用途后，用户便可在设备上设置工作资料。
  • 停用个人用途后，设备将无法进行配置。个人使用的设备无法用于个人用途。

方法

create

 为指定企业创建注册令牌。

delete

 删除注册令牌。

get

 获取有效且未过期的注册令牌。

list

 列出指定企业的有效未过期注册令牌。