Se devi 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 un 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 i prefissi. I filtri non sono sensibili alle maiuscole.
La tabella seguente 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 |
Puoi trovare la sintassi completa dei filtri nella guida ai filtri delle API.
Sintassi della corrispondenza esatta
I filtri con corrispondenza esatta trovano solo i clienti che contengono gli stessi campi di quelli della 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 dei prefissi consentono l'utilizzo di un asterisco come carattere jolly. Questo filtro individua i clienti che hanno campi con il prefisso, indipendentemente dai contenuti che seguono.
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 degli operatori logici AND e OR. Puoi utilizzare entrambi gli operatori in un filtro utilizzando una dichiarazione tra parentesi.
Esempio AND
domain = "domain.com" AND channel_partner_id = "12345" AND org_display_name :
"display*"
Esempio di OR
domain = "domain.com" OR channel_partner_id = "12345" OR org_display_name :
"display*"
Esempio di AND + OR
domain = "domain.com" OR (channel_partner_id = "12345" AND org_display_name :
"display*" )
Devi utilizzare le parentesi se il filtro contiene un'istruzione AND e un'istruzione OR. L'esempio seguente non è una stringa di filtro valida.
domain = "domain.com" OR channel_partner_id = "12345" AND org_display_name :
"display*