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

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