AWS CLI Uscita del filtro - AWS Command Line Interface
Filtraggio lato serverFiltraggio lato clientCombinazione del filtraggio lato server e lato clientRisorse aggiuntive

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWS CLI Uscita del filtro

AWS Command Line Interface (AWS CLI) dispone di filtri sia sul lato server che sul lato client che è possibile utilizzare singolarmente o insieme per filtrare l'output. AWS CLI Il filtraggio lato server viene elaborato per primo e restituisce l'output per il filtraggio lato client.

  • Il filtraggio lato server è supportato dall'API e di solito lo si implementa con un parametro. --filter Il servizio restituisce solo risultati corrispondenti che possono accelerare i tempi di risposta HTTP per set di dati di grandi dimensioni.

  • Il filtraggio lato client è supportato dal AWS CLI client che utilizza il parametro. --query Questo parametro ha funzionalità che il filtraggio lato server potrebbe non avere.

Filtraggio lato server

Il filtraggio lato server in AWS CLI è fornito dall'API del servizio. AWS Il AWS servizio restituisce solo i record nella risposta HTTP che corrispondono al filtro, il che può accelerare i tempi di risposta HTTP per set di dati di grandi dimensioni. Poiché il filtraggio lato server è definito dall'API del servizio, i nomi e le funzioni dei parametri variano tra i servizi. Alcuni nomi di parametri comuni utilizzati per il filtraggio sono:

  • --filtercome e .

  • --filters

  • Nomi che iniziano con la parola, ad esempio per il comando. filter --filter-expression

Per informazioni sull'eventuale presenza di filtri sul lato server e sulle regole di filtraggio di uno specifico comando, consultate la guida di riferimento AWS CLI versione 2 della .

Filtraggio lato client

AWS CLI Fornisce funzionalità di filtraggio lato client basate su JSON integrate con il parametro. --query Il --query parametro è uno strumento potente che puoi utilizzare per personalizzare il contenuto e lo stile del tuo output. Il --query parametro prende la risposta HTTP che arriva dal server e filtra i risultati prima di visualizzarli. Poiché l'intera risposta HTTP viene inviata al client prima del filtraggio, il filtraggio lato client può essere più lento del filtraggio lato server per set di dati di grandi dimensioni.

L'interrogazione utilizza la sintassi JMESPath per creare espressioni per filtrare l'output. Per imparare la sintassi JMESPath, consulta il tutorial sul sito Web di JMESPath.

Importante

Il tipo di output specificato modifica il funzionamento dell'opzione: --query

  • Se si specifica--output text, l'output viene impaginato prima dell'applicazione del --query filtro e quindi AWS CLI esegue la query una volta su ogni pagina dell'output. Per questo motivo, la query include il primo elemento corrispondente in ogni pagina, il che può generare un output aggiuntivo inaspettato. Per filtrare ulteriormente l'output, puoi utilizzare altri strumenti da riga di comando come head otail.

  • Se si specifica --output json --output yaml, o --output yaml-stream l'output viene completamente elaborato come un'unica struttura nativa prima dell'applicazione del --query filtro. AWS CLI Esegue la query solo una volta sull'intera struttura, producendo un risultato filtrato che viene quindi emesso.

Prima di iniziare

Quando utilizzate le espressioni di filtro utilizzate in questi esempi, assicuratevi di utilizzare le regole di quotazione corrette per la shell del terminale. Per ulteriori informazioni, consulta Virgolette con stringhe in AWS CLI.

Il seguente output JSON mostra un esempio di ciò che il --query parametro può produrre. L'output descrive tre volumi Amazon EBS collegati a istanze Amazon EC2 separate.

