REST Resource: enterprises.enrollmentTokens

Ressource: EnrollmentToken

Ein Registrierungstoken.

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

string

Der Name des Registrierungstokens, das vom Server während der Erstellung generiert wird, im Format enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.
value

string

Der Tokenwert, der an das Gerät übergeben wird und es zur Registrierung autorisiert. Dieses Feld ist schreibgeschützt und wird vom Server generiert.
duration

string (Duration format)

Die Gültigkeitsdauer des Registrierungstokens, von 1 Minute bis Durations.MAX_VALUE, etwa 10.000 Jahre. Wenn keine Angabe erfolgt, beträgt die Standarddauer 1 Stunde. Hinweis: Wenn die angeforderte Dauer dazu führt, dass expirationTimestamp Timestamps.MAX_VALUE überschreitet, wird expirationTimestamp auf Timestamps.MAX_VALUE festgelegt.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".
expirationTimestamp

string (Timestamp format)

Die Ablaufzeit des Tokens. Dies ist ein schreibgeschütztes Feld, das vom Server generiert wird.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
policyName

string

Der Name der Richtlinie, die ursprünglich auf das registrierte Gerät angewendet wurde, im Format enterprises/{enterpriseId}/policies/{policyId}. Wenn nicht angegeben, wird die policyName für den Gerätenutzer angewendet. Wenn auch userName nicht angegeben ist, wird standardmäßig enterprises/{enterpriseId}/policies/default angewendet. Beim Aktualisieren dieses Felds können Sie nur die policyId angeben, sofern sie keine Schrägstriche enthält.policyId Der Rest des Richtliniennamens wird abgeleitet.
additionalData

string

Optionale, beliebige Daten, die dem Registrierungstoken zugeordnet sind. Dies kann beispielsweise die ID einer Organisationseinheit sein, der das Gerät nach der Registrierung zugewiesen wird. Nachdem ein Gerät mit dem Token registriert wurde, werden diese Daten im Feld enrollmentTokenData der Ressource Device freigegeben. Die Daten dürfen maximal 1.024 Zeichen lang sein. Andernfalls schlägt der Erstellungsantrag fehl.
qrCode

string

Ein JSON-String, dessen UTF-8-Darstellung verwendet werden kann, um einen QR-Code zu generieren, um ein Gerät mit diesem Registrierungstoken zu registrieren. Wenn Sie ein Gerät per NFC registrieren möchten, muss der NFC-Eintrag eine serialisierte java.util.Properties-Darstellung der Eigenschaften in der JSON enthalten.
oneTimeOnly

boolean

Ob das Registrierungstoken nur einmal verwendet werden kann. Wenn das Flag auf „true“ gesetzt ist, kann es nur von einem Gerät für die Registrierung verwendet werden.
user
(deprecated)

object (User)

Dieses Feld ist veraltet und der Wert wird ignoriert.
allowPersonalUsage

enum (AllowPersonalUsage)

Bestimmt, ob die private Nutzung auf einem Gerät zulässig ist, das mit diesem Registrierungstoken bereitgestellt wurde.

Für unternehmenseigene Geräte:

  • Wenn Sie die private Nutzung aktivieren, kann der Nutzer ein Arbeitsprofil auf dem Gerät einrichten.
  • Zur Deaktivierung der persönlichen Nutzung muss der Nutzer das Gerät als vollständig verwaltetes Gerät bereitstellen.

Für eigene Geräte:

  • Wenn Sie die private Nutzung aktivieren, kann der Nutzer ein Arbeitsprofil auf dem Gerät einrichten.
  • Wenn Sie die private Nutzung deaktivieren, kann das Gerät nicht bereitgestellt werden. Die private Nutzung kann auf privaten Geräten nicht deaktiviert werden.

Methoden

create

 Erstellt ein Registrierungstoken für ein bestimmtes Unternehmen.

delete

 Löscht ein Registrierungstoken.

get

 Ruft ein aktives, nicht abgelaufenes Registrierungstoken ab.

list

 Listet aktive, noch nicht abgelaufene Registrierungstokens für ein bestimmtes Unternehmen auf.