Cloud Key Management Service supporta il filtraggio e l'ordinamento dei risultati delle seguenti operazioni list.
Il supporto per l'ordinamento e il filtraggio in un'operazione list è indicato dalla presenza dei campi stringa filter e orderBy nel corpo della richiesta di elenco. Entrambi i campi utilizzano un linguaggio semplice per fare riferimento ai campi dell'oggetto che viene ordinato e/o filtrato.
Sintassi filtro
La sintassi del filtro è costituita da un'espressione su uno o più campi degli oggetti filtrati.
Puoi utilizzare i seguenti operatori di espressione.
| Operatore | Descrizione |
|---|---|
= |
Uguaglianza. |
> |
Maggiore di. |
< |
Minore di. |
=> |
Maggiore o uguale a. |
<= |
Minore o uguale a. |
!=-NOT |
Disuguaglianza. Le seguenti espressioni 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 |
AND logico. Uno spazio è equivalente a AND, quindi le seguenti espressioni 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 sostituire 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 con il punto. Ad esempio, la CryptoKey
risorsa contiene il campo primary. Puoi filtrare i risultati di CryptoKey in base al sottocampo primary.algorithm per un algoritmo specifico:
primary.algorithm=RSA_SIGN_PSS_2048_SHA256
Utilizza la sintassi con il punto per un'etichetta e qualsiasi altro tipo 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 list | 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 negli oggetti. Di seguito sono riportati i valori dell'ordinamento supportati per il campo orderBy.
| Valore | Descrizione |
|---|---|
'' (stringa vuota) |
I risultati vengono ordinati nell'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. |