$ aws ec2 describe-volumes
{
  "Volumes": [
    {
      "AvailabilityZone": "us-west-2a",
      "Attachments": [
        {
          "AttachTime": "2013-09-17T00:55:03.000Z",
          "InstanceId": "i-a071c394",
          "VolumeId": "vol-e11a5288",
          "State": "attached",
          "DeleteOnTermination": true,
          "Device": "/dev/sda1"
        }
      ],
      "VolumeType": "standard",
      "VolumeId": "vol-e11a5288",
      "State": "in-use",
      "SnapshotId": "snap-f23ec1c8",
      "CreateTime": "2013-09-17T00:55:03.000Z",
      "Size": 30
    },
    {
      "AvailabilityZone": "us-west-2a",
      "Attachments": [
        {
          "AttachTime": "2013-09-18T20:26:16.000Z",
          "InstanceId": "i-4b41a37c",
          "VolumeId": "vol-2e410a47",
          "State": "attached",
          "DeleteOnTermination": true,
          "Device": "/dev/sda1"
        }
      ],
      "VolumeType": "standard",
      "VolumeId": "vol-2e410a47",
      "State": "in-use",
      "SnapshotId": "snap-708e8348",
      "CreateTime": "2013-09-18T20:26:15.000Z",
      "Size": 8
    },
    {
      "AvailabilityZone": "us-west-2a",
      "Attachments": [
        {
          "AttachTime": "2020-11-20T19:54:06.000Z",
          "InstanceId": "i-1jd73kv8",
          "VolumeId": "vol-a1b3c7nd",
          "State": "attached",
          "DeleteOnTermination": true,
          "Device": "/dev/sda1"
        }
      ],
      "VolumeType": "standard",
      "VolumeId": "vol-a1b3c7nd",
      "State": "in-use",
      "SnapshotId": "snap-234087fb",
      "CreateTime": "2020-11-20T19:54:05.000Z",
      "Size": 15
    }
  ]
}

Identificatori

Gli identificatori sono le etichette per i valori di output. Quando si creano filtri, si utilizzano gli identificatori per restringere i risultati delle query. Nel seguente esempio di output, tutti gli identificatori come VolumesAvailabilityZone, e AttachTime sono evidenziati. 

$ aws ec2 describe-volumes
{
  "Volumes": [
    {
      "AvailabilityZone": "us-west-2a",
      "Attachments": [
        {
          "AttachTime": "2013-09-17T00:55:03.000Z",
          "InstanceId": "i-a071c394",
          "VolumeId": "vol-e11a5288",
          "State": "attached",
          "DeleteOnTermination": true,
          "Device": "/dev/sda1"
        }
      ],
      "VolumeType": "standard",
      "VolumeId": "vol-e11a5288",
      "State": "in-use",
      "SnapshotId": "snap-f23ec1c8",
      "CreateTime": "2013-09-17T00:55:03.000Z",
      "Size": 30
    },
    {
      "AvailabilityZone": "us-west-2a",
      "Attachments": [
        {
          "AttachTime": "2013-09-18T20:26:16.000Z",
          "InstanceId": "i-4b41a37c",
          "VolumeId": "vol-2e410a47",
          "State": "attached",
          "DeleteOnTermination": true,
          "Device": "/dev/sda1"
        }
      ],
      "VolumeType": "standard",
      "VolumeId": "vol-2e410a47",
      "State": "in-use",
      "SnapshotId": "snap-708e8348",
      "CreateTime": "2013-09-18T20:26:15.000Z",
      "Size": 8
    },
    {
      "AvailabilityZone": "us-west-2a",
      "Attachments": [
        {
          "AttachTime": "2020-11-20T19:54:06.000Z",
          "InstanceId": "i-1jd73kv8",
          "VolumeId": "vol-a1b3c7nd",
          "State": "attached",
          "DeleteOnTermination": true,
          "Device": "/dev/sda1"
        }
      ],
      "VolumeType": "standard",
      "VolumeId": "vol-a1b3c7nd",
      "State": "in-use",
      "SnapshotId": "snap-234087fb",
      "CreateTime": "2020-11-20T19:54:05.000Z",
      "Size": 15
    }
  ]
}

Per ulteriori informazioni, vedere Identificatori sul sito Web JMESPath.

Selezione da un elenco

Un elenco o una matrice è un identificatore seguito da una parentesi quadra "[" come Volumes e Attachments in. Prima di iniziare

Sintassi

<listName>[ ]

Per filtrare tutto l'output di un array, è possibile utilizzare la notazione con caratteri jolly. Le espressioni con caratteri jolly sono espressioni utilizzate per restituire elementi utilizzando la notazione. *

L'esempio seguente esegue una query su tutto il contenuto. Volumes

