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 l'applicazione di filtri e ordinamenti ai risultati di: list operazioni.

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

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 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 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 di 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	AND logico. Uno spazio equivale a AND, pertanto i valori seguenti sono equivalenti: name: "cloud" AND name: "kms" name: "cloud" name: "kms"
OR	OR logico.

Gli operatori AND e OR sono accettati per lo stesso livello di raggruppamento. OR richiede precedenza su AND. Puoi utilizzare le parentesi per ignorare la precedenza predefinita.

Quando filtri i valori time, codifica l'ora come stringa nel RFC 3399, ad esempio 2019-06-20T01:30:15Z.

Quando accedi a un sottocampo, utilizza la sintassi dot. Ad esempio, la proprietà CryptoKey contiene il campo primary. Puoi filtrare CryptoKey risultati nella sottocampo 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 applicare un filtro in base 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. Quanto segue mostra 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 tentare di ordinare in base alla versione con la data di creazione più recente. Non è garantito che la versione principale sia la versione più recente o che la versione più recente sia la versione principale. Per farlo, esegui la query utilizzando il campo primary.