Aksungur Storage

Dokümanlar

Dosya yüklemek, yayınlamak ve kendi alan adını bağlamak için bilmen gereken her şey. Örnekler bu kurulumun gerçek adreslerini kullanır.

Kavramlar

Aksungur Storage beş kavram üzerine kuruludur:

KavramNe işe yarar
EkipBir müşterinin çalışma alanı. Bucket’lar, alan adları, anahtarlar ve üyeler ekibe aittir; ekipler birbirinin verisini göremez.
BucketDosyaları bir arada tutan ve kendi adresinden yayınlanan klasör. Adı tüm platformda tektir, çünkü adresin parçasıdır.
DosyaBir anahtar (gorseller/logo.png gibi bir yol) ve içeriği. Klasörler anahtarın “/” ile ayrılan parçalarıdır.
Alan adıBir bucket’ı kendi adresinden yayınlamak için bağladığın, sana ait alan adı.
TokenToken koruması açık olan dosyaları açan anahtar. Yalnızca okur; dosyaları listeleyemez, yükleyemez, silemez.

Hızlı başlangıç

  1. Konsola giriş yap. Hesabın yoksa platform yöneticisinden iste; dışarıdan kayıt kapalıdır.
  2. Bucket’lar sayfasında Bucket ekle’ye bas ve bir ad ver, örneğin urunler.
  3. Bucket’ı aç ve dosyalarını pencereye sürükle. Klasör bırakırsan yapısı korunur.
  4. Dosyan yayında: https://urunler.edge.ornek.com/dosya-adi.png

Aynı işlemleri koddan yapmak için bir erişim anahtarı oluştur ve yükleme isteğini kullan.

Kimlik doğrulama

Programlar API’ye erişim anahtarı ile bağlanır. Anahtarı konsolda Erişim anahtarları sayfasından oluşturursun; tamamı yalnızca oluşturulduğu an gösterilir, sunucuda sadece özeti saklanır.

Her istekte anahtarı Authorization başlığında gönder:

HTTP başlığı
Authorization: Bearer aks_xxxxxxxxxxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

İzinler

İzinNeye izin verir
readBucket’ları ve dosyaları listeler, indirir, süreli bağlantı oluşturur.
writeDosya yükler ve var olan dosyaların üzerine yazar.
deleteDosyaları siler.

Bir anahtarı tek bir bucket’a kısıtlayabilir, geçerlilik süresi verebilir ve istediğin an iptal edebilirsin. İptal anında geçerli olur. Anahtarlar üye, alan adı ya da anahtar yönetemez; bunlar yalnızca konsoldan yapılır.

Klasöre sınırlı anahtar

Anahtarı oluştururken bir klasör yazarsan (örneğin musteri-42/) anahtar yalnızca o klasörün içindeki dosyaları görür, yazar ve siler. Bir müşteriye ya da bir alt sisteme, bucket’ın tamamını açmadan anahtar vermek için kullanılır.

  • Klasörün dışındaki her işlem 403 ve key_prefix koduyla reddedilir: okuma, yükleme, silme, süreli bağlantı, parçalı yükleme ve sürüm geçmişi.
  • Listeleme klasörle daraltılır; anahtar klasörün üstünü listeleyemez.
  • Sınır S3 uyumlu API’de de aynıdır. Bucket’ın tamamını anlatan istatistik ve erişim kayıtları bu anahtarlara kapalıdır.

Dosya yükleme

Dosyanın içeriğini isteğin gövdesi olarak, olduğu gibi gönder. Çok parçalı form (multipart) kullanılmaz; gövde belleğe alınmadan doğrudan diske akar.

Terminal
curl -X PUT \
  -H "Authorization: Bearer $AKS_KEY" \
  -H "Content-Type: image/png" \
  --data-binary @logo.png \
  https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/objects/gorseller/logo.png
