...
← Curs Cloud: AWS fundamentals: toate lecțiile
Lecția 9 · AWS CLI

Formate de ieșire și --query

Răspunsurile AWS pot fi lungi. În această lecție înveți să alegi formatul potrivit (json, text, table, yaml) și să păstrezi doar câmpurile care te interesează cu --query. La final pui un ID într-o variabilă de shell, tehnica pe care o vei folosi în aproape toate scripturile din curs.

Cele patru formate

FormatArată caCând îl folosești
json (implicit)acolade, ghilimele, listeprograme și scripturi care citesc răspunsul, jq
textvalori separate prin tab, fără ghilimelevariabile de shell, grep, cut, fișiere simple
tableun tabel desenatcitit de oameni, pe ecran
yamlchei: valori, cu indentarecitit de oameni, fișiere de configurare

Formatul se alege cu --output la fiecare comandă, sau implicit, cu aws configure set output (lecția 7). Același răspuns, în YAML:

aws ec2 describe-vpcs --output yaml
Vpcs:
- BlockPublicAccessStates:
    InternetGatewayBlockMode: off
  CidrBlock: 172.31.0.0/16
  CidrBlockAssociationSet:
  - AssociationId: vpc-cidr-assoc-01e8b31c099916d0d
    CidrBlock: 172.31.0.0/16
    CidrBlockState:
      State: associated
  DhcpOptionsId: dopt-00c10658f79939514
  InstanceTenancy: default
  IsDefault: true
  OwnerId: '123456789012'
  State: available
  VpcId: vpc-01bb286f70f424802

--query: doar ce te interesează

--query primește o expresie în limbajul JMESPath, care alege bucăți din răspunsul JSON. Câteva reguli acoperă aproape tot ce îți trebuie:

ExpresieCe alegeExemplu
Campun câmpAccount
Camp.SubCampun câmp din interiorUser.Arn
Lista[0]primul element al listeiVpcs[0]
Lista[].Campcâmpul din fiecare elementVpcs[].VpcId
Lista[].[A,B]mai multe câmpuri din fiecare elementVpcs[].[VpcId,CidrBlock]
Lista[?Camp]doar elementele la care câmpul e adevăratVpcs[?IsDefault]

Numele câmpurilor se scriu exact ca în JSON, cu litere mari și mici. Pune expresia între ghilimele simple, ca shell-ul să nu interpreteze [ și ]. Un exemplu cu două câmpuri, afișate ca tabel:

aws ec2 describe-vpcs --query 'Vpcs[].[VpcId,CidrBlock]' --output table
--------------------------------------------
|               DescribeVpcs               |
+------------------------+-----------------+
|  vpc-01bb286f70f424802 |  172.31.0.0/16  |
+------------------------+-----------------+

Subrețelele VPC-ului implicit, câte una pe fiecare zonă de disponibilitate (lecția 5):

aws ec2 describe-subnets --query 'Subnets[].[AvailabilityZone,CidrBlock]' --output table
-------------------------------------
|          DescribeSubnets          |
+----------------+------------------+
|  eu-central-1a |  172.31.0.0/20   |
|  eu-central-1b |  172.31.16.0/20  |
|  eu-central-1c |  172.31.32.0/20  |
+----------------+------------------+
Exercițiul tău

Un script de rețea are nevoie de două fișiere simple, fără JSON: ID-ul VPC-ului implicit și adresele subrețelelor lui.

  • Salvează în ~/vpc.txt doar ID-ul VPC-ului implicit (cu --query și --output text).
  • Salvează în ~/subretele.txt blocurile CIDR ale subrețelelor (aws ec2 describe-subnets, câmpul CidrBlock), tot cu --output text.
Pentru primul fișier, comanda din secțiunea „Filtre” sau --query 'Vpcs[0].VpcId'. Pentru al doilea: --query 'Subnets[].CidrBlock'.

Soluția exercițiului

aws ec2 describe-vpcs --query 'Vpcs[?IsDefault].VpcId' --output text > ~/vpc.txt
aws ec2 describe-subnets --query 'Subnets[].CidrBlock' --output text > ~/subretele.txt
Excelent! Continuă cu lecția următoare →
Vrei să afli mai mult?Filtre · Text + $(...) = variabile · jq, alternativa · Greșeli frecvente · Rezumat

Filtre

Cu [?…] păstrezi doar elementele care îndeplinesc o condiție. Vpcs[?IsDefault] înseamnă „VPC-urile la care IsDefault este adevărat”, iar .VpcId alege apoi ID-ul lor:

aws ec2 describe-vpcs --query 'Vpcs[?IsDefault].VpcId' --output text
vpc-01bb286f70f424802

Filtrele pot compara și cu o valoare (de exemplu, doar subrețelele dintr-o anumită zonă); le vei folosi în modulul de rețea. Deocamdată, filtrul simplu [?Camp] este suficient.

Text + $(...) = variabile

Combinația cea mai folosită în scripturi: --query alege o singură valoare, --output text o scrie fără ghilimele, iar $(...) din cursul de Linux o pune într-o variabilă:

VPC=$(aws ec2 describe-vpcs --query 'Vpcs[0].VpcId' --output text)
echo $VPC
vpc-01bb286f70f424802

De acum poți scrie $VPC în loc de ID-ul lung, în orice comandă următoare: aws ec2 describe-subnets --filters Name=vpc-id,Values=$VPC. Așa vei lega între ele resursele: creezi un security group, îi salvezi ID-ul, apoi îl dai serverului.

De ce text și nu json

Cu --output json, aceeași comandă ar scrie "vpc-…", cu ghilimele, iar variabila ar conține și ghilimelele. Pentru variabile folosește mereu --output text.

jq, alternativa

jq este un program Linux care filtrează JSON. Primește răspunsul printr-un pipe |; -r scrie valoarea fără ghilimele:

aws ec2 describe-vpcs | jq -r '.Vpcs[0].CidrBlock'
172.31.0.0/16

--query e de obicei suficient și nu are nevoie de alt program; jq e util când ai deja un fișier JSON salvat sau când transformarea e mai complicată.

Greșeli frecvente

  • Litere mari greșite: --query 'vpcs[0].vpcid' nu găsește nimic, pentru că câmpurile sunt Vpcs și VpcId. Când nu știi numele exact, rulează întâi comanda fără --query și uită-te la JSON.
  • Ghilimele duble sau lipsă: fără ghilimele simple, shell-ul poate încerca să interpreteze parantezele drepte.
  • **[] uitat**: Vpcs.VpcId nu merge, pentru că Vpcs este o listă; scrie Vpcs[].VpcId (toate) sau Vpcs[0].VpcId (primul).
  • **--output json pentru variabile**: variabila primește și ghilimelele.

O expresie care nu găsește nimic nu dă eroare: răspunsul este pur și simplu gol (în unele versiuni ale CLI-ului apare None sau null). Dacă nu primești nimic înapoi, verifică numele câmpurilor.

Rezumat

Pentru ochi

--output table + --query cu câteva coloane: un rezumat clar pe ecran.

Pentru scripturi

--query cu o singură valoare + --output text + $(...): ID-uri în variabile.

Pentru fișiere

--output text > fisier.txt pentru liste simple, json pentru date complete.

terminalAWS
VerificareSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Parcursul tău Primii pași în cloud cu AWS Lecția 9 · Formate de ieșire și --query
Progres 0% 0 din 17
Lecția curentă 9 / 15 Aws cli