...
Eroare AWS · S3: bucket-uri, obiecte și acces public

An error occurred (MalformedPolicy) when calling the PutBucketPolicy operation: Policies must be valid JSON and the first byte must be '{'

Pe scurt

S3 a primit ca politică un text care nu începe cu {, de obicei chiar numele fișierului. Când dai politica dintr-un fișier, scrie --policy file://politica.json, nu --policy politica.json. Verifică și că fișierul conține JSON valid.

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

Ce înseamnă

put-bucket-policy trimite textul primit la --policy exact cum este. Dacă scrii --policy politica.json, CLI-ul nu citește fișierul: trimite literal textul „politica.json”. S3 verifică primul caracter, vede p în loc de { și răspunde cu MalformedPolicy.

Prefixul file:// îi spune CLI-ului să citească fișierul și să trimită conținutul lui. Același lucru e valabil la toți parametrii care primesc documente JSON: --policy-document, --change-batch, --lifecycle-configuration.

Eroarea apare și când fișierul începe cu altceva decât {: un BOM (caracter invizibil salvat de unele editoare în Windows), un comentariu, sau o politică pusă într-o listă [...]. Verifică primul caracter cu head -c 1 politica.json.

De ce apare: cauzele frecvente

1Lipsește file://

Greșit
BASH
aws s3api put-bucket-policy --bucket facturi-ana-2026 \
  --policy politica.json
Corect
BASH
aws s3api put-bucket-policy --bucket facturi-ana-2026 \
  --policy file://politica.json

Fără file://, CLI-ul trimite numele fișierului ca text. Cu prefixul, trimite conținutul.

2Politica pusă într-o listă

Greșit
BASH
[{"Version": "2012-10-17", "Statement": [ ... ]}]
Corect
BASH
{"Version": "2012-10-17", "Statement": [ ... ]}

Documentul trebuie să fie un obiect JSON, nu o listă.

3Variabilă goală în comandă

Greșit
BASH
aws s3api put-bucket-policy --bucket facturi-ana-2026 --policy "$POLITICA"
# $POLITICA nu a fost setată
Corect
BASH
POLITICA=$(cat politica.json)
aws s3api put-bucket-policy --bucket facturi-ana-2026 --policy "$POLITICA"

O variabilă nesetată trimite un text gol, care nici el nu începe cu {.

Repară tu

Repară eroarea, direct în pagină

Bucket-ul facturi-ana-2026 trebuie protejat cu politica din ~/politica.json, care interzice ștergerea facturilor. Scriptul ~/protejeaza.sh dă Policies must be valid JSON and the first byte must be '{'. Repară scriptul ca să trimită conținutul fișierului și rulează-l.

Indiciu

Scrie --policy file://$HOME/politica.json.

Alte forme ale mesajului

  • An error occurred (MalformedPolicy) when calling the PutBucketPolicy operation: Policy has invalid resource
  • An error occurred (MalformedPolicy) when calling the PutBucketPolicy operation: Policy has an invalid action
  • An error occurred (MalformedPolicyDocument) when calling the CreatePolicy operation: Syntax errors in policy.

Cum o eviți pe viitor

  • Scrie mereu file:// (sau fileb:// pentru fișiere binare) când parametrul primește un fișier.
  • Verifică fișierul înainte: jq . politica.json arată dacă JSON-ul este valid.
  • Salvează fișierele în UTF-8 fără BOM (în VS Code: bara de jos → encoding).
  • După aplicare, citește politica înapoi: aws s3api get-bucket-policy --bucket facturi-ana-2026.

Întrebări frecvente

De ce CLI-ul nu își dă seama că e un fișier?

Pentru că politica.json poate fi la fel de bine o valoare text. CLI-ul citește fișiere doar când vede prefixele file:// sau fileb://.

Ce diferență e între file:// și fileb://?

file:// citește fișierul ca text (pentru JSON, scripturi), fileb:// îl trimite ca octeți (pentru arhive zip, chei, imagini).

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.