Autentifikatsiya va URL formati
Oddiy API S3 SDK kerak bo'lmaganda foydali bo'ladi. AccessKey sarlavhasida API zonasi kalitini yuboring va URL-ga zona nomi va obyekt kalitini qo'ying.
- Yakuniy nuqta formati: https://storage.acdn.uz/{storageZoneName}/{objectKey}.
- AccessKey qiymati S3 kirish kaliti ID va maxfiydan farq qiladi.
- Brauzerni yuklab olish havolalari uchun accessKey so'rovlar qatorida uzatilishi mumkin, chunki langarlar sarlavhani biriktira olmaydi.
- PUT uchun soʻrov tanasi JSON, base64 yoki koʻp qismli/forma maʼlumotlarini emas, balki xom baytlarni oʻz ichiga oladi.
Qo'llab-quvvatlanadigan operatsiyalar
Ob'ektni yuklab oling. Keyingi chiziq yoki zona ildizi JSON katalog ro'yxatini qaytaradi.
Ob'ektni tekshiring yoki javob organisiz katalog ro'yxatini tekshiring.
Xom so'rov tanasidan bitta ob'ektni yarating yoki almashtiring.
To'liq ob'ekt kalitini o'chiring. Kataloglar rekursiv ravishda o'chirilmaydi.
cURL misollar
curl --request PUT \
--url https://storage.acdn.uz/<bucket>/backups/archive.tar \
--header 'AccessKey: <api-key>' \
--header 'Content-Type: application/octet-stream' \
--data-binary '@/absolute/path/to/archive.tar'
curl --request GET \
--url https://storage.acdn.uz/<bucket>/backups/archive.tar \
--header 'AccessKey: <api-key>' \
--output archive.tar
curl --request DELETE \
--url https://storage.acdn.uz/<bucket>/backups/archive.tar \
--header 'AccessKey: <api-key>'
Javoblar va xatolar
- Muvaffaqiyatli PUT 201 ta yaratilgan; muvaffaqiyatli DELETE 200 OK qaytaradi.
- Ro'yxatlar JSON dan foydalanadi. Ob'ektni o'qishlari saqlangan kontent turini va baytlarni qaytaradi.
- Oddiy API xatolar oddiy HTTP matnli javoblardir. XML xato hujjatlari imzolangan S3 so‘rovlari uchun ajratilgan.