REST Resource: enterprises.enrollmentTokens

资源：enrollToken

注册令牌。

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，大约 10,000 年。如果未指定，则默认时长为 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

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