$ aws ec2 describe-volumes \
    --query 'Volumes[*]'
[
  {
    "AvailabilityZone": "us-west-2a",
    "Attachments": [
      {
        "AttachTime": "2013-09-17T00:55:03.000Z",
        "InstanceId": "i-a071c394",
        "VolumeId": "vol-e11a5288",
        "State": "attached",
        "DeleteOnTermination": true,
        "Device": "/dev/sda1"
      }
    ],
    "VolumeType": "standard",
    "VolumeId": "vol-e11a5288",
    "State": "in-use",
    "SnapshotId": "snap-f23ec1c8",
    "CreateTime": "2013-09-17T00:55:03.000Z",
    "Size": 30
  },
  {
    "AvailabilityZone": "us-west-2a",
    "Attachments": [
      {
        "AttachTime": "2020-11-20T19:54:06.000Z",
        "InstanceId": "i-1jd73kv8",
        "VolumeId": "vol-a1b3c7nd",
        "State": "attached",
        "DeleteOnTermination": true,
        "Device": "/dev/sda1"
      }
    ],
    "VolumeType": "standard",
    "VolumeId": "vol-a1b3c7nd",
    "State": "in-use",
    "SnapshotId": "snap-234087fb",
    "CreateTime": "2020-11-20T19:54:05.000Z",
    "Size": 15
  }
]

Per visualizzare un volume specifico nell'array per indice, si chiama l'indice dell'array. Ad esempio, il primo elemento dell'Volumesarray ha un indice pari a 0, che risulta nella Volumes[0] query. Per ulteriori informazioni sugli indici degli array, vedere le espressioni di indice sul sito Web JMESPath.

$ aws ec2 describe-volumes \
    --query 'Volumes[0]'
{
  "AvailabilityZone": "us-west-2a",
  "Attachments": [
    {
      "AttachTime": "2013-09-17T00:55:03.000Z",
      "InstanceId": "i-a071c394",
      "VolumeId": "vol-e11a5288",
      "State": "attached",
      "DeleteOnTermination": true,
      "Device": "/dev/sda1"
    }
  ],
  "VolumeType": "standard",
  "VolumeId": "vol-e11a5288",
  "State": "in-use",
  "SnapshotId": "snap-f23ec1c8",
  "CreateTime": "2013-09-17T00:55:03.000Z",
  "Size": 30
}

Per visualizzare un intervallo specifico di volumi per indice, utilizzatelo slice con la seguente sintassi, dove start è l'indice iniziale dell'array, stop è l'indice in cui il filtro interrompe l'elaborazione e step è l'intervallo di salto.

Sintassi

<arrayName>[<start>:<stop>:<step>]

Se uno di questi valori viene omesso dall'espressione slice, utilizza i seguenti valori predefiniti:

  • Inizio: il primo indice dell'elenco, 0.

  • Stop: l'ultimo indice dell'elenco.

  • Fase: nessun passaggio da saltare, dove il valore è 1.

Per restituire solo i primi due volumi, utilizzate un valore iniziale pari a 0, un valore di arresto pari a 2 e un valore Step pari a 1, come illustrato nell'esempio seguente.

$ aws ec2 describe-volumes \
    --query 'Volumes[0:2:1]'
[
  {
    "AvailabilityZone": "us-west-2a",
    "Attachments": [
      {
        "AttachTime": "2013-09-17T00:55:03.000Z",
        "InstanceId": "i-a071c394",
        "VolumeId": "vol-e11a5288",
        "State": "attached",
        "DeleteOnTermination": true,
        "Device": "/dev/sda1"
      }
    ],
    "VolumeType": "standard",
    "VolumeId": "vol-e11a5288",
    "State": "in-use",
    "SnapshotId": "snap-f23ec1c8",
    "CreateTime": "2013-09-17T00:55:03.000Z",
    "Size": 30
  },
  {
    "AvailabilityZone": "us-west-2a",
    "Attachments": [
      {
        "AttachTime": "2013-09-18T20:26:16.000Z",
        "InstanceId": "i-4b41a37c",
        "VolumeId": "vol-2e410a47",
        "State": "attached",
        "DeleteOnTermination": true,
        "Device": "/dev/sda1"
      }
    ],
    "VolumeType": "standard",
    "VolumeId": "vol-2e410a47",
    "State": "in-use",
    "SnapshotId": "snap-708e8348",
    "CreateTime": "2013-09-18T20:26:15.000Z",
    "Size": 8
  }
]

