Oddiy AccessKey API

Engil vaznli GET, HEAD, PUT va DELETE soʻrovlaridan S3 SDKsiz foydalaning.

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

GET

Ob'ektni yuklab oling. Keyingi chiziq yoki zona ildizi JSON katalog ro'yxatini qaytaradi.

HEAD

Ob'ektni tekshiring yoki javob organisiz katalog ro'yxatini tekshiring.

PUT

Xom so'rov tanasidan bitta ob'ektni yarating yoki almashtiring.

DELETE

To'liq ob'ekt kalitini o'chiring. Kataloglar rekursiv ravishda o'chirilmaydi.

cURL misollar

PUT
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'
GET
curl --request GET \
  --url https://storage.acdn.uz/<bucket>/backups/archive.tar \
  --header 'AccessKey: <api-key>' \
  --output archive.tar
DELETE
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.