Amazon S3 API
HostArena S3 Storage je u potpunosti kompatibilan sa Amazon S3 API standardom, što omogućava jednostavnu integraciju sa postojećim aplikacijama, servisima i alatima koji podržavaju S3.
Šta je potrebno?
Pripremite sledeće podatke iz korisničkog panela:
-
Endpoint
-
Access Key
-
Secret Key
-
Naziv Bucket-a
Primer:
| Polje | Primer |
|---|---|
| Endpoint | https://username.s3.hostarena.rs |
| Bucket | username |
| Access Key | Dostupan u panelu |
| Secret Key | Dostupan u panelu |
| Region | us-east-1 |
Endpoint
Sve aplikacije treba da koriste vaš jedinstveni Endpoint:
https://username.s3.hostarena.rs
Autentifikacija
Koristite standardni AWS Signature Version 4 (SigV4) način autentifikacije.
Potrebni podaci:
-
Access Key
-
Secret Key
Region
Koristite:
us-east-1
Primer URL-a objekta
https://username.s3.hostarena.rs/username/example.jpg
Podržane operacije
HostArena S3 Storage podržava standardne S3 operacije:
-
Create Bucket*
-
List Bucket
-
Upload Object
-
Download Object
-
Delete Object
-
Copy Object
-
List Objects
-
Multipart Upload
-
Presigned URL
-
Object Metadata
*Podrazumevani Bucket se automatski kreira prilikom aktivacije naloga, tako da kreiranje Bucket-a u većini slučajeva nije potrebno.
Primer HTTP zahteva
Upload objekta:
PUT /username/example.txt HTTP/1.1
Host: username.s3.hostarena.rs
Authorization: AWS4-HMAC-SHA256 ...
Content-Length: 1234
MIME tipovi
Prilikom otpremanja objekata preporučuje se postavljanje odgovarajućeg Content-Type zaglavlja, na primer:
-
image/jpeg -
image/png -
application/pdf -
text/plain -
application/json
Presigned URL
Možete generisati privremene URL adrese za:
-
preuzimanje fajlova
-
upload fajlova
-
deljenje sadržaja sa drugim korisnicima
Trajanje URL-a određuje aplikacija koja ga generiše.
Multipart Upload
Za velike fajlove preporučuje se korišćenje Multipart Upload funkcije.
Prednosti:
-
brži upload
-
nastavak prekinutog prenosa
-
bolja pouzdanost kod velikih fajlova
Najčešći HTTP kodovi
| Kod | Opis |
|---|---|
| 200 | Uspešno izvršeno |
| 201 | Objekat kreiran |
| 204 | Objekat obrisan |
| 400 | Neispravan zahtev |
| 403 | Neispravni pristupni podaci |
| 404 | Bucket ili objekat nije pronađen |
| 409 | Konflikt zahteva |
| 500 | Greška servera |
Najčešći problemi
SignatureDoesNotMatch
Proverite da aplikacija koristi AWS Signature Version 4.
InvalidAccessKeyId
Proverite Access Key.
AccessDenied
Proverite Secret Key i dozvole.
Could not connect
Proverite da li koristite:
https://username.s3.hostarena.rs
SSL greška
Koristite HTTPS i proverite da sistem dozvoljava izlazne konekcije na port 443.
