Cloud Key Management Service supporta il filtro e l'ordinamento dei risultati delle seguenti operazionilist.
Il supporto dell'ordinamento e del filtro in un'operazione list è indicato dalla presenza di campi di stringa filter e orderBy nel corpo della richiesta dell'elenco. Entrambi i campi utilizzano un linguaggio semplice per fare riferimento ai campi dell'oggetto sottoposto a ordinamento e/o filtrazione.
Sintassi filtro
La sintassi del filtro è costituita da un'espressione su uno o più campi degli oggetti sottoposti a filtri.
Puoi utilizzare i seguenti operatori di espressione.
| Operatore | Descrizione |
|---|---|
= |
Uguaglianza. |
> |
Maggiore di. |
< |
Minore di. |
=> |
Maggiore o uguale a. |
<= |
Minore o uguale a. |
!=-NOT |
Diseguaglianza. I seguenti sono equivalenti: name != "quickstart"-name="quickstart"NOT name = "quickstart" |
: |
Contenimento. Si tratta di una corrispondenza di sottostringa senza distinzione tra maiuscole e minuscole. Ad esempio, name: "cloud" filtra le risorse che contengono cloud (senza distinzione tra maiuscole e minuscole) nel nome della risorsa. |
AND |
Operatore AND logico. Uno spazio è equivalente a AND, quindi i seguenti sono equivalenti:name: "cloud" AND name: "kms"name: "cloud" name: "kms" |
OR |
OR logico. |
Gli operatori AND e OR sono accettati allo stesso livello di raggruppamento. OR ha la precedenza su AND. Puoi utilizzare le parentesi per ignorare la precedenza predefinita.
Quando filtri in base ai valori time, codifica l'ora come stringa nel formato
RFC 3399, ad esempio
2019-06-20T01:30:15Z.
Quando accedi a un sottocampo, utilizza la sintassi dei punti. Ad esempio, la risorsa CryptoKey contiene il campo primary. Puoi filtrare i risultati CryptoKey nel
campo secondario primary.algorithm per un algoritmo specifico:
primary.algorithm=RSA_SIGN_PSS_2048_SHA256
Utilizza la sintassi dei punti per un'etichetta e per qualsiasi altro tipo di map:
labels.team=alpha
Una stringa tra virgolette viene interpretata come un singolo valore anziché come una sequenza di valori.
Campi filtrabili
Puoi filtrare in base a qualsiasi campo degli oggetti restituiti.
| Metodo di elenco | Link ai campi filtrabili |
|---|---|
| keyRings.list | Campi KeyRing |
| cryptoKeys.list | Campi CryptoKey |
| cryptoKeyVersions.list | Campi CryptoKeyVersion |
| importJobs.list | Campi ImportJob |
Sintassi dell'ordinamento
Puoi ordinare i risultati in base al campo name della risorsa sugli oggetti. Di seguito sono riportati
i valori dell'ordinamento supportati per il campo orderBy.
| Valore | Descrizione |
|---|---|
'' (stringa vuota) |
I risultati vengono ordinati in base all'ordine predefinito. |
'name' |
I risultati vengono ordinati in ordine crescente in base al campo name della risorsa. |
'name desc' |
I risultati vengono ordinati in ordine decrescente in base al campo name della risorsa. |