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,约为 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 可能包含设备在注册后分配到的组织部门的 ID。设备使用令牌注册后,此数据将在 Device 资源的 enrollmentTokenData 字段中公开。数据长度不得超过 1024 个字符,否则创建请求将会失败。

qrCode

string

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

oneTimeOnly

boolean

注册令牌是否为一次性令牌。如果将该标志设置为 true,则只有一个设备可以使用它进行注册。

user

object (User)

与此注册令牌关联的用户。如果在创建注册令牌时指定该参数,而用户不存在,则系统会创建该用户。此字段不得包含个人身份信息。只需设置 accountIdentifier 字段。

allowPersonalUsage

enum (AllowPersonalUsage)

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

对于公司自有设备:

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

对于个人所有的设备:

  • 启用个人用途后,用户即可在设备上设置工作资料。
  • 停用个人用途后,设备将无法进行配置。您无法在个人所有设备上停用个人使用功能。

方法

create

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

delete

删除注册令牌。

get

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

list

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