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 nell'oggetto che
vengono ordinati e/o filtrati.
Sintassi filtro
La sintassi del filtro è costituita da un'espressione su uno o più campi degli oggetti che vengono 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 equivale 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 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 campo secondario, utilizza la sintassi con il punto. Ad esempio, la risorsa CryptoKey
contiene il campo primary. Puoi filtrare i risultati di CryptoKey nel
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 di map:
labels.team=alpha
Una stringa tra virgolette viene interpretata come un singolo valore anziché una sequenza di valori.
Campi filtrabili
Puoi filtrare in base a qualsiasi campo negli 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 sono ordinati nell'ordine predefinito. |
'name' |
I risultati sono ordinati in ordine crescente in base al campo name della risorsa. |
'name desc' |
I risultati sono ordinati in ordine decrescente in base al campo name della risorsa. |