Ordinamento e filtro dei risultati dell'elenco

Beta

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Cloud Key Management Service supporta il filtro e l'ordinamento dei risultati delle seguenti operazioni list.

• keyRings.list
• cryptoKeys.list
• cryptoKeyVersions.list
• importJobs.list

Il supporto per l'ordinamento e i filtri in un'operazione list è indicato dalla presenza di campi stringa filter e orderBy nel corpo della richiesta dell'elenco. Entrambi i campi utilizzano un linguaggio semplice per fare riferimento ai campi dell'oggetto che viene ordinato e/o filtrato.

Sintassi dei filtri

La sintassi del filtro è composta da un'espressione su uno o più campi degli oggetti filtrati.

Puoi utilizzare i seguenti operatori di espressione.

Operatore	Descrizione
=	Uguaglianza.
>	Maggiore di.
<	Meno di.
=>	Maggiore o uguale a.
<=	Minore o uguale a.
!= - NOT	Disuguaglianza. I seguenti sono equivalenti: name != "quickstart" -name="quickstart" NOT name = "quickstart"
:	Contenimento. Questa è 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 quanto segue è equivalente: 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 i 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 punto. 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 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 applicare un filtro a qualsiasi campo degli oggetti restituiti.

Metodo elenco	Link ai campi filtrabili
keyRings.list	Campi KeyRing
cryptoKeys.list	Campi CryptoKey
cryptoKeyVersions.list	Campi CryptoKeyVersion
importJobs.list	Campi ImportJob

Sintassi di ordinamento

Puoi ordinare i risultati in base al campo name della risorsa sugli oggetti. Di seguito sono riportati i valori di 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.

Nota: per trovare la versione della chiave primaria, non cercare di ordinare la versione con la data di creazione più recente. Non c'è alcuna garanzia che la versione principale sia quella più recente o che la versione più recente sia quella principale. Esegui invece una query utilizzando il campo primary.