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。

時間長度以秒為單位，最多可有 9 個小數位數，並應以「s」結尾，例如："3.5s"。
expirationTimestamp

string (Timestamp format)

權杖的到期時間。這是由伺服器產生的唯讀欄位。

使用 RFC 3339，產生的輸出內容一律會經過 Z 規格化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
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 表示法可用於產生 QR code，以便使用這個註冊權杖註冊裝置。如要使用 NFC 註冊裝置，NFC 記錄必須包含 JSON 中屬性的序列化 java.util.Properties 表示法。
oneTimeOnly

boolean

註冊權杖是否僅限使用一次。如果標記設為 True，則只有一部裝置可以使用該標記進行註冊。
user
(deprecated)

object (User)

這個欄位已淘汰，系統會忽略該值。
allowPersonalUsage

enum (AllowPersonalUsage)

控制是否允許使用這組註冊權杖佈建的裝置進行個人用途。

公司擁有的裝置：

  • 啟用個人用途後，使用者就能在裝置上設定工作資料夾。
  • 如要停用個人用途，使用者必須將裝置佈建為全代管裝置。

個人裝置：

  • 啟用個人用途後，使用者就能在裝置上設定工作資料夾。
  • 停用個人用途後，裝置就無法進行佈建。個人裝置無法停用個人用途。

方法

create

 為特定企業建立註冊權杖。

delete

 刪除註冊權杖。

get

 取得有效且未過期的註冊權杖。

list

 列出特定企業的有效註冊權杖。