Yanıt, 201 Created
{
  "object": {
    "key": "gorseller/logo.png",
    "size": 48213,
    "contentType": "image/png",
    "etag": "487ee0710bcce86df221bf684cfd44db",
    "cacheControl": null,
    "createdAt": "2026-11-16T19:39:53.369Z",
    "updatedAt": "2026-11-16T19:39:53.369Z"
  }
}
  • Aynı anahtara yapılan yükleme dosyanın üzerine yazar ve 200 döner.
  • Content-Type göndermezsen tür dosya uzantısından belirlenir.
  • Tek istekle en fazla 5 GB gönderilir; daha büyük dosyalar ve kararsız bağlantılar için parçalı yüklemeyi kullan.
  • Dosyaya özel önbellek süresi vermek için X-Cache-Control başlığını ekle, örneğin public, max-age=31536000, immutable.
  • Anahtar en fazla 1024 bayt olabilir; / ile başlayamaz ya da bitemez, .. ve // içeremez. Türkçe karakter ve boşluk kullanabilirsin; adreste yüzde kodlamasıyla gönder.

Node.js

upload.mjs
import { readFile } from 'node:fs/promises'

const upload = async (key, path, contentType) => {
  const response = await fetch(`https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/objects/${key}`, {
    method: 'PUT',
    headers: { authorization: `Bearer ${process.env.AKS_KEY}`, 'content-type': contentType },
    body: await readFile(path),
  })
  if (!response.ok) throw new Error((await response.json()).error.message)
  return (await response.json()).object
}

console.log(await upload('gorseller/logo.png', './logo.png', 'image/png'))

Üst veri ve başlıklar

Dosyayı yüklerken ona kendi etiketlerini ekleyebilir ve tarayıcıya nasıl sunulacağını belirleyebilirsin. Bunlar dosyayla birlikte saklanır ve dosya bilgisinde geri döner.

BaşlıkS3’teki karşılığıNe işe yarar
X-Meta-<ad>x-amz-meta-<ad>Serbest etiket: sipariş numarası, yükleyen, kaynak. En fazla 32 adet ve toplam 2 KB.
X-Content-DispositionContent-DispositionTarayıcının dosyayı hangi adla indireceği ya da sayfada gösterip göstermeyeceği.
X-Content-EncodingContent-EncodingÖnceden gzip ya da br ile sıkıştırılmış dosyanın tarayıcıda açılması.
Terminal
curl -X PUT \
  -H "Authorization: Bearer $AKS_KEY" \
  -H "Content-Type: application/pdf" \
  -H "X-Meta-Siparis: 10482" \
  -H 'X-Content-Disposition: attachment; filename="fatura-10482.pdf"' \
  --data-binary @fatura.pdf \
  https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/objects/faturalar/10482.pdf
  • Etiketler dosya bilgisinde metadata alanında, S3’te x-amz-meta-* başlıklarında geri döner. Adlar küçük harfe çevrilir.
  • Content-Disposition ve Content-Encoding dosyanın yayın adresindeki yanıta da yazılır.
  • Dosyanın üzerine yazıldığında etiketler yenileriyle değişir; eskiler yeni içeriğe geçmez. Geri yüklenen sürüm kendi etiketleriyle döner.
  • Parçalı yüklemede aynı bilgiler yüklemeyi başlatan isteğin gövdesinde verilir: metadata, contentDisposition, contentEncoding.

Büyük dosyalar

Büyük bir dosyayı tek istekle göndermek kırılgandır: bağlantı %90’da koparsa baştan başlarsın. Parçalı yüklemede dosya numaralı parçalara bölünür, parçalar istediğin sırayla ve aynı anda birkaçı birden gönderilir, kopan bağlantı yalnızca o parçaya mal olur. Konsol 16 MB üzerindeki dosyalarda bunu kendiliğinden yapar; yarım kalan yükleme aynı dosyayı yeniden seçtiğinde kaldığı yerden sürer.

1. Yüklemeyi başlat
curl -X POST -H "Authorization: Bearer $AKS_KEY" -H "Content-Type: application/json" \
  -d '{"key": "video/tanitim.mp4", "size": 734003200, "contentType": "video/mp4"}' \
  https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/uploads
