REST Resource: customers.configurations

Ressource: Konfiguration

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

  • Der auf den Geräten installierte EMM Device Policy Controller (DPC).
  • Auf den Geräten erzwungene EMM-Richtlinien.
  • 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 jedoch am besten, wenn ein Kunde eine Standardkonfiguration festlegt, die auf alle neuen Geräte angewendet wird, die die Organisation erwirbt.

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 Kurzname, 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 EMM-Bereitstellungsextras im JSON-Format, die an den DPC übergeben werden.

companyName

string

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

contactEmail

string

Erforderlich. Die E-Mail-Adresse, an die 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, unter der Gerätenutzer mit einem anderen 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 ein bis zwei Sätzen, um Gerätenutzern zu helfen, Hilfe zu erhalten oder ihnen mehr Informationen darüber zu geben, 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 dies die Standardkonfiguration ist, die die Zero-Touch-Registrierung auf alle neuen Geräte angewendet, die die Organisation künftig kauft. Es kann nur eine Kundenkonfiguration als Standard festgelegt werden. Wenn Sie diesen Wert auf true setzen, wird der isDefault-Wert der vorherigen Standardkonfiguration in false geändert.

forcedResetTime

string (Duration format)

Optional. Zeitlimit vor dem Erzwingen des Zurücksetzens auf die Werkseinstellungen, wenn das Gerät nicht im Einrichtungsassistenten bereitgestellt wird. Dies ist in der Regel auf eine fehlende Netzwerkverbindung während des Einrichtungsassistenten zurückzuführen. Der Bereich liegt zwischen 0 und 6 Stunden, wobei 2 Stunden als Standardeinstellung verwendet werden, wenn kein Wert festgelegt wird.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". 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.