Poiché questo esempio contiene valori predefiniti, potete abbreviare la sezione da aVolumes[0:2:1]. Volumes[:2]

L'esempio seguente omette i valori predefiniti e restituisce ogni due volumi dell'intero array.

$ aws ec2 describe-volumes \
    --query 'Volumes[::2]'
[
  {
    "AvailabilityZone": "us-west-2a",
    "Attachments": [
      {
        "AttachTime": "2013-09-17T00:55:03.000Z",
        "InstanceId": "i-a071c394",
        "VolumeId": "vol-e11a5288",
        "State": "attached",
        "DeleteOnTermination": true,
        "Device": "/dev/sda1"
      }
    ],
    "VolumeType": "standard",
    "VolumeId": "vol-e11a5288",
    "State": "in-use",
    "SnapshotId": "snap-f23ec1c8",
    "CreateTime": "2013-09-17T00:55:03.000Z",
    "Size": 30
  },
  {
    "AvailabilityZone": "us-west-2a",
    "Attachments": [
      {
        "AttachTime": "2020-11-20T19:54:06.000Z",
        "InstanceId": "i-1jd73kv8",
        "VolumeId": "vol-a1b3c7nd",
        "State": "attached",
        "DeleteOnTermination": true,
        "Device": "/dev/sda1"
      }
    ],
    "VolumeType": "standard",
    "VolumeId": "vol-a1b3c7nd",
    "State": "in-use",
    "SnapshotId": "snap-234087fb",
    "CreateTime": "2020-11-20T19:54:05.000Z",
    "Size": 15
  }
]

I passaggi possono anche utilizzare numeri negativi per filtrare nell'ordine inverso di una matrice, come illustrato nell'esempio seguente. 

$ aws ec2 describe-volumes \
    --query 'Volumes[::-2]'
[
  {
    "AvailabilityZone": "us-west-2a",
    "Attachments": [
      {
        "AttachTime": "2020-11-20T19:54:06.000Z",
        "InstanceId": "i-1jd73kv8",
        "VolumeId": "vol-a1b3c7nd",
        "State": "attached",
        "DeleteOnTermination": true,
        "Device": "/dev/sda1"
      }
    ],
    "VolumeType": "standard",
    "VolumeId": "vol-a1b3c7nd",
    "State": "in-use",
    "SnapshotId": "snap-234087fb",
    "CreateTime": "2020-11-20T19:54:05.000Z",
    "Size": 15
  },
  {
    "AvailabilityZone": "us-west-2a",
    "Attachments": [
      {
        "AttachTime": "2013-09-17T00:55:03.000Z",
        "InstanceId": "i-a071c394",
        "VolumeId": "vol-e11a5288",
        "State": "attached",
        "DeleteOnTermination": true,
        "Device": "/dev/sda1"
      }
    ],
    "VolumeType": "standard",
    "VolumeId": "vol-e11a5288",
    "State": "in-use",
    "SnapshotId": "snap-f23ec1c8",
    "CreateTime": "2013-09-17T00:55:03.000Z",
    "Size": 30
  }
]

Per ulteriori informazioni, vedere Slices sul sito Web JMESPath.

Filtraggio dei dati annidati

Per restringere il filtraggio dei Volumes[*] valori nidificati, utilizzate le sottoespressioni aggiungendo un punto e i criteri di filtro.

Sintassi

<expression>.<expression>

L'esempio seguente mostra tutte le Attachments informazioni per tutti i volumi.

$ aws ec2 describe-volumes \
    --query 'Volumes[*].Attachments'
