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
| Format | Arată ca | Când îl folosești |
|---|---|---|
| json (implicit) | acolade, ghilimele, liste | programe și scripturi care citesc răspunsul, jq |
| text | valori separate prin tab, fără ghilimele | variabile de shell, grep, cut, fișiere simple |
| table | un tabel desenat | citit de oameni, pe ecran |
| yaml | chei: valori, cu indentare | citit 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:
| Expresie | Ce alege | Exemplu |
|---|---|---|
| Camp | un câmp | Account |
| Camp.SubCamp | un câmp din interior | User.Arn |
| Lista[0] | primul element al listei | Vpcs[0] |
| Lista[].Camp | câmpul din fiecare element | Vpcs[].VpcId |
| Lista[].[A,B] | mai multe câmpuri din fiecare element | Vpcs[].[VpcId,CidrBlock] |
| Lista[?Camp] | doar elementele la care câmpul e adevărat | Vpcs[?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 | +----------------+------------------+
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.
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
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.
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
--output table + --query cu câteva coloane: un rezumat clar pe ecran.
--query cu o singură valoare + --output text + $(...): ID-uri în variabile.
--output text > fisier.txt pentru liste simple, json pentru date complete.
