REST Resource: enterprises.enrollmentTokens

Recurso: EnrollmentToken

Un token de inscripción

Representación JSON 
{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}
Campos
name

string

El nombre del token de inscripción, que genera el servidor durante la creación, con el formato enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.
value

string

El valor del token que se pasa al dispositivo y autoriza su inscripción. Este es un campo de solo lectura que genera el servidor.
duration

string (Duration format)

El tiempo de validez del token de inscripción es de 1 minuto a Durations.MAX_VALUE, aproximadamente 10,000 años. Si no se especifica, la duración predeterminada es de 1 hora. Ten en cuenta que, si la duración solicitada hace que el expirationTimestamp resultante supere Timestamps.MAX_VALUE, expirationTimestamp se fuerza a Timestamps.MAX_VALUE.

Una duración en segundos con hasta nueve dígitos decimales que terminen en "s". Ejemplo: "3.5s".
expirationTimestamp

string (Timestamp format)

La hora de vencimiento del token. Este es un campo de solo lectura que genera el servidor.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
policyName

string

El nombre de la política que se aplicó inicialmente al dispositivo inscrito, con el formato enterprises/{enterpriseId}/policies/{policyId}. Si no se especifica, se aplica el policyName para el usuario del dispositivo. Si tampoco se especifica userName, se aplica enterprises/{enterpriseId}/policies/default de forma predeterminada. Cuando actualizas este campo, solo puedes especificar la policyId, siempre que la policyId no contenga barras diagonales. Se inferirá el resto del nombre de la política.
additionalData

string

Datos arbitrarios opcionales asociados con el token de inscripción. Esto podría contener, por ejemplo, el ID de una unidad organizativa a la que se asigna el dispositivo después de la inscripción. Después de que un dispositivo se inscribe con el token, estos datos se exponen en el campo enrollmentTokenData del recurso Device. Los datos deben tener 1,024 caracteres o menos; de lo contrario, la solicitud de creación fallará.
qrCode

string

Es una cadena JSON cuya representación en UTF-8 se puede usar para generar un código QR para inscribir un dispositivo con este token de inscripción. Para inscribir un dispositivo con NFC, el registro NFC debe contener una representación serializada de java.util.Properties de las propiedades en el JSON.
oneTimeOnly

boolean

Indica si el token de inscripción es para uso único. Si la marca se establece como verdadera, solo un dispositivo podrá usarla para el registro.
user
(deprecated)

object (User)

Este campo dejó de estar disponible y se ignorará el valor.
allowPersonalUsage

enum (AllowPersonalUsage)

Controla si se permite el uso personal en un dispositivo aprovisionado con este token de inscripción.

Para dispositivos de la empresa:

  • Si se habilita el uso personal, el usuario podrá configurar un perfil de trabajo en el dispositivo.
  • Para inhabilitar el uso personal, el usuario debe aprovisionar el dispositivo como un dispositivo completamente administrado.

Para dispositivos de propiedad personal:

  • Si se habilita el uso personal, el usuario podrá configurar un perfil de trabajo en el dispositivo.
  • Si inhabilitas el uso personal, no se aprovisionará el dispositivo. No se puede inhabilitar el uso personal en dispositivos de propiedad personal.

Métodos

create

 Crea un token de inscripción para una empresa determinada.

delete

 Borra un token de inscripción.

get

 Obtiene un token de inscripción activo y sin vencer.

list

 Muestra una lista de los tokens de inscripción activos y no vencidos de una empresa determinada.