REST Resource: enterprises.enrollmentTokens

Risorsa: EnrollmentToken

Un token di registrazione.

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

string

Il nome del token di registrazione, generato dal server durante la creazione, nel formato enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.
value

string

Il valore del token che viene passato al dispositivo e che autorizza la registrazione del dispositivo. Questo è un campo di sola lettura generato dal server.
duration

string (Duration format)

La durata del token di registrazione, che può variare da 1 minuto a Durations.MAX_VALUE, ovvero circa 10.000 anni. Se non specificata, la durata predefinita è 1 ora. Tieni presente che se la durata richiesta fa sì che expirationTimestamp risulti superiore a Timestamps.MAX_VALUE, expirationTimestamp viene forzato a Timestamps.MAX_VALUE.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".
expirationTimestamp

string (Timestamp format)

La data e l'ora di scadenza del token. Questo è un campo di sola lettura generato dal server.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
policyName

string

Il nome del criterio applicato inizialmente al dispositivo registrato, nel formato enterprises/{enterpriseId}/policies/{policyId}. Se non specificato, viene applicato il policyName per l'utente del dispositivo. Se anche userName non è specificato, per impostazione predefinita viene applicato enterprises/{enterpriseId}/policies/default. Quando aggiorni questo campo, puoi specificare solo il valore policyId, a condizione che policyId non contenga barre. Il resto del nome del criterio verrà dedotto.
additionalData

string

Dati arbitrari e facoltativi associati al token di registrazione. Potrebbe contenere, ad esempio, l'ID di un'unità organizzativa a cui viene assegnato il dispositivo dopo la registrazione. Dopo la registrazione di un dispositivo con il token, questi dati vengono esposti nel campo enrollmentTokenData della risorsa Device. I dati devono avere una lunghezza massima di 1024 caratteri. In caso contrario, la richiesta di creazione non andrà a buon fine.
qrCode

string

Una stringa JSON la cui rappresentazione UTF-8 può essere utilizzata per generare un codice QR per registrare un dispositivo con questo token di registrazione. Per registrare un dispositivo tramite NFC, il record NFC deve contenere una rappresentazione java.util.Properties serializzata delle proprietà nel JSON.
oneTimeOnly

boolean

Indica se il token di registrazione è utilizzabile una sola volta. Se il flag è impostato su true, solo un dispositivo può utilizzarlo per la registrazione.
user
(deprecated)

object (User)

Questo campo è obsoleto e il valore viene ignorato.
allowPersonalUsage

enum (AllowPersonalUsage)

Controlla se l'utilizzo personale è consentito su un dispositivo per cui è stato eseguito il provisioning con questo token di registrazione.

Per i dispositivi di proprietà dell'azienda:

  • L'attivazione dell'utilizzo personale consente all'utente di configurare un profilo di lavoro sul dispositivo.
  • La disattivazione dell'utilizzo personale richiede che l'utente esegua il provisioning del dispositivo come dispositivo completamente gestito.

Per i dispositivi di proprietà personale:

  • L'attivazione dell'utilizzo personale consente all'utente di configurare un profilo di lavoro sul dispositivo.
  • La disattivazione dell'utilizzo personale impedirà il provisioning del dispositivo. L'utilizzo personale non può essere disattivato su un dispositivo di proprietà personale.

Metodi

create

 Crea un token di registrazione per una determinata azienda.

delete

 Elimina un token di registrazione.

get

 Recupera un token di registrazione attivo e non scaduto.

list

 Elenca i token di registrazione attivi e non scaduti per una determinata azienda.