# → { "upload": { "id": "upl_…", "partSize": 8388608, "partCount": 88, "parts": [] } }
2. Parçaları gönder (sırası önemli değil, birkaçını aynı anda gönderebilirsin)
curl -X PUT -H "Authorization: Bearer $AKS_KEY" --data-binary @parca-001 \
  https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/uploads/upl_…/parts/1
3. Parçaları birleştir
curl -X POST -H "Authorization: Bearer $AKS_KEY" \
  https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/uploads/upl_…/complete
  • Yarım kalan bir yüklemede hangi parçaların ulaştığını GET …/uploads/upl_… söyler; yalnızca eksikleri gönderip tamamlarsın. Aynı numarayı yeniden göndermek o parçayı değiştirir.
  • Bir dosya en fazla 100 GB ve 10.000 parça olabilir. Önerilen parça boyutu 8 MB; her parça yanıtında o parçanın SHA-256 özeti döner.
  • Dosya, tamamlanana kadar görünmez. Vazgeçersen DELETE …/uploads/upl_… ile alanı hemen boşaltırsın; hiç dokunulmayan yüklemeler 7 gün sonra kendiliğinden silinir.

Tarayıcıdan yükleme

Ziyaretçilerinin yüklediği dosyaların önce senin sunucuna, oradan depolamaya gitmesi gerekmez. Sunucun erişim anahtarıyla süreli bir yükleme bağlantısı ister ve sayfaya verir; tarayıcı dosyayı doğrudan depolamaya gönderir. Bağlantı yalnızca yüklemeye yarar: listeleyemez, okuyamaz, silemez.

Sunucunda: bağlantıyı iste
curl -X POST -H "Authorization: Bearer $AKS_KEY" -H "Content-Type: application/json" \
  -d '{"prefix": "gelen/kullanici-42/", "maxBytes": 10485760, "contentTypes": ["image/*"], "expiresIn": 600}' \
  https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/upload-links
