Si necesitas encontrar información sobre un cliente específico, puedes usar el parámetro filter de la API de Cloud Channel a través del método customers.list.
Si usas un filtro, hay una demora breve (por lo general, de unos segundos) durante la creación de un cliente. Si necesitas acceder a un cliente inmediatamente después de su creación, te recomendamos usar customers.list sin un filtro o customers.get.
Filtros disponibles
Las strings del parámetro de filtro admiten la concordancia exacta o la concordancia exacta más el filtrado de prefijos. Los filtros no distinguen mayúsculas de minúsculas.
En la siguiente tabla, se describen los campos disponibles que puedes buscar y los métodos que admiten.
| Clave de búsqueda externa | Compatibilidad con concordancia exacta | Prefijos admitidos |
|---|---|---|
| dominio | Sí | Sí |
| org_display_name | Sí | Sí |
| cloud_identity_id | Sí | No. |
| channel_partner_id | Sí | No. |
Puedes encontrar la sintaxis del filtro completa en la guía de filtrado de la API.
Sintaxis de concordancia exacta
Los filtros de concordancia exacta solo encontrarán clientes que contengan los mismos campos que los de la cadena enviada.
Sintaxis:
<domain | org_display_name | cloud_identity_id | channel_partner_id> = <value>
Ejemplo: domain = "domain.com" AND channel_partner_id = "12345"
Sintaxis del prefijo
Los filtros de prefijo permiten el uso de un asterisco como símbolo de comodín. Este filtro encontrará clientes que tengan campos con el prefijo, sin importar el contenido que aparezcan después de ellos.
Sintaxis: <domain | org_display_name> : <value>*
Ejemplo: domain : "uw.com*" AND org_display_name : "prefix*"
Ejemplos de filtros con operadores lógicos
Los filtros de la API de Cloud Channel admiten el uso de operadores lógicos Y y O. Puedes usar ambos operadores en un filtro mediante una sentencia entre paréntesis.
Ejemplo Y
domain = "domain.com" AND channel_partner_id = "12345" AND org_display_name :
"display*"
Ejemplo OR
domain = "domain.com" OR channel_partner_id = "12345" OR org_display_name :
"display*"
Ejemplo de AND + OR
domain = "domain.com" OR (channel_partner_id = "12345" AND org_display_name :
"display*" )
Debes usar paréntesis si el filtro contiene una instrucción AND y una OR. El siguiente ejemplo no es una cadena de filtro válida.
domain = "domain.com" OR channel_partner_id = "12345" AND org_display_name :
"display*