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.
  • I 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.
companyName

string

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

string

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

string

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

string

Un messaggio, contenente una o due frasi, per aiutare gli utenti dei dispositivi a ricevere assistenza o per fornire loro maggiori dettagli su ciò che accade sul loro dispositivo. La registrazione zero-touch mostra questo messaggio prima del provisioning del dispositivo.
isDefault

boolean

Obbligatorio. Questa è la configurazione predefinita applicata dalla registrazione zero-touch a tutti i nuovi dispositivi acquistati dall'organizzazione in futuro. L'impostazione predefinita è una sola configurazione del cliente. Se imposti questo valore su true, il valore isDefault della configurazione predefinita precedente viene modificato in false.
forcedResetTime

string (Duration format)

Campo facoltativo. Il timeout prima di forzare il ripristino dei dati di fabbrica se il dispositivo non viene sottoposto al provisioning nella configurazione guidata, di solito a causa della mancanza di connettività di rete durante la configurazione guidata. Varia da 0 a 6 ore, con 2 ore come valore predefinito se non viene impostata.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

Metodi

create

 Crea una nuova configurazione.

delete

 Elimina una configurazione non utilizzata.

get

 Visualizza i dettagli di una configurazione.

list

 Elenca le configurazioni di un cliente.

patch

 Aggiorna i valori del campo di una configurazione.