목록 결과 정렬 및 필터링

Cloud Key Management Service는 다음 list 작업에서 결과 필터링 및 정렬을 지원합니다.

list 작업에서 정렬 및 필터링 지원 여부는 list 요청 본문에서 filterorderBy 문자열 필드의 유무를 통해 표시됩니다. 두 필드 모두 저장 및 필터링되는 객체의 필드를 참조하는 데 단순한 언어를 사용합니다.

필터 구문

필터 구문은 필터링되는 객체의 하나 이상의 필드에 대한 표현식으로 구성됩니다.

다음 표현식 연산자를 사용할 수 있습니다.

연산자 설명
= 같음
> 보다 큼
< 보다 작음
=> 크거나 같음
<= 작거나 같음
!=
-
NOT
불일치.
다음은 동일합니다.
name != "quickstart"
-name="quickstart"
NOT name = "quickstart"
: 방지. 대소 문자를 구분하지 않는 하위 문자열 일치입니다.
예를 들어 name: "cloud"는 리소스 이름에 cloud(대소문자를 구분하지 않음)가 포함된 리소스를 필터링합니다.
AND 논리곱(AND). 공백은 AND와 동일하므로
name: "cloud" AND name: "kms"
name: "cloud" name: "kms"은 동일합니다.
OR 논리합(OR)

ANDOR 연산자는 같은 그룹화 수준에서 수락됩니다. ORAND보다 우선 적용됩니다. 괄호를 사용하여 기본 우선 순위를 재정의할 수 있습니다.

time 값을 필터링할 때 시간을 RFC 3399 형식시간으로 문자열로 인코딩합니다(예: 2019-06-20T01:30:15Z).

하위 필드에 액세스하는 경우 점 구문을 사용합니다. 예를 들어 CryptoKey 리소스에는 primary 필드가 포함됩니다. 특정 알고리즘의 하위 필드 primary.algorithm에서 CryptoKey 결과를 필터링할 수 있습니다.

primary.algorithm=RSA_SIGN_PSS_2048_SHA256

label과 다른 모든 map 유형에 점 구문을 사용합니다.

labels.team=alpha

따옴표 안의 문자열은 값 시퀀스가 아닌 단일 값으로 해석됩니다.

필터링 가능한 필드

반환되는 객체의 모든 필드를 필터링할 수 있습니다.

list 메서드 필터링 가능한 필드 링크
keyRings.list KeyRing 필드
cryptoKeys.list CryptoKey 필드
cryptoKeyVersions.list CryptoKeyVersion 필드
importJobs.list ImportJob 필드

정렬 순서 구문

객체의 리소스 이름별로 결과를 정렬할 수 있습니다. 다음은 orderBy 필드에 지원되는 정렬 순서 값을 보여줍니다.

설명
'''(빈 문자열) 결과가 기본 순서로 정렬됩니다.
'name' 결과가 리소스 이름별로 오름차순으로 정렬됩니다.
'name desc' 결과가 리소스 이름별로 내림차순으로 정렬됩니다.