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

Questa documentazione è valida AWS CLI solo per la versione 1. Per la documentazione relativa alla versione 2 di AWS CLI, consulta la Guida per l'utente della versione 2.

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à.

Uscita di filtraggio nel AWS CLI

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 da, e in genere viene implementato con un parametroAPI. --filter Il servizio restituisce solo risultati corrispondenti che possono accelerare i tempi di HTTP risposta 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 è fornito dal AWS CLI servizio. AWS API Il AWS servizio restituisce solo i record nella HTTP risposta che corrispondono al filtro, il che può accelerare i tempi di HTTP risposta per set di dati di grandi dimensioni. Poiché il filtraggio lato server è definito dal servizioAPI, i nomi e le funzioni dei parametri variano tra i servizi. Alcuni nomi di parametri comuni utilizzati per il filtraggio sono:

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

Filtraggio lato client

AWS CLI Fornisce funzionalità di filtraggio lato client integrate JSON 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 HTTP risposta che arriva dal server e filtra i risultati prima di visualizzarli. Poiché l'intera HTTP risposta 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 per creare espressioni per filtrare l'output. JMESPath Per imparare la JMESPath sintassi, consultate il Tutorial sul sito web. JMESPath

Importante

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

  • 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 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 Utilizzo di virgolette e valori letterali con stringhe in AWS CLI.

L'JSONoutput seguente mostra un esempio di ciò che il --query parametro può produrre. L'output descrive tre EBS volumi Amazon collegati a EC2 istanze Amazon 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, vedete Identificatori sul JMESPath sito Web.

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 delle matrici, consultate le espressioni di indice sul JMESPath sito Web.

$ 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, consultate Slices sul JMESPathsito Web.

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 il for all. State Volumes

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

Risultati di appiattimento

Per ulteriori informazioni, consultate il SubExpressionsJMESPathsito Web.

È 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 JMESPathsito Web.

Espressioni di tubazione

È 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, consulta Pipe Expressions sul JMESPathsito Web.

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, consulta Multiselect hash sul sito Web. JMESPath

Funzioni

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

Per dimostrare come incorporare una funzione nelle query, l'esempio seguente utilizza la sort_by funzione. 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 più recenti AMIs

L'esempio seguente elenca le cinque Amazon Machine Images (AMIs) più recenti che hai creato, 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 i 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 EC2 i volumi Amazon 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

L'esempio seguente visualizza il numero di volumi disponibili superiori a 1000 IOPS utilizzando length per contare quanti sono presenti in un elenco.

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

Risorse aggiuntive

JMESPathTerminale

JMESPathTerminal è un comando terminale interattivo per sperimentare JMESPath espressioni 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 a Terminal. JMESPath

$ aws ec2 describe-volumes | jpterm

Per ulteriori informazioni su JMESPath Terminal e istruzioni di installazione, consulta JMESPathTerminal 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