Structura unei comenzi AWS CLI
Toate comenzile AWS CLI au aceeași formă, oricare ar fi serviciul. Dacă o înțelegi o dată, poți citi și scrie comenzi pentru servicii pe care nu le-ai folosit niciodată. În această lecție desfaci o comandă în bucăți, afli unde găsești ajutor, cum citești mesajele de eroare și ce înseamnă codurile de ieșire.
Forma generală
aws <serviciu> <operație> --parametru valoare --alt-parametru valoare
| Bucata | Exemplu | Ce înseamnă |
|---|---|---|
| aws | aws | programul AWS CLI |
| serviciul | ec2, s3, iam, sts | cu ce serviciu vorbești |
| operația | describe-vpcs, create-user | ce îi ceri serviciului; de obicei un verb + un substantiv |
| parametrii | --user-name ana | detaliile operației, mereu cu două cratime |
Verbele se repetă de la un serviciu la altul și îți spun ce face comanda: describe-…, list-… și get-… doar citesc; create-…, put-…, run-… creează; delete-… și terminate-… șterg; modify-… și update-… schimbă. Comenzile care doar citesc sunt sigure: le poți rula oricât.
Codurile de ieșire
Ca orice program Linux, AWS CLI se termină cu un cod de ieșire, pe care îl citești cu echo $? imediat după comandă (cursul de Linux). Scripturile îl folosesc ca să știe dacă o comandă a reușit.
| Cod | Când |
|---|---|
| 0 | comanda a reușit |
| 1 | o comandă aws s3 … (mb, cp, sync, rb) a eșuat |
| 252 | comanda e scrisă greșit (operație sau parametru inexistent) |
| 254 | comanda e corectă, dar AWS a refuzat-o (eroare de serviciu: resursă inexistentă, lipsă de permisiuni) |
| 255 | altă problemă, de exemplu nu se poate ajunge la AWS sau un fișier local lipsește |
De exemplu, codul comenzii cu ID-ul inexistent de mai sus:
aws ec2 describe-vpcs --vpc-ids vpc-123 echo $?
An error occurred (InvalidVpcID.NotFound) when calling the DescribeVpcs operation: The vpc ID 'vpc-123' does not exist 254
Ultima linie, 254, este codul de ieșire: AWS a primit cererea și a refuzat-o. Codul se poate salva și într-un fișier, cu echo $? > cod.txt, imediat după comanda care te interesează.
Pregătește două fișiere pentru documentația proiectului: descrierea completă a rețelelor din cont și codul de ieșire al unei comenzi greșite.
- Salvează răspunsul lui aws ec2 describe-vpcs în fișierul ~/vpcs.json.
- Rulează comanda greșită aws s3 mb s3://Magazin_Ana și, imediat după ea, salvează codul ei de ieșire în ~/cod.txt (cu echo $? > ~/cod.txt).
Soluția exercițiului
aws ec2 describe-vpcs > ~/vpcs.json aws s3 mb s3://Magazin_Ana echo $? > ~/cod.txt
Vrei să afli mai mult?Un exemplu complet · Opțiuni globale și ajutor · Mesajele de eroare · Greșeli frecvente · Exemple reale
Un exemplu complet
Fiecare cont nou are în fiecare regiune o rețea gata făcută, VPC-ul implicit (despre rețele vorbim în modulul 4). O comandă de citire o descrie:
aws ec2 describe-vpcs
{
"Vpcs": [
{
"OwnerId": "123456789012",
"InstanceTenancy": "default",
"CidrBlockAssociationSet": [
{
"AssociationId": "vpc-cidr-assoc-01e8b31c099916d0d",
"CidrBlock": "172.31.0.0/16",
"CidrBlockState": {
"State": "associated"
}
}
],
"IsDefault": true,
"BlockPublicAccessStates": {
"InternetGatewayBlockMode": "off"
},
"VpcId": "vpc-01bb286f70f424802",
"State": "available",
"CidrBlock": "172.31.0.0/16",
"DhcpOptionsId": "dopt-00c10658f79939514"
}
]
}Serviciul este ec2, operația describe-vpcs, fără parametri. Răspunsul JSON are o listă Vpcs cu un singur element: rețeaua cu adresele 172.31.0.0/16, marcată IsDefault: true. ID-ul (vpc-…) va fi altul în contul tău: fiecare cont are ID-urile lui.
Opțiuni globale și ajutor
Unele opțiuni merg la orice comandă și schimbă felul în care rulează, nu ce face:
- --region eu-west-1: lucrezi în altă regiune (lecția 4);
- --output text | json | table | yaml: formatul răspunsului (lecția 9);
- --query '…': păstrezi doar o parte din răspuns (lecția 9);
- --profile ana: lucrezi cu alt utilizator (lecția 28).
Pentru ajutor scrii help la orice nivel: aws help (toate serviciile), aws s3 help (operațiile serviciului S3), aws ec2 describe-vpcs help (parametrii unei operații, cu exemple). Ieși din pagina de ajutor cu tasta q, ca la man din cursul de Linux.
Dacă scrii greșit o operație, CLI-ul îți arată lista operațiilor existente și îți propune varianta cea mai apropiată:
aws s3 lss
usage: aws [options] <command> <subcommand> [<subcommand> ...] [parameters] To see help text, you can run: aws help aws <command> help aws <command> <subcommand> help aws: error: argument operation: Invalid choice, valid choices are: cp | ls mb | mv presign | rb rm | sync website Invalid choice: 'lss', maybe you meant: * ls
Mesajele de eroare
Când AWS refuză o operație, răspunsul are mereu aceeași formă: An error occurred (CodulErorii) when calling the Operatie operation: explicația. Codul dintre paranteze este cel mai important: îl poți căuta în documentație. Un exemplu cu un nume de bucket invalid (cu majuscule și _):
aws s3 mb s3://Magazin_Ana
make_bucket failed: s3://Magazin_Ana An error occurred (InvalidBucketName) when calling the CreateBucket operation: The specified bucket is not valid.
InvalidBucketName: numele nu respectă regulile S3. Un alt exemplu, un ID care nu există:
aws ec2 describe-vpcs --vpc-ids vpc-123
An error occurred (InvalidVpcID.NotFound) when calling the DescribeVpcs operation: The vpc ID 'vpc-123' does not exist
În terminalul cursului, după fiecare eroare apare și o linie de indiciu în română (marcată cu „i”), cu un indiciu despre cauză. Ea nu există în AWS real: acolo vei avea doar mesajul în engleză, deci obișnuiește-te să citești întâi codul erorii. Alte coduri pe care le vei întâlni des: AccessDenied / UnauthorizedOperation (nu ai permisiunea), NoSuchEntity / NotFound (resursa nu există), AlreadyExists (numele e luat).
Greșeli frecvente
- O singură cratimă la parametri (-user-name): parametrii lungi au mereu două (--user-name).
- Spații în valori fără ghilimele: --description Site florarie trimite doar „Site”; scrie --description "Site florarie".
- **echo $? după altă comandă**: $? arată codul ultimei comenzi rulate. Dacă între timp ai rulat ls, vei vedea codul lui ls.
- Să nu citești eroarea: aproape întotdeauna, mesajul spune exact ce e greșit.
Exemple reale
Verifică $? după aws s3 cp; dacă nu e 0, trimite un email echipei.
Un programator citește aws lambda help, găsește operația potrivită și apoi aws lambda create-function help pentru parametri.
Un coleg îți trimite mesajul AccessDenied … s3:PutObject: din cod și operație știi imediat ce permisiune îi lipsește.