[
  [
    {
      "AttachTime": "2013-09-17T00:55:03.000Z",
      "InstanceId": "i-a071c394",
      "VolumeId": "vol-e11a5288",
      "State": "attached",
      "DeleteOnTermination": true,
      "Device": "/dev/sda1"
    }
  ],
  [
    {
      "AttachTime": "2013-09-18T20:26:16.000Z",
      "InstanceId": "i-4b41a37c",
      "VolumeId": "vol-2e410a47",
      "State": "attached",
      "DeleteOnTermination": true,
      "Device": "/dev/sda1"
    }
  ],
  [
    {
      "AttachTime": "2020-11-20T19:54:06.000Z",
      "InstanceId": "i-1jd73kv8",
      "VolumeId": "vol-a1b3c7nd",
      "State": "attached",
      "DeleteOnTermination": true,
      "Device": "/dev/sda1"
    }
  ]
]

Per filtrare ulteriormente i valori nidificati, aggiungete l'espressione per ogni identificatore nidificato. L'esempio seguente elenca for all. State Volumes

$ aws ec2 describe-volumes \
    --query 'Volumes[*].Attachments[*].State'
[
  [
    "attached"
  ],
  [
    "attached"
  ],
  [
    "attached"
  ]
]

Risultati di appiattimento

Per ulteriori informazioni, vedere il sito Web SubExpressionsJMESPath.

È possibile appiattire i risultati Volumes[*].Attachments[*].State rimuovendo la notazione jolly risultante dalla query. Volumes[*].Attachments[].State L'appiattimento spesso è utile per migliorare la leggibilità dei risultati.

$ aws ec2 describe-volumes \
    --query 'Volumes[*].Attachments[].State'
[
  "attached",
  "attached",
  "attached"
]

Per ulteriori informazioni, vedere Flatten sul sito Web JMESPath.

Filtraggio per valori specifici

Per filtrare valori specifici in un elenco, si utilizza un'espressione di filtro come illustrato nella sintassi seguente.

Sintassi

? <expression> <comparator> <expression>]

I comparatori di espressioni includono==,!=,<, <=>, e. >= L'esempio seguente filtra per VolumeIds for all Volumes in an AttachedState.

$ aws ec2 describe-volumes \
    --query 'Volumes[*].Attachments[?State==`attached`].VolumeId'
[
  [
    "vol-e11a5288"
  ],
  [
    "vol-2e410a47"
  ],
  [
    "vol-a1b3c7nd"
  ]
]

Questo può quindi essere appiattito, ottenendo l'esempio seguente.

$ aws ec2 describe-volumes \
    --query 'Volumes[*].Attachments[?State==`attached`].VolumeId[]'
[
  "vol-e11a5288",
  "vol-2e410a47",
  "vol-a1b3c7nd"
]

L'esempio seguente filtra tutti quelli Volumes che hanno una dimensione inferiore a 20. VolumeIds

$ aws ec2 describe-volumes \
    --query 'Volumes[?Size < `20`].VolumeId'
[
  "vol-2e410a47",
  "vol-a1b3c7nd"
]

Per ulteriori informazioni, consulta Filter Expressions sul sito Web JMESPath.

Espressioni di piping

È possibile reindirizzare i risultati di un filtro a un nuovo elenco e quindi filtrare il risultato con un'altra espressione utilizzando la sintassi seguente:

Sintassi

<expression> | <expression>]

L'esempio seguente prende i risultati del filtro dell'Volumes[*].Attachments[].InstanceIdespressione e restituisce il primo risultato nell'array. 

$ aws ec2 describe-volumes \
    --query 'Volumes[*].Attachments[].InstanceId | [0]'
"i-a071c394"

Questo esempio esegue questa operazione creando innanzitutto l'array dalla seguente espressione.

$ aws ec2 describe-volumes \
    --query 'Volumes[*].Attachments[].InstanceId'
"i-a071c394",
  "i-4b41a37c",
  "i-1jd73kv8"

Quindi restituisce il primo elemento di quell'array.

"i-a071c394"

Per ulteriori informazioni, vedere Pipe Expressions sul sito Web JMESPath.

Filtraggio per più valori identificativi

Per filtrare più identificatori, si utilizza un elenco a selezione multipla utilizzando la seguente sintassi:

Sintassi

<listName>[].[<expression>, <expression>]

Nell'esempio seguente, VolumeId e VolumeType vengono filtrati nell'Volumeselenco risultante dalla seguente espressione.

$ aws ec2 describe-volumes \
    --query 'Volumes[].[VolumeId, VolumeType]'
