...
Eroare AWS · Sintaxa comenzilor AWS CLI

aws: error: the following arguments are required: --bucket

Pe scurt

Comanda are nevoie de un parametru obligatoriu pe care nu l-ai dat, aici --bucket (numele bucket-ului). Adaugă parametrul cu valoarea lui, de exemplu --bucket documente-firma-2026, și rulează din nou.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Fiecare operație AWS are parametri obligatorii. Comenzile aws s3api lucrează direct cu API-ul S3, deci cer numele bucket-ului ca parametru separat, --bucket nume, nu ca adresă s3://nume cum fac comenzile de nivel înalt aws s3. Mesajul the following arguments are required: --bucket arată exact ce lipsește; dacă lipsesc mai mulți, apar toți, separați prin virgulă.

Apare des când copiezi un exemplu din documentație și ștergi din greșeală o linie, când o variabilă de shell e goală (--bucket $BUCKET cu BUCKET nedefinit, deci CLI-ul vede --bucket urmat de următorul parametru), sau când amesteci sintaxa aws s3 cu aws s3api.

Ca toate erorile de sintaxă, are codul de ieșire 252 și nu ajunge la AWS: nimic nu s-a modificat în cont.

De ce apare: cauzele frecvente

1Parametrul lipsește complet

Greșit
BASH
aws s3api put-bucket-versioning --versioning-configuration Status=Enabled
Corect
BASH
aws s3api put-bucket-versioning --bucket documente-firma-2026 --versioning-configuration Status=Enabled

API-ul trebuie să știe pe ce bucket aplică setarea; fără --bucket cererea nu se poate construi.

2Sintaxa aws s3 folosită la s3api

Greșit
BASH
aws s3api get-bucket-versioning s3://documente-firma-2026
Corect
BASH
aws s3api get-bucket-versioning --bucket documente-firma-2026

s3api nu acceptă adrese s3://; numele merge în --bucket, fără prefix.

3Variabilă de shell goală

Greșit
BASH
aws s3api put-bucket-versioning --bucket $BUCKET --versioning-configuration Status=Enabled
# BUCKET nu e setat
Corect
BASH
BUCKET=documente-firma-2026
aws s3api put-bucket-versioning --bucket "$BUCKET" --versioning-configuration Status=Enabled

Cu variabila goală, --bucket rămâne fără valoare. Pune variabilele între ghilimele și setează-le înainte.

Repară tu

Repară eroarea, direct în pagină

Scriptul ~/versionare.sh trebuie să activeze versionarea pe bucket-ul documente-firma-2026, dar dă aws: error: the following arguments are required: --bucket. Repară scriptul și rulează-l, astfel încât versionarea bucket-ului să fie Enabled.

Indiciu

aws s3api cere numele bucket-ului în --bucket, fără prefixul s3://.

Alte forme ale mesajului

  • aws: error: the following arguments are required: --bucket, --key
  • aws: error: the following arguments are required: --instance-ids
  • aws: error: the following arguments are required: --public-access-block-configuration
  • aws: error: argument --bucket: expected one argument

Cum o eviți pe viitor

  • Verifică parametrii obligatorii cu aws s3api <operație> help (secțiunea SYNOPSIS: cei fără paranteze drepte sunt obligatorii).
  • În scripturi pune variabilele între ghilimele și adaugă set -u, ca o variabilă nedefinită să oprească scriptul.
  • Reține diferența: aws s3 folosește s3://bucket/cheie, aws s3api folosește --bucket și --key.

Întrebări frecvente

De ce aws s3 ls s3://bucket merge, dar s3api vrea --bucket?

aws s3 e un set de comenzi de nivel înalt, gândit pentru fișiere, care înțelege adrese s3://. aws s3api expune operațiile API una câte una, cu parametrii lor exacți.

Cum văd toți parametrii unei operații?

aws s3api put-bucket-versioning help sau --generate-cli-skeleton, care afișează un JSON cu toți parametrii posibili.

Erori înrudite

← Toate erorile AWS

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață AWS de la zero, cu exerciții la fiecare lecție

Curs Cloud: AWS fundamentals: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.