Cloud Key Management Service는 다음 list 작업에서 결과 필터링 및 정렬을 지원합니다.
list 작업에서 정렬 및 필터링 지원 여부는 list 요청 본문에서 filter 및 orderBy 문자열 필드의 유무를 통해 표시됩니다. 두 필드 모두 저장 및 필터링되는 객체의 필드를 참조하는 데 단순한 언어를 사용합니다.
필터 구문
필터 문법은 필터링되는 객체의 하나 이상의 필드에 대한 표현식으로 구성됩니다.
다음 표현식 연산자를 사용할 수 있습니다.
| 연산자 | 설명 |
|---|---|
= |
같음 |
> |
보다 큼 |
< |
보다 작음 |
=> |
크거나 같음 |
<= |
작거나 같음 |
!=-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) |
AND 및 OR 연산자는 같은 그룹화 수준에서 수락됩니다. OR가 AND보다 우선 적용됩니다. 괄호를 사용하여 기본 우선 순위를 재정의할 수 있습니다.
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 필드 |
정렬 순서 문법
객체에서 리소스의 name 필드를 기준으로 결과를 정렬할 수 있습니다. 다음은 orderBy 필드에 지원되는 정렬 순서 값을 보여줍니다.
| 값 | 설명 |
|---|---|
'''(빈 문자열) |
결과가 기본 순서로 정렬됩니다. |
'name' |
결과는 리소스의 name 필드를 기준으로 오름차순으로 정렬됩니다. |
'name desc' |
결과는 리소스의 name 필드를 기준으로 내림차순으로 정렬됩니다. |