특정 고객에 대한 정보를 찾으려면 customers.list 메서드를 통해 Cloud Channel API filter 매개변수를 사용하면 됩니다.
필터를 사용하면 고객을 만드는 동안 짧은 지연(일반적으로 몇 초)이 발생합니다. 고객을 만든 후에 바로 고객에게 액세스해야 하는 경우 필터 또는 customers.get 없이 customers.list을(를) 사용하는 것이 좋습니다.
사용 가능 필터
필터 매개변수의 문자열은 일치검색 또는 일치검색 더하기 프리픽스 필터링을 지원합니다. 필터는 대소문자를 구분하지 않습니다.
다음 표에서는 검색할 수 있는 사용 가능한 필드와 지원되는 메서드를 설명합니다.
| 외부 검색 키 | 일치검색 지원 | 프리픽스 지원 |
|---|---|---|
| domain | 예 | 예 |
| 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*