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" .

expiration Timestamp

string ( Timestamp format)

Срок действия токена. Это поле, предназначенное только для чтения, созданное сервером.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

policy Name

string

Имя политики, первоначально примененной к зарегистрированному устройству, в форме enterprises/{enterpriseId}/policies/{policyId} . Если не указано, применяется policyName для пользователя устройства. Если userName также не указано, по умолчанию применяется enterprises/{enterpriseId}/policies/default . При обновлении этого поля вы можете указать только policyId , если policyId не содержит косых черт. Остальная часть имени политики будет выведена.

additional Data

string

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

qr Code

string

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

one Time Only

boolean

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

user
(deprecated)

object ( User )

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

allow Personal Usage

enum ( AllowPersonalUsage )

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

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

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

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

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

Методы

create

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

delete

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

get

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

list

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