[
  [
    "vol-e11a5288",
    "standard"
  ],
  [
    "vol-2e410a47",
    "standard"
  ],
  [
    "vol-a1b3c7nd",
    "standard"
  ]
]

Per aggiungere dati annidati all'elenco, aggiungete un altro elenco a selezione multipla. L'esempio seguente amplia l'esempio precedente filtrando anche per InstanceId e nell'elenco nidificato. State Attachments Il risultato è la seguente espressione.

$ aws ec2 describe-volumes \
    --query 'Volumes[].[VolumeId, VolumeType, Attachments[].[InstanceId, State]]'
[
  [
    "vol-e11a5288",
    "standard",
    [
      [
        "i-a071c394",
        "attached"
      ]
    ]
  ],
  [
    "vol-2e410a47",
    "standard",
    [
      [
        "i-4b41a37c",
        "attached"
      ]
    ]
  ],
  [
    "vol-a1b3c7nd",
    "standard",
    [
      [
        "i-1jd73kv8",
        "attached"
      ]
    ]
  ]
]

Per renderla più leggibile, appiattite l'espressione come illustrato nell'esempio seguente.

$ aws ec2 describe-volumes \
    --query 'Volumes[].[VolumeId, VolumeType, Attachments[].[InstanceId, State][]][]'
[
  "vol-e11a5288",
  "standard",
  [
    "i-a071c394",
    "attached"
  ],
  "vol-2e410a47",
  "standard",
  [
    "i-4b41a37c",
    "attached"
  ],
  "vol-a1b3c7nd",
  "standard",
  [
    "i-1jd73kv8",
    "attached"
  ]
]

Per ulteriori informazioni, vedere Elenco a selezione multipla sul sito Web JMESPath.

Aggiungere etichette ai valori degli identificatori

Per facilitare la lettura di questo output, utilizzate un hash a selezione multipla con la seguente sintassi.

Sintassi

<listName>[].{<label>: <expression>, <label>: <expression>}

L'etichetta identificativa non deve necessariamente corrispondere al nome dell'identificatore. L'esempio seguente utilizza l'etichetta VolumeType per i VolumeType valori.

$ aws ec2 describe-volumes \
    --query 'Volumes[].{VolumeType: VolumeType}'
[
  {
    "VolumeType": "standard",
  },
  {
    "VolumeType": "standard",
  },
  {
    "VolumeType": "standard",
  }
]

Per semplicità, l'esempio seguente mantiene i nomi degli identificatori per ogni etichetta e visualizzaVolumeId, VolumeTypeInstanceId, e State per tutti i volumi:

$ aws ec2 describe-volumes \
    --query 'Volumes[].{VolumeId: VolumeId, VolumeType: VolumeType, InstanceId: Attachments[0].InstanceId, State: Attachments[0].State}'
[
  {
    "VolumeId": "vol-e11a5288",
    "VolumeType": "standard",
    "InstanceId": "i-a071c394",
    "State": "attached"
  },
  {
    "VolumeId": "vol-2e410a47",
    "VolumeType": "standard",
    "InstanceId": "i-4b41a37c",
    "State": "attached"
  },
  {
    "VolumeId": "vol-a1b3c7nd",
    "VolumeType": "standard",
    "InstanceId": "i-1jd73kv8",
    "State": "attached"
  }
]

Per ulteriori informazioni, vedere Multiselect hash sul sito Web JMESPath.

Funzioni

La sintassi JMESPath contiene molte funzioni che è possibile utilizzare per le query. Per informazioni sulle funzioni JMESPath, vedere Funzioni integrate nel sito Web JMESPath.

Per dimostrare come incorporare una funzione nelle query, l'esempio seguente utilizza la funzione. sort_by La sort_by funzione ordina un array utilizzando un'espressione come chiave di ordinamento utilizzando la sintassi seguente:

Sintassi

sort_by(<listName>, <sort expression>)[].<expression>

L'esempio seguente utilizza il precedente esempio di hash multiselect e ordina l'output per. VolumeId 

$ aws ec2 describe-volumes \
    --query 'sort_by(Volumes, &VolumeId)[].{VolumeId: VolumeId, VolumeType: VolumeType, InstanceId: Attachments[0].InstanceId, State: Attachments[0].State}'
