如果您需要查找特定客户的相关信息，可以通过 customers.list 方法使用 Cloud Channel API filter 参数。
如果您使用过滤条件，则在创建客户时会出现短暂延迟（通常几秒钟）。如果您需要在创建后立即访问客户，我们建议您使用不带过滤条件的 customers.list 或 customers.get。
可用过滤条件
过滤条件参数的字符串支持完全匹配，或完全匹配加前缀过滤。过滤条件不区分大小写。
下表介绍了您可以搜索的可用字段以及它们支持的方法。
| 外部搜索键 | 完全匹配支持 | 支持的前缀 |
|---|---|---|
| 网域 | 是 | 是 |
| org_display_name | 是 | 是 |
| cloud_identity_id | 是 | 否 |
| channel_partner_id | 是 | 否 |
您可以在 API 过滤指南中找到完整的过滤器语法。
完全匹配语法
完全匹配过滤条件只会查找与所提交字符串中字段相同的客户。
语法：<domain | org_display_name | cloud_identity_id | channel_partner_id> = <value>
示例：domain = "domain.com" AND channel_partner_id = "12345"
前缀语法
前缀过滤器允许使用星号作为通配符符号。此过滤条件会查找具有该前缀的字段的客户，无论后续内容如何。
语法：<domain | org_display_name> : <value>*
示例：domain : "uw.com*" AND org_display_name : "prefix*"
包含逻辑运算符的过滤条件示例
Cloud Channel API 过滤条件支持使用 AND 和 OR 逻辑运算符。您可以使用括号语句在一个过滤条件中同时使用这两种运算符。
“AND”运算示例
domain = "domain.com" AND channel_partner_id = "12345" AND org_display_name :
"display*"
“OR”运算符示例
domain = "domain.com" OR channel_partner_id = "12345" OR org_display_name :
"display*"
“AND”+“OR”示例
domain = "domain.com" OR (channel_partner_id = "12345" AND org_display_name :
"display*" )
如果过滤条件包含 AND 和 OR 语句，则需要使用括号。以下示例不是一个有效的过滤器字符串。
domain = "domain.com" OR channel_partner_id = "12345" AND org_display_name :
"display*