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。

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

string (Timestamp format)

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

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："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 欄位中。資料長度不得超過 1, 024 個字元，否則建立要求會失敗。
qrCode

string

以 UTF-8 表示的 JSON 字串，可產生 QR code，透過這個註冊權杖註冊裝置。如要使用 NFC 註冊裝置，NFC 記錄必須包含 JSON 中屬性的序列化 java.util.Properties 表示法。
oneTimeOnly

boolean

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

object (User)

這個欄位已不適用，因此系統會忽略這個值。
allowPersonalUsage

enum (AllowPersonalUsage)

控管是否允許在透過這個註冊權杖佈建的裝置上使用個人用途。

公司擁有的裝置：

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

如果是個人裝置：

  • 啟用個人使用功能後，使用者即可在裝置上設定工作資料夾。
  • 停用個人使用設定會導致裝置無法佈建。無法在個人擁有的裝置上停用個人使用功能。

方法

create

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

delete

 刪除註冊權杖。

get

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

list

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