[
  {
    "VolumeId": "vol-2e410a47",
    "VolumeType": "standard",
    "InstanceId": "i-4b41a37c",
    "State": "attached"
  },
  {
    "VolumeId": "vol-a1b3c7nd",
    "VolumeType": "standard",
    "InstanceId": "i-1jd73kv8",
    "State": "attached"
  },
  {
    "VolumeId": "vol-e11a5288",
    "VolumeType": "standard",
    "InstanceId": "i-a071c394",
    "State": "attached"
  }
]

Per ulteriori informazioni, vedere sort_by sul sito Web JMESPath.

Esempi avanzati --query

Per estrarre informazioni da un elemento specifico

L'esempio seguente utilizza il parametro --query per trovare un determinato elemento in un elenco e quindi estrae le informazioni da tale elemento. L'esempio elenca tutti gli endpoint di servizio AvailabilityZones associati all'endpoint di servizio specificato. Estrae l'elemento dall'elenco ServiceDetails che ha specificato ServiceName, quindi emette il campo AvailabilityZones da questo elemento selezionato. 

$ aws --region us-east-1 ec2 describe-vpc-endpoint-services \
    --query 'ServiceDetails[?ServiceName==`com.amazonaws.us-east-1.ecs`].AvailabilityZones'
[
    [
        "us-east-1a",
        "us-east-1b",
        "us-east-1c",
        "us-east-1d",
        "us-east-1e",
        "us-east-1f"
    ]
]

Per mostrare istantanee dopo la data di creazione specificata

L'esempio seguente mostra come creare un elenco di tutte le snapshot che sono state create dopo una data specifica, includendo solo alcuni dei campi disponibili nell'output.

$ aws ec2 describe-snapshots --owner self \
    --output json \
    --query 'Snapshots[?StartTime>=`2018-02-07`].{Id:SnapshotId,VId:VolumeId,Size:VolumeSize}'
[
    {
        "id": "snap-0effb42b7a1b2c3d4",
        "vid": "vol-0be9bb0bf12345678",
        "Size": 8
    }
]

Per mostrare le AMI più recenti

L'esempio seguente crea un elenco delle cinque Amazon Machine Images (AMI) più recenti che sono state create, ordinate dalla più recente alla meno recente.

$ aws ec2 describe-images \
    --owners self \
    --query 'reverse(sort_by(Images,&CreationDate))[:5].{id:ImageId,date:CreationDate}'
[
    {
        "id": "ami-0a1b2c3d4e5f60001",
        "date": "2018-11-28T17:16:38.000Z"
    },
    {
        "id": "ami-0a1b2c3d4e5f60002",
        "date": "2018-09-15T13:51:22.000Z"
    },
    {
        "id": "ami-0a1b2c3d4e5f60003",
        "date": "2018-08-19T10:22:45.000Z"
    },
    {
        "id": "ami-0a1b2c3d4e5f60004",
        "date": "2018-05-03T12:04:02.000Z"
    },
    {
        "id": "ami-0a1b2c3d4e5f60005",
        "date": "2017-12-13T17:16:38.000Z"
    }
]

Per mostrare istanze di Auto Scaling non integre

L'esempio seguente mostra solo le InstanceId istanze non integre nel gruppo Auto Scaling specificato.

$ aws autoscaling describe-auto-scaling-groups \
    --auto-scaling-group-name My-AutoScaling-Group-Name \
    --output text \
    --query 'AutoScalingGroups[*].Instances[?HealthStatus==`Unhealthy`].InstanceId'

Per includere volumi con il tag specificato

L'esempio seguente descrive tutte le istanze con un test tag. Finché è presente un altro tag accanto test al volume, il volume viene comunque restituito nei risultati.

L'espressione seguente per restituire tutti i tag con il test tag in un array. Tutti i tag che non sono il test tag contengono un null valore.

$ aws ec2 describe-volumes \
    --query 'Volumes[*].Tags[?Value == `test`]'

Per escludere i volumi con il tag specificato

L'esempio seguente descrive tutte le istanze senza test tag. L'uso di ?Value != `test` un'espressione semplice non funziona per escludere un volume poiché i volumi possono avere più tag. Finché c'è un altro tag test accanto al volume, il volume viene comunque restituito nei risultati.

