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

Необязательные произвольные данные, связанные с токеном регистрации. Он может содержать, например, идентификатор организационного подразделения, которому устройство назначено после регистрации. После регистрации устройства с помощью токена эти данные будут отображаться в поле enrollmentTokenData ресурса Device . Данные должны содержать не более 1024 символов; в противном случае запрос на создание завершится неудачно.

qrCode

string

Строка JSON, представление которой в формате UTF-8 можно использовать для создания QR-кода для регистрации устройства с помощью этого токена регистрации. Чтобы зарегистрировать устройство с помощью NFC, запись NFC должна содержать сериализованное представление свойств java.util.Properties в формате JSON.

oneTimeOnly

boolean

Является ли токен регистрации одноразовым. Если для флага установлено значение true, только одно устройство может использовать его для регистрации.

user
(deprecated)

object ( User )

Это поле устарело, и его значение игнорируется.

allowPersonalUsage

enum ( AllowPersonalUsage )

Определяет, разрешено ли личное использование на устройстве, снабженном этим токеном регистрации.

Для корпоративных устройств:

  • Включение личного использования позволяет пользователю настроить рабочий профиль на устройстве.
  • Отключение личного использования требует, чтобы пользователь представил устройство как полностью управляемое устройство.

Для личных устройств:

  • Включение личного использования позволяет пользователю настроить рабочий профиль на устройстве.
  • Отключение личного использования не позволит устройству инициализироваться. Личное использование нельзя отключить на личном устройстве.

Методы

create

 Создает токен регистрации для данного предприятия.

delete

 Удаляет токен регистрации.

get

 Получает активный токен регистрации с неистёкшим сроком действия.

list

 Перечисляет активные токены регистрации с неистёкшим сроком действия для данного предприятия.