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

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
BucataExempluCe înseamnă
awsawsprogramul AWS CLI
serviciulec2, s3, iam, stscu ce serviciu vorbești
operațiadescribe-vpcs, create-userce îi ceri serviciului; de obicei un verb + un substantiv
parametrii--user-name anadetaliile 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.

CodCând
0comanda a reușit
1o comandă aws s3 … (mb, cp, sync, rb) a eșuat
252comanda e scrisă greșit (operație sau parametru inexistent)
254comanda e corectă, dar AWS a refuzat-o (eroare de serviciu: resursă inexistentă, lipsă de permisiuni)
255altă 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ă.

Exercițiul tău

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).
Pentru primul fișier: aws ec2 describe-vpcs > ~/vpcs.json. Pentru al doilea, echo $? trebuie să fie chiar următoarea comandă după aws s3 mb.

Soluția exercițiului

aws ec2 describe-vpcs > ~/vpcs.json
aws s3 mb s3://Magazin_Ana
echo $? > ~/cod.txt
Excelent! Continuă cu lecția următoare →
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
Indiciile simulatorului

Î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

Un script de backup

Verifică $? după aws s3 cp; dacă nu e 0, trimite un email echipei.

Un serviciu nou

Un programator citește aws lambda help, găsește operația potrivită și apoi aws lambda create-function help pentru parametri.

Depanare

Un coleg îți trimite mesajul AccessDenied … s3:PutObject: din cod și operație știi imediat ce permisiune îi lipsește.

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 8 · Structura unei comenzi AWS CLI
Progres 0% 0 din 17
Lecția curentă 8 / 15 Aws cli