Per escludere tutti i volumi con il test tag, inizia con l'espressione seguente per restituire tutti i tag con il test tag in un array. Tutti i tag che non sono il test tag contengono un null valore.

$ aws ec2 describe-volumes \
    --query 'Volumes[*].Tags[?Value == `test`]'

Quindi filtra tutti i test risultati positivi utilizzando la not_null funzione. 

$ aws ec2 describe-volumes \
    --query 'Volumes[!not_null(Tags[?Value == `test`].Value)]'

Indirizza i risultati per appiattire i risultati risultanti dalla seguente query.

$ aws ec2 describe-volumes \
    --query 'Volumes[!not_null(Tags[?Value == `test`].Value)] | []'

Combinazione del filtraggio lato server e lato client

È possibile utilizzare il filtraggio lato server e lato client insieme. Per prima cosa viene completato il filtraggio lato server, che invia i dati al client che il parametro filtra quindi. --query Se utilizzi set di dati di grandi dimensioni, utilizzando innanzitutto il filtro lato server è possibile ridurre la quantità di dati inviati al client per ogni AWS CLI chiamata, pur mantenendo la potente personalizzazione fornita dal filtro lato client.

L'esempio seguente elenca i volumi Amazon EC2 che utilizzano filtri lato server e lato client. Il servizio filtra un elenco di tutti i volumi collegati nella zona di disponibilità. us-west-2a Il parametro --query limita ulteriormente l'output ai soli volumi con un valore Size maggiore di 50 e mostra solo i campi specificati con nomi definiti dall'utente.

$ aws ec2 describe-volumes \
    --filters "Name=availability-zone,Values=us-west-2a" "Name=status,Values=attached" \
    --query 'Volumes[?Size > `50`].{Id:VolumeId,Size:Size,Type:VolumeType}'
[
    {
        "Id": "vol-0be9bb0bf12345678",
        "Size": 80,
        "VolumeType": "gp2"
    }
]

L'esempio seguente consente di recuperare un elenco di immagini che soddisfano diversi criteri. Quindi utilizza il parametro --query per ordinare l'output in base a CreationDate, selezionando solo il più recente. Infine, visualizza l'ImageId di tale immagine.

$ aws ec2 describe-images \
    --owners amazon \
    --filters "Name=name,Values=amzn*gp2" "Name=virtualization-type,Values=hvm" "Name=root-device-type,Values=ebs" \
    --query "sort_by(Images, &CreationDate)[-1].ImageId" \
    --output text
ami-00ced3122871a4921

Nell'esempio seguente viene visualizzato il numero di volumi disponibili che sono più di 1000 IOPS utilizzando length per contarne il numero in un elenco.

$ aws ec2 describe-volumes \
    --filters "Name=status,Values=available" \
    --query 'length(Volumes[?Iops > `1000`])'
3

Risorse aggiuntive

AWS CLI prompt automatico

Quando si inizia a utilizzare le espressioni di filtro, è possibile utilizzare la funzionalità di prompt automatico nella AWS CLI versione 2. La funzione di richiesta automatica fornisce un'anteprima quando si preme il tasto F5. Per ulteriori informazioni, consulta Ricevi la AWS CLI richiesta di comandi.

Terminale JMESPath

JMESPath Terminal è un comando terminale interattivo per sperimentare le espressioni JMESPath utilizzate per il filtraggio lato client. Utilizzando il jpterm comando, il terminale mostra i risultati delle query immediati durante la digitazione. È possibile reindirizzare l' AWS CLI output direttamente al terminale, abilitando la sperimentazione avanzata di interrogazioni.

L'esempio seguente reindirizza l'aws ec2 describe-volumesoutput direttamente al terminale JMESPath.

$ aws ec2 describe-volumes | jpterm

Per ulteriori informazioni su JMESPath Terminal e per le istruzioni di installazione, vedete JMESPath Terminal on. GitHub

utilità jq

L'jqutilità offre un modo per trasformare l'output sul lato client nel formato di output desiderato. Per ulteriori informazioni jq e istruzioni di installazione, vedere jq on. GitHub