...
Eroare AWS · Sintaxa comenzilor AWS CLI

Error parsing parameter '--body': Blob values must be a path to a file.

Pe scurt

La aws s3api put-object, --body primește calea unui fișier local, nu textul de pus în obiect. Scrie conținutul într-un fișier și dă --body fisier.txt, sau folosește aws s3 cp fisier.txt s3://bucket/cheie.

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

Ce înseamnă

Parametrii de tip blob (date binare) primesc la CLI calea unui fișier: CLI-ul deschide fișierul și trimite octeții lui. La aws s3api put-object, --body este un astfel de parametru. Când dai un text (--body "Paine 5 lei") sau o cale care nu există, CLI-ul nu găsește fișierul și se oprește cu Blob values must be a path to a file.

Apare des când treci de la aws s3 cp, care primește calea ca argument, la s3api, sau când încerci să scrii direct un text mic într-un obiect. Mai apare când calea e relativă și rulezi comanda din alt folder decât cel al fișierului.

Alți parametri blob: --zip-file la Lambda (acolo se scrie fileb://functie.zip) și --payload la lambda invoke. Mesajul apare înainte de cerere, deci în bucket nu s-a scris nimic.

De ce apare: cauzele frecvente

1Ai dat textul, nu fișierul

Greșit
BASH
aws s3api put-object --bucket preturi-magazin-2026 --key preturi.txt \
  --body "Paine 5 lei"
Corect
BASH
echo "Paine 5 lei" > preturi.txt
aws s3api put-object --bucket preturi-magazin-2026 --key preturi.txt \
  --body preturi.txt

--body citește conținutul din fișierul dat.

2Calea relativă nu e din folderul curent

Greșit
BASH
cd /tmp
aws s3api put-object --bucket preturi-magazin-2026 --key preturi.txt --body preturi.txt
Corect
BASH
aws s3api put-object --bucket preturi-magazin-2026 --key preturi.txt --body $HOME/preturi.txt

Calea relativă se caută în folderul curent. Cu o cale absolută, comanda merge de oriunde.

3Varianta mai simplă: aws s3 cp

Greșit
BASH
aws s3api put-object --bucket preturi-magazin-2026 --key preturi.txt --body "$TEXT"
Corect
BASH
echo "$TEXT" | aws s3 cp - s3://preturi-magazin-2026/preturi.txt

aws s3 cp - citește conținutul din intrarea standard, deci poți încărca text fără fișier intermediar.

Repară tu

Repară eroarea, direct în pagină

Scriptul ~/publica.sh trebuie să pună lista de prețuri Paine 5 lei în obiectul preturi.txt din bucket-ul preturi-magazin-2026, dar dă Blob values must be a path to a file. Repară scriptul ca să scrie textul într-un fișier și să-l încarce, apoi rulează-l.

Indiciu

Scrie textul în $HOME/preturi.txt cu echo, apoi dă --body $HOME/preturi.txt.

Alte forme ale mesajului

  • Error parsing parameter '--zip-file': Blob values must be a path to a file.

Cum o eviți pe viitor

  • Pentru încărcări obișnuite folosește aws s3 cp fisier s3://bucket/cheie: e mai simplu și face singur upload-ul pe bucăți la fișierele mari.
  • Folosește s3api put-object când ai nevoie de opțiuni speciale (metadate, --content-type, tag-uri), cu --body = calea fișierului.
  • În scripturi, folosește căi absolute ($HOME/preturi.txt), ca să nu depinzi de folderul curent.

Întrebări frecvente

De ce la --zip-file se scrie fileb:// și la --body nu?

--body e mereu tratat ca fișier, deci primește direct calea. La alți parametri (--zip-file, --policy-document) prefixul fileb:// (binar) sau file:// (text) îi spune CLI-ului să citească valoarea dintr-un fișier.

Pot pune un obiect gol?

Da: aws s3api put-object --bucket b --key folder/ fără --body creează un obiect gol, folosit de consolă ca „folder”.

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.