# → { "url": "https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/objects/gelen/kullanici-42/{name}?token=aku_…", "multipartUrl": "…", "expiresAt": "…" }
Tarayıcıda: dosyayı gönder
const yukle = async (dosya, url) => {
  const yanit = await fetch(url.replace('{name}', encodeURIComponent(dosya.name)), {
    method: 'PUT',
    headers: { 'content-type': dosya.type },
    body: dosya,
  })
  if (!yanit.ok) throw new Error((await yanit.json()).error.message)
  return (await yanit.json()).object
}
AlanAnlamı
keyBağlantı yalnızca bu tek dosya adına izin verir (profil fotoğrafı gibi). Aynı bağlantıyla yeniden yüklemek dosyayı değiştirir.
prefixBağlantı bir klasöre izin verir; dosyanın adını tarayıcı seçer. Var olan dosyanın üzerine yazılmaz (overwrite: true verirsen yazılır).
maxBytesDosya boyutu sınırı. Vermezsen 100 MB.
contentTypesİzin verilen türler: image/png ya da image/* gibi. Tür tarayıcının bildirdiği değerdir; içeriği ayrıca doğrulamak istersen webhook ile haberdar ol.
expiresInSaniye cinsinden geçerlilik, en fazla 7 gün. Bağlantılar iptal edilemez; kısa tut.
access, cacheControlDosyanın nasıl saklanacağını bağlantı belirler; yükleyenin gönderdiği başlıklar dikkate alınmaz.

Büyük dosyalar için aynı bağlantı parçalı yüklemeyi de açar: yanıttaki multipartUrl adresine { key, size } göndererek başlat, parçaları ve tamamlama isteğini aynı ?token= ile gönder.

Listeleme ve silme

Dosyalar anahtara göre sıralı listelenir. delimiter=/ verirsen bir alt klasördeki dosyalar tek bir prefixes girdisine toplanır; konsoldaki klasör görünümü böyle çalışır.

Terminal
curl -H "Authorization: Bearer $AKS_KEY" \
  "https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/objects?prefix=gorseller/&delimiter=/&limit=100"
Yanıt
{
  "prefixes": ["gorseller/2026/"],
  "objects": [{ "key": "gorseller/logo.png", "size": 48213, "contentType": "image/png", "…": "…" }],
  "nextCursor": null
}

nextCursor doluysa devamını almak için aynı isteği cursor parametresiyle tekrarla. limit en fazla 1000’dir.

Silme

Terminal
# Tek dosya
curl -X DELETE -H "Authorization: Bearer $AKS_KEY" \
  https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/objects/gorseller/logo.png

# Birden çok dosya ya da bir klasörün tamamı
curl -X POST -H "Authorization: Bearer $AKS_KEY" -H "Content-Type: application/json" \
  -d '{"keys": ["a.png", "b.png"]}' \
  https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/delete

Bir klasörü içindekilerle silmek için keys yerine {"prefix": "gorseller/2025/"} gönder. Silinen dosyanın adresi anında çalışmaz hale gelir.

Dosyaları yayınlama

Bir bucket’taki her dosyanın bir adresi vardır. Token koruması kapalıysa bu adres herkese açıktır:

Adres
https://urunler.edge.ornek.com/gorseller/logo.png

Dağıtım sunucusu tarayıcıların ve ara sunucuların beklediği HTTP davranışlarını eksiksiz uygular:

ÖzellikDavranış
ETagİçeriğin özetinden üretilir. If-None-Match eşleşirse gövdesiz 304 döner.
Cache-ControlBucket ayarından gelir (varsayılan 1 saat); dosyaya özel değer verilmişse o kullanılır.
RangeParçalı indirme ve video sarma için 206 Partial Content desteklenir.
CORSDosyalar her kaynaktan okunabilir (Access-Control-Allow-Origin: *); korumalı dosyalar için Authorization başlığına da izin verilir.
Dizin belgesi/ ile biten adreslerde bucket’ın dizin belgesi (varsayılan index.html) sunulur; bucket’ı statik site olarak kullanabilirsin.
Kök adresKök adreste (/) gösterilecek bir dizin belgesi yoksa Aksungur Storage’ı tanıtan kısa bir sayfa çıkar. Sayfa noindex işaretlidir, arama sonuçlarına girmez; dosyaların kendisi dizine eklenebilir.
?download=1Dosyayı tarayıcıda açmak yerine indirtir.

Bir dosyayı değiştirdiğinde ya da sildiğinde sunucu tarafındaki önbellek anında yenilenir. Tarayıcıdaki kopya ise Cache-Control süresi dolana kadar kalabilir; sık değişen dosyalarda kısa süre, adında sürüm bulunan dosyalarda (app.3f9a.js) uzun süre kullan.

Token koruması

Bir bucket’ın dosyaları, sen aksini söylemedikçe adresini bilen herkese açıktır. Bucket’ın Token koruması sekmesindeki anahtarı açtığında dosyalar yalnızca bir token ya da süreli bağlantı taşıyan isteklere verilir. Anahtar tek dokunuşla açılıp kapanır ve değişiklik anında geçerli olur.

Token

Tokenlar konsolda oluşturulur, akt_ ile başlar ve yalnızca oluşturulduğu anda gösterilir. Bir token dosyaları yalnızca okur; bu yüzden uygulamana ya da sitene gömebilirsin. İstersen tek bir klasörle sınırlayabilir, bitiş süresi verebilirsin. Sildiğin token o an çalışmayı bırakır.

Adreste
https://urunler.edge.ornek.com/gorseller/logo.png?token=akt_…
Başlıkta
curl -H "Authorization: Bearer akt_…" \
  https://urunler.edge.ornek.com/gorseller/logo.png
DurumYanıt
Token ya da süreli bağlantı yok, geçersiz ya da süresi dolmuş403 Forbidden. Dosyanın var olup olmadığı da belli olmaz.
Token başka bir bucket’a ya da başka bir klasöre ait403 Forbidden
Geçerli tokenDosya, Cache-Control: private, max-age=0, must-revalidate ile. Ortak önbellekler saklamaz, tarayıcı her seferinde doğrular.

Adrese eklenen token, adresi gören herkesin eline geçer. Sunucudan yaptığın isteklerde başlığı kullan; herkese açık bir sayfada tek bir dosya paylaşacaksan süreli bağlantıyı tercih et.

Dosya bazında istisna

Tek bir dosyayı bucket’ın ayarından ayırabilirsin: korumalı bir bucket’ta herkese açık bir dosya ya da açık bir bucket’ta korumalı bir dosya. Konsolda dosyanın ayrıntılarındaki Erişim seçiminden, API’de yüklerken X-Access başlığıyla ya da sonradan PATCH ile yapılır. Dosyanın üzerine yazmak seçimi değiştirmez.

Yüklerken
curl -X PUT \
  -H "Authorization: Bearer $AKS_KEY" \
  -H "X-Access: protected" \
  --data-binary @2026-11.pdf \
  https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/objects/faturalar/2026-11.pdf
Sonradan: public, protected ya da bucket ayarına dönmek için null
curl -X PATCH \
  -H "Authorization: Bearer $AKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"access": "public"}' \
  https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/objects/gorseller/logo.png

Süreli bağlantı

Süreli bağlantı tek bir dosya içindir, token gerektirmez ve süresi dolunca kendiliğinden kapanır. Konsolda dosyanın ayrıntılarından ya da API ile oluşturulur:

Terminal
curl -X POST -H "Authorization: Bearer $AKS_KEY" -H "Content-Type: application/json" \
  -d '{"key": "faturalar/2026-11.pdf", "expiresIn": 3600}' \
  https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/presign
Yanıt
{
  "url": "https://urunler.edge.ornek.com/faturalar/2026-11.pdf?expires=1794860000&signature=…",
  "expiresAt": "2026-11-16T21:00:00.000Z"
}

expiresIn saniye cinsindendir, en fazla 7 gün (604800) olabilir.

Görsel dönüştürme

Bucket ayarlarında Görsel dönüştürme açıkken, bir görselin adresine eklediğin parametreler boyutlandırılmış ve yeniden kodlanmış bir kopya döndürür. Kopya ilk istekte üretilir, sonrakilerde önbellekten gelir; özgün dosya değişmez.

400 piksel genişlik, tarayıcının desteklediği en iyi biçim
https://urunler.edge.ornek.com/gorseller/urun.jpg?w=400&format=auto
ParametreDeğerAnlamı
w, h1 – 4096En fazla genişlik ve yükseklik. Biri verilirse oran korunur. Görsel hiçbir zaman büyütülmez.
fitinside (varsayılan), cover, containKutuya sığdır; kutuyu doldurup taşanı kırp; kutuya sığdırıp boşluğu saydam bırak.
formatauto, webp, avif, jpeg, pngauto tarayıcının kabul ettiği en küçük biçimi seçer (AVIF, yoksa WebP, yoksa özgün).
q1 – 100 (varsayılan 80)Sıkıştırma kalitesi.

JPEG, PNG, WebP, AVIF ve TIFF dönüştürülür; GIF’in ilk karesi alınır. Fotoğrafın yönü düzeltilir, konum gibi üst veriler kopyaya taşınmaz. 50 MB’tan büyük görseller ve görsel olmayan dosyalar olduğu gibi sunulur. Token korumalı görsellerin kopyaları da token ister.

Çöp kutusu ve sürümler

Yeni bucket’lar silinen ve üzerine yazılan dosyaları 7 gün saklar (süre bucket ayarlarından değişir ya da kapatılır). Bu sürede konsolun Geçmiş sekmesinden ya da API ile dosyayı geri yükleyebilir, eski bir sürümüne dönebilirsin. Saklanan içerik depolama alanından sayılır.

Terminal
# Bir dosyanın önceki sürümleri (reason=deleted ile yalnızca silinenler)
curl -H "Authorization: Bearer $AKS_KEY" "https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/versions?key=gorseller/logo.png"

# Sürümü yeniden geçerli yap; o anki içerik de geçmişe eklenir
curl -X POST -H "Authorization: Bearer $AKS_KEY" https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/versions/ver_…/restore

Yaşam döngüsü kuralları

Bucket ayarlarında bir klasör için “N gün sonra sil” kuralı tanımlayabilirsin. Kural, dosyanın son yazıldığı günü esas alır ve saatte bir uygulanır. Kuralın sildiği dosyalar çöp kutusuna uğramaz: amaç alanı boşaltmaktır.

Webhook

Konsolda Webhook’lar sayfasından bir adres eklediğinde, seçtiğin olaylar o adrese POST ile JSON olarak gönderilir. Adresin 10 saniye içinde 2xx yanıt vermezse gönderim 30 saniye, 2 dakika, 10 dakika, 1 saat ve 6 saat sonra yeniden denenir.

object.created
{
  "id": "evt_8k2n…",
  "type": "object.created",
  "createdAt": "2026-11-17T10:42:07.120Z",
  "team": { "id": "mer_…" },
  "bucket": { "id": "bkt_…", "name": "urunler" },
  "object": { "key": "gorseller/logo.png", "size": 48213, "contentType": "image/png", "etag": "487ee071…", "url": "https://urunler.edge.ornek.com/gorseller/logo.png" },
  "replaced": false
}
OlayNe zamanEk alanlar
object.createdDosya yüklendiğinde ya da üzerine yazıldığında.replaced
object.deletedDosya silindiğinde.reason: deleted ya da expired (yaşam döngüsü); permanent: çöp kutusuna gitmediyse true
object.restoredDosya çöp kutusundan ya da eski bir sürümden geri getirildiğinde.

Her gönderim, webhook’u eklerken bir kez gösterilen anahtarla imzalanır. X-Aksungur-Signature başlığı v1= ile başlar ve HMAC-SHA256(anahtar, zaman + "." + gövde) değeridir; zaman X-Aksungur-Timestamp başlığındadır. İmzayı ham gövde üzerinden doğrula ve 5 dakikadan eski gönderimleri reddet. Aynı olay nadiren iki kez gelebilir; tekrarları id ile ayıkla.

İstatistik ve kayıtlar

Bucket’ın İstatistik sekmesi ziyaretçilerin ne yaptığını gösterir: günlük istek ve çıkan veri, reddedilen ve bulunamayan istekler, en çok istenen dosyalar, ziyaretçilerin geldiği siteler ve var olmayan adresler. Aynı veriyi API’den de alabilirsin.

Terminal
# Son 30 gün (days = 7, 30 ya da 90)
curl -H "Authorization: Bearer $AKS_KEY" "https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/stats?days=30"
  • Günler UTC’ye göre sayılır; rakamlar birkaç saniye gecikmeyle güncellenir.
  • En çok istenenler, gelinen siteler ve bulunamayan adresler yaklaşık listelerdir: çok sayıda farklı adres istendiğinde yalnızca en yoğun olanlar sayılır. Listeler 35 gün saklanır.
  • API ve S3 üzerinden yapılan indirme ve yüklemeler de toplam trafiğe girer.

Erişim kayıtları

İstatistik sekmesindeki anahtarı açtığında bucket’a gelen her istek bir satır olarak tutulur: zaman, dosya, durum kodu, gönderilen bayt, IP adresi, isteğin geldiği sayfa ve tarayıcı bilgisi. Satırlar 7 gün sonra kendiliğinden silinir.

Kayıtlar ziyaretçilerin IP adresini içerdiği için yalnızca bucket’ı yönetebilen ekip üyeleri görebilir; erişim anahtarlarıyla okunamaz. Token ve imza gibi adres parametreleri kaydedilmez. IP adresi kişisel veridir: kayıtları açıyorsan gizlilik metninde belirtmen gerekir.

Aylık kullanım

Ekip ayarlarındaki Kullanım sekmesi son on iki ayı gösterir: ortalama ve en yüksek depolama, çıkan trafik, istek sayısı ve yüklenen veri. Depolama saatte bir ölçülür; ortalama, ay içindeki ölçümlerin ortalamasıdır.

Özel alan adı

Bir bucket’ı kendi alan adından yayınlamak için konsolda Alan adları sayfasından alan adını ekle. Sana iki DNS kaydı gösterilir:

TürAdDeğerAmaç
TXT_aksungur.cdn.ornek.comaksungur-verify=…Alan adının sana ait olduğunu kanıtlar.
CNAMEcdn.ornek.comedge.ornek.comİstekleri dağıtım sunucusuna yönlendirir.
  1. Kayıtları alan adının DNS yönetim paneline gir.
  2. Kayıtlar düzenli olarak denetlenir; beklemek istemezsen Şimdi denetle’ye bas. İkisi de bulunduğunda alan adı doğrulanır.
  3. Alan adını bir bucket’a bağla. SSL sertifikası o adrese gelen ilk istekte otomatik alınır.

Kök alan adlarında (ornek.com) CNAME kullanılamaz. DNS sağlayıcının ALIAS ya da ANAME kaydını kullan; denetim, alan adının dağıtım sunucusuyla aynı IP adreslerine çözülmesini yeterli sayar. Sertifika yalnızca doğrulanmış ve bir bucket’a bağlı alan adları için alınır.

S3 uyumlu API

Aksungur Storage, Amazon S3’ün dosya işlemlerini aynı protokolle konuşur: aws-cli, rclone, S3 SDK’ları ve S3 destekleyen eklentiler değişiklik gerektirmeden çalışır. Kimlik olarak konsolda oluşturduğun erişim anahtarı kullanılır; anahtar oluşturulurken S3 alanları ayrıca gösterilir.

AyarDeğer
EndpointBu kurulumda yayınlanmamış; yöneticine sor.
Regionus-east-1
Access Key IDErişim anahtarının aks_ sonrasındaki 20 karakteri
Secret Access KeyErişim anahtarının sonraki alt çizgiden sonraki bölümü
AdreslemePath style (forcePathStyle: true, addressing_style = path)
aws-cli
aws configure set aws_access_key_id <Access Key ID>
aws configure set aws_secret_access_key <Secret Access Key>
aws --endpoint-url https://s3.ornek.com s3 cp ./video.mp4 s3://urunler/video/video.mp4
aws --endpoint-url https://s3.ornek.com s3 sync ./site s3://urunler/site
JavaScript (AWS SDK v3)
import { S3Client, PutObjectCommand } from '@aws-sdk/client-s3'

const s3 = new S3Client({
  endpoint: 'https://s3.ornek.com',
  region: 'us-east-1',
  forcePathStyle: true,
  credentials: { accessKeyId: process.env.S3_KEY_ID, secretAccessKey: process.env.S3_SECRET },
})
await s3.send(new PutObjectCommand({ Bucket: 'urunler', Key: 'gorseller/logo.png', Body: dosya, ContentType: 'image/png' }))
rclone.conf
[aksungur]
type = s3
provider = Other
endpoint = https://s3.ornek.com
access_key_id = <Access Key ID>
secret_access_key = <Secret Access Key>
force_path_style = true

Desteklenen işlemler

ListBuckets, HeadBucket, GetBucketLocation, ListObjects (v1 ve v2), PutObject, GetObject (aralık ve koşullu istekler dahil), HeadObject, DeleteObject, DeleteObjects, CopyObject, parçalı yüklemenin tamamı (Create, UploadPart, Complete, Abort, ListParts, ListMultipartUploads) ve imzalı (presigned) GET ve PUT bağlantıları.

  • Bucket oluşturma ve silme konsoldan yapılır. ACL, politika, etiket, sürümleme ve bildirim uçları yoktur; karşılıkları konsoldadır (token koruması, çöp kutusu, webhook).
  • Anahtarın izinleri ve bucket kısıtı S3’te de geçerlidir. Silinen dosyalar, bucket geçmiş tutuyorsa çöp kutusuna gider.
  • x-amz-meta-* üst verileri, Content-Type, Cache-Control, Content-Disposition ve Content-Encoding saklanır; CopyObject x-amz-metadata-directive değerine göre kopyalar ya da değiştirir.
  • Klasöre sınırlı bir anahtar S3’te de yalnızca kendi klasöründe çalışır; dışındaki işlemler AccessDenied alır.
  • Sonu / ile biten boş “klasör” dosyaları kabul edilir ama saklanmaz: klasörler içlerinde dosya olduğu sürece vardır.
  • S3 desteğinden önce oluşturulmuş erişim anahtarları S3 ile çalışmaz; yeni bir anahtar oluştur.

Hatalar ve sınırlar

Hatalar her zaman aynı biçimde döner. Programın code alanına, insanlar message alanına bakar.

Yanıt, 422
{ "error": { "code": "limit_reached", "message": "This team has reached its bucket limit", "details": { "limit": "buckets" } } }
DurumAnlamı
400İstek geçersiz. validation_error ise details hangi alanın hatalı olduğunu söyler.
401Anahtar eksik, hatalı, süresi dolmuş ya da iptal edilmiş.
403Anahtarın bu işlem için izni yok, bu bucket’a açık değil ya da işlem anahtarın klasörünün dışında (key_prefix).
404Kayıt yok ya da erişimin olmayan bir ekibe ait.
409Çakışma: ad alınmış, bucket boş değil.
413Dosya izin verilen en büyük boyutu aşıyor.
422Ekibin sınırına ulaşıldı (limit_reached): depolama, bucket, alan adı ya da üye.
429Çok fazla istek. Kısa bir süre bekleyip tekrar dene.
503Dosyanın durduğu sunucuya şu an ulaşılamıyor (node_unavailable). Geçicidir; biraz sonra tekrar dene.

API başvurusu

Tüm uçlar https://gateway.storage.aksungursoftware.com/v1 altındadır. :ekip ekibin kimliği (mer_…), :bucket bucket’ın adıdır.

Yöntem ve yolAçıklamaİzin
GET /merchants/:ekip/bucketsEkibin bucket’larını listeler.read
GET /buckets/:bucketBucket bilgisi, dosya sayısı ve boyutu.read
GET /buckets/:bucket/objectsDosyaları listeler. prefix, delimiter, cursor, limit.read
PUT /buckets/:bucket/objects/*Dosya yükler ya da üzerine yazar.write
GET /buckets/:bucket/objects/*Dosyayı indirir (her zaman ek olarak).read
HEAD /buckets/:bucket/objects/*Yalnızca başlıkları döner.read
DELETE /buckets/:bucket/objects/*Dosyayı siler.delete
POST /buckets/:bucket/deleteToplu siler: keys ya da prefix.delete
POST /buckets/:bucket/presignSüreli bağlantı oluşturur.read
POST /buckets/:bucket/uploadsParçalı yükleme başlatır; PUT …/:id/parts/:n, POST …/:id/complete, GET ve DELETE …/:id.write
POST /buckets/:bucket/upload-linksTarayıcının doğrudan yükleyebileceği süreli bağlantı üretir.write
GET /buckets/:bucket/versionsÇöp kutusu ve sürüm geçmişi; POST …/:id/restore geri yükler, DELETE …/:id kalıcı siler.read / write / delete
PATCH /buckets/:bucket/objects/*Dosyanın erişimini değiştirir: access = public, protected ya da null.write
GET /buckets/:bucket/statsGünlük trafik ve en çok istenenler. days = 7, 30 ya da 90.read

Bucket oluşturma, token koruması ve tokenlar, alan adı, anahtar ve üye yönetimi konsoldan yapılır ve oturum gerektirir; erişim anahtarlarıyla çağrılamaz.