REST Resource: customers.configurations

Ressource: Konfiguration

Bei einer Konfiguration werden die Bereitstellungsoptionen für Android-Geräte erfasst. Sie besteht aus den folgenden Komponenten:

  • Dem EMM-DPC (Device Policy Controller), der auf den Geräten installiert ist
  • EMM-Richtlinien auf den Geräten erzwungen.
  • Metadaten, die auf dem Gerät angezeigt werden, um Nutzern bei der Einrichtung zu helfen

Kunden können beliebig viele Konfigurationen hinzufügen. Die Zero-Touch-Registrierung funktioniert am besten, wenn Kunden eine Standardkonfiguration festlegen, die auf alle neuen Geräte angewendet wird, die die Organisation kauft.

JSON-Darstellung 
{
  "name": string,
  "configurationId": string,
  "configurationName": string,
  "dpcResourcePath": string,
  "dpcExtras": string,
  "companyName": string,
  "contactEmail": string,
  "contactPhone": string,
  "customMessage": string,
  "isDefault": boolean,
  "forcedResetTime": string
}
Felder
name

string

Nur Ausgabe. Der API-Ressourcenname im Format customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. Vom Server zugewiesen.
configurationId

string (int64 format)

Nur Ausgabe. Die ID der Konfiguration. Vom Server zugewiesen.
configurationName

string

Erforderlich. Ein kurzer Name, der den Zweck der Konfiguration beschreibt. Beispiele: Vertriebsteam, Temporäre Mitarbeiter Im Portal für die Zero-Touch-Registrierung wird IT-Administratoren dieser Name angezeigt.
dpcResourcePath

string

Erforderlich. Der Ressourcenname des ausgewählten DPC (Device Policy Controller) im Format customers/[CUSTOMER_ID]/dpcs/*. Rufen Sie customers.dpcs.list auf, um die unterstützten DPCs aufzulisten.
dpcExtras

string

Die zusätzlichen Bereitstellungen für die EMM-Bereitstellung im JSON-Format, die an den DPC übergeben werden.
companyName

string

Erforderlich. Der Name der Organisation Bei der Zero-Touch-Registrierung wird Gerätenamen während der Gerätebereitstellung dieser Organisationsname angezeigt.
contactEmail

string

Erforderlich. Die E-Mail-Adresse, an die sich Gerätenutzer wenden können, um Hilfe zu erhalten. Bei der kontaktlosen Registrierung wird Gerätenutzern diese E-Mail-Adresse vor der Gerätebereitstellung angezeigt. Der Wert wird bei der Eingabe validiert.
contactPhone

string

Erforderlich. Die Telefonnummer, die Gerätenutzer über ein anderes Gerät anrufen können, um Hilfe zu erhalten Bei der Zero-Touch-Registrierung wird Gerätenutzern diese Nummer vor der Gerätebereitstellung angezeigt. Akzeptiert Ziffern, Leerzeichen, Pluszeichen, Bindestriche und Klammern.
customMessage

string

Eine Nachricht mit einem oder zwei Sätzen, die den Nutzern helfen soll, Hilfe zu erhalten, oder ihnen weitere Informationen dazu zur Verfügung stellt, was mit ihrem Gerät geschieht. Bei der Zero-Touch-Registrierung wird diese Nachricht angezeigt, bevor das Gerät bereitgestellt wird.
isDefault

boolean

Erforderlich. Gibt an, ob die Zero-Touch-Registrierung auf alle neuen Geräte angewendet wird, die die Organisation zukünftig kauft. Standardmäßig kann nur eine Kundenkonfiguration festgelegt werden. Wenn Sie diesen Wert auf true festlegen, wird der isDefault-Wert der vorherigen Standardkonfiguration in false geändert.
forcedResetTime

string (Duration format)

Optional. Das Zeitlimit, bevor das Gerät auf die Werkseinstellungen zurückgesetzt wird, wenn es nicht im Einrichtungsassistenten eingerichtet wird, in der Regel durch fehlende Netzwerkverbindung während des Einrichtungsassistenten. Der Wert liegt zwischen 0 und 6 Stunden, wobei die Standardeinstellung 2 Stunden ist.

Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ enden. Beispiel: "3.5s".

Methoden

create

 Erstellt eine neue Konfiguration.

delete

 Löscht eine nicht verwendete Konfiguration.

get

 Ruft die Details einer Konfiguration ab.

list

 Listet die Konfigurationen eines Kunden auf.

patch

 Aktualisiert die Feldwerte einer Konfiguration.