REST Resource: customers.configurations

Risorsa: configurazione

Una configurazione raccoglie le opzioni di provisioning per i dispositivi Android. Ogni configurazione combina i seguenti elementi:

  • Il controller dei criteri dei dispositivi (DPC) EMM installato sui dispositivi.
  • Criteri EMM applicati ai dispositivi.
  • Metadati visualizzati sul dispositivo per aiutare gli utenti durante la configurazione.

I clienti possono aggiungere tutte le configurazioni di cui hanno bisogno. Tuttavia, la registrazione zero-touch funziona al meglio quando un cliente imposta una configurazione predefinita da applicare a tutti i nuovi dispositivi acquistati dall'organizzazione.

Rappresentazione JSON
{
  "name": string,
  "configurationId": string,
  "configurationName": string,
  "dpcResourcePath": string,
  "dpcExtras": string,
  "companyName": string,
  "contactEmail": string,
  "contactPhone": string,
  "customMessage": string,
  "isDefault": boolean,
  "forcedResetTime": string
}
Campi
name

string

Solo output. Il nome della risorsa API nel formato customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. Assegnato dal server.

configurationId

string (int64 format)

Solo output. L'ID della configurazione. Assegnato dal server.

configurationName

string

Obbligatorio. Un nome breve che descrive lo scopo della configurazione. Ad esempio, team di vendita o dipendenti temporanei. Il portale della registrazione zero-touch mostra questo nome agli amministratori IT.

dpcResourcePath

string

Obbligatorio. Il nome della risorsa del DPC (controller dei criteri dei dispositivi) selezionato nel formato customers/[CUSTOMER_ID]/dpcs/*. Per elencare i DPC supportati, chiama customers.dpcs.list.

dpcExtras

string

Gli extra di provisioning EMM in formato JSON che vengono trasmessi al DPC (controller criteri dispositivi).

companyName

string

Obbligatorio. Il nome dell'organizzazione. La registrazione zero-touch mostra questo nome dell'organizzazione agli utenti del dispositivo durante il provisioning dispositivo.

contactEmail

string

Obbligatorio. L'indirizzo email che gli utenti del dispositivo possono contattare per richiedere assistenza. La registrazione senza intervento mostra questo indirizzo agli utenti del dispositivo prima del provisioning. Il valore viene convalidato all'input.

contactPhone

string

Obbligatorio. Il numero di telefono che gli utenti del dispositivo possono chiamare, utilizzando un altro dispositivo, per richiedere assistenza. La registrazione zero-touch mostra questo numero agli utenti dei dispositivi prima del provisioning dispositivo. Accetta numeri, spazi, segno più, trattini e parentesi.

customMessage

string

Un messaggio contenente una o due frasi per aiutare gli utenti del dispositivo a ricevere aiuto o fornire loro maggiori dettagli su ciò che sta succedendo al dispositivo. La registrazione zero-touch mostra questo messaggio prima del provisioning del dispositivo.

isDefault

boolean

Obbligatorio. Indica se si tratta della configurazione predefinita che la registrazione zero-touch verrà applicata a tutti i nuovi dispositivi acquistati dall'organizzazione in futuro. Può essere impostata come predefinita una sola configurazione cliente. Se questo valore è impostato su true, il valore isDefault della configurazione predefinita precedente viene modificato in false.

forcedResetTime

string (Duration format)

(Facoltativo) Timeout prima del ripristino dei dati di fabbrica del dispositivo nel caso in cui il dispositivo non venga sottoposto al provisioning nella configurazione guidata, generalmente a causa della mancanza di connettività di rete durante la configurazione guidata. Varia da 0 a 6 ore; se il criterio non viene configurato, 2 ore sono il valore predefinito.

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

Metodi

create

Crea una nuova configurazione.

delete

Elimina una configurazione inutilizzata.

get

Recupera i dettagli di una configurazione.

list

Elenca le configurazioni di un cliente.

patch

Aggiorna i valori dei campi di una configurazione.