Se hai bisogno di trovare informazioni su un cliente specifico, puoi utilizzare il parametro filter dell'API Cloud Channel tramite il metodo customers.list.
Se utilizzi un filtro, si verifica un breve ritardo (in genere di alcuni secondi) durante la creazione di un cliente. Se hai bisogno di accedere a un cliente subito dopo la creazione, ti consigliamo di utilizzare customers.list senza filtro o customers.get.
Filtri disponibili
Le stringhe per il parametro di filtro supportano la corrispondenza esatta o la corrispondenza esatta più il filtro per prefisso. I filtri non fanno distinzione tra maiuscole e minuscole.
La seguente tabella descrive i campi disponibili che puoi cercare e i metodi supportati.
| Chiave di ricerca esterna | Supporto della corrispondenza esatta | Prefisso supportato |
|---|---|---|
| dominio | Sì | Sì |
| org_display_name | Sì | Sì |
| cloud_identity_id | Sì | No |
| channel_partner_id | Sì | No |
Per la sintassi completa dei filtri, consulta la guida ai filtri delle API.
Sintassi della corrispondenza esatta
I filtri a corrispondenza esatta troveranno solo i clienti che contengono gli stessi campi di quelli nella stringa inviata.
Sintassi:
<domain | org_display_name | cloud_identity_id | channel_partner_id> = <value>
Esempio: domain = "domain.com" AND channel_partner_id = "12345"
Sintassi dei prefissi
I filtri di prefisso consentono di utilizzare un asterisco come carattere jolly. Questo filtro trova i clienti che hanno campi con il prefisso, indipendentemente dal contenuto che lo segue.
Sintassi: <domain | org_display_name> : <value>*
Esempio: domain : "uw.com*" AND org_display_name : "prefix*"
Esempi di filtri con operatori logici
I filtri dell'API Cloud Channel supportano l'utilizzo di operatori logici AND e OR. Puoi utilizzare entrambi gli operatori in un unico filtro utilizzando un'istruzione tra parentesi.
Esempio AND
domain = "domain.com" AND channel_partner_id = "12345" AND org_display_name :
"display*"
Esempio OR
domain = "domain.com" OR channel_partner_id = "12345" OR org_display_name :
"display*"
Esempio AND + OR
domain = "domain.com" OR (channel_partner_id = "12345" AND org_display_name :
"display*" )
Se il filtro contiene un'istruzione AND e OR, devi utilizzare le parentesi. L'esempio seguente non è una stringa di filtro valida.
domain = "domain.com" OR channel_partner_id = "12345" AND org_display_name :
"display*