Cloud Key Management Service supporta il filtro e l'ordinamento dei risultati delle seguenti operazionilist.
Il supporto per l'ordinamento e l'applicazione di filtri in un'operazione list è indicato dal
presenza di campi stringa filter e orderBy nel corpo della richiesta dell'elenco. Entrambi
utilizzano un linguaggio semplice per fare riferimento ai campi nell'oggetto che
ordinate e/o filtrate.
Sintassi filtro
La sintassi del filtro consiste in un'espressione su uno o più campi degli oggetti essere filtrati.
Puoi utilizzare i seguenti operatori di espressione.
| Operatore | Descrizione |
|---|---|
= |
Uguaglianza. |
> |
Maggiore di. |
< |
Minore di. |
=> |
Maggiore o uguale a. |
<= |
Minore o uguale a. |
!=-NOT |
Disequazione. I seguenti valori 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 dot. Ad esempio, la proprietà CryptoKey
contenente 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 qualsiasi altro tipo di map:
labels.team=alpha
Una stringa tra virgolette viene interpretata come un singolo valore anziché come una sequenza di e i relativi 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. Quanto segue mostra
i valori di ordinamento supportati per il campo orderBy.
| Valore | Descrizione |
|---|---|
'' (stringa vuota) |
I risultati vengono ordinati in 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. |