Kavramlar
Aksungur Storage beş kavram üzerine kuruludur:
| Kavram | Ne işe yarar |
|---|---|
| Ekip | Bir müşterinin çalışma alanı. Bucket’lar, alan adları, anahtarlar ve üyeler ekibe aittir; ekipler birbirinin verisini göremez. |
| Bucket | Dosyaları bir arada tutan ve kendi adresinden yayınlanan klasör. Adı tüm platformda tektir, çünkü adresin parçasıdır. |
| Dosya | Bir 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ı. |
| Token | Token koruması açık olan dosyaları açan anahtar. Yalnızca okur; dosyaları listeleyemez, yükleyemez, silemez. |
Hızlı başlangıç
- Konsola giriş yap. Hesabın yoksa platform yöneticisinden iste; dışarıdan kayıt kapalıdır.
- Bucket’lar sayfasında Bucket ekle’ye bas ve bir ad ver, örneğin
urunler. - Bucket’ı aç ve dosyalarını pencereye sürükle. Klasör bırakırsan yapısı korunur.
- 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:
Authorization: Bearer aks_xxxxxxxxxxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxİzinler
| İzin | Neye izin verir |
|---|---|
read | Bucket’ları ve dosyaları listeler, indirir, süreli bağlantı oluşturur. |
write | Dosya yükler ve var olan dosyaların üzerine yazar. |
delete | Dosyaları 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
403vekey_prefixkoduyla 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.
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{
"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
200döner. Content-Typegö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-Controlbaşlığını ekle, örneğinpublic, 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
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ık | S3’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-Disposition | Content-Disposition | Tarayıcının dosyayı hangi adla indireceği ya da sayfada gösterip göstermeyeceği. |
X-Content-Encoding | Content-Encoding | Önceden gzip ya da br ile sıkıştırılmış dosyanın tarayıcıda açılması. |
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
metadataalanında, S3’tex-amz-meta-*başlıklarında geri döner. Adlar küçük harfe çevrilir. Content-DispositionveContent-Encodingdosyanı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.
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": [] } }curl -X PUT -H "Authorization: Bearer $AKS_KEY" --data-binary @parca-001 \
https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/uploads/upl_…/parts/1curl -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.
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": "…" }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
}| Alan | Anlamı |
|---|---|
key | Bağ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. |
prefix | Bağ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). |
maxBytes | Dosya 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. |
expiresIn | Saniye cinsinden geçerlilik, en fazla 7 gün. Bağlantılar iptal edilemez; kısa tut. |
access, cacheControl | Dosyanı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.
curl -H "Authorization: Bearer $AKS_KEY" \
"https://gateway.storage.aksungursoftware.com/v1/buckets/urunler/objects?prefix=gorseller/&delimiter=/&limit=100"{
"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
# 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/deleteBir 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:
https://urunler.edge.ornek.com/gorseller/logo.pngDağıtım sunucusu tarayıcıların ve ara sunucuların beklediği HTTP davranışlarını eksiksiz uygular:
| Özellik | Davranış |
|---|---|
ETag | İçeriğin özetinden üretilir. If-None-Match eşleşirse gövdesiz 304 döner. |
Cache-Control | Bucket ayarından gelir (varsayılan 1 saat); dosyaya özel değer verilmişse o kullanılır. |
Range | Parçalı indirme ve video sarma için 206 Partial Content desteklenir. |
| CORS | Dosyalar 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 adres | Kö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=1 | Dosyayı 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.
https://urunler.edge.ornek.com/gorseller/logo.png?token=akt_…curl -H "Authorization: Bearer akt_…" \
https://urunler.edge.ornek.com/gorseller/logo.png| Durum | Yanı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 ait | 403 Forbidden |
| Geçerli token | Dosya, 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.
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.pdfcurl -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.pngSü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:
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{
"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.
https://urunler.edge.ornek.com/gorseller/urun.jpg?w=400&format=auto| Parametre | Değer | Anlamı |
|---|---|---|
w, h | 1 – 4096 | En fazla genişlik ve yükseklik. Biri verilirse oran korunur. Görsel hiçbir zaman büyütülmez. |
fit | inside (varsayılan), cover, contain | Kutuya sığdır; kutuyu doldurup taşanı kırp; kutuya sığdırıp boşluğu saydam bırak. |
format | auto, webp, avif, jpeg, png | auto tarayıcının kabul ettiği en küçük biçimi seçer (AVIF, yoksa WebP, yoksa özgün). |
q | 1 – 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.
# 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_…/restoreYaş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.
{
"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
}| Olay | Ne zaman | Ek alanlar |
|---|---|---|
object.created | Dosya yüklendiğinde ya da üzerine yazıldığında. | replaced |
object.deleted | Dosya silindiğinde. | reason: deleted ya da expired (yaşam döngüsü); permanent: çöp kutusuna gitmediyse true |
object.restored | Dosya çö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.
# 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ür | Ad | Değer | Amaç |
|---|---|---|---|
TXT | _aksungur.cdn.ornek.com | aksungur-verify=… | Alan adının sana ait olduğunu kanıtlar. |
CNAME | cdn.ornek.com | edge.ornek.com | İstekleri dağıtım sunucusuna yönlendirir. |
- Kayıtları alan adının DNS yönetim paneline gir.
- Kayıtlar düzenli olarak denetlenir; beklemek istemezsen Şimdi denetle’ye bas. İkisi de bulunduğunda alan adı doğrulanır.
- 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.
| Ayar | Değer |
|---|---|
| Endpoint | Bu kurulumda yayınlanmamış; yöneticine sor. |
| Region | us-east-1 |
| Access Key ID | Erişim anahtarının aks_ sonrasındaki 20 karakteri |
| Secret Access Key | Erişim anahtarının sonraki alt çizgiden sonraki bölümü |
| Adresleme | Path style (forcePathStyle: true, addressing_style = path) |
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/siteimport { 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' }))[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 = trueDesteklenen 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-DispositionveContent-Encodingsaklanır; CopyObjectx-amz-metadata-directivedeğ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
AccessDeniedalı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.
{ "error": { "code": "limit_reached", "message": "This team has reached its bucket limit", "details": { "limit": "buckets" } } }| Durum | Anlamı |
|---|---|
400 | İstek geçersiz. validation_error ise details hangi alanın hatalı olduğunu söyler. |
401 | Anahtar eksik, hatalı, süresi dolmuş ya da iptal edilmiş. |
403 | Anahtarı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). |
404 | Kayıt yok ya da erişimin olmayan bir ekibe ait. |
409 | Çakışma: ad alınmış, bucket boş değil. |
413 | Dosya izin verilen en büyük boyutu aşıyor. |
422 | Ekibin 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. |
503 | Dosyanı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 yol | Açıklama | İzin |
|---|---|---|
GET /merchants/:ekip/buckets | Ekibin bucket’larını listeler. | read |
GET /buckets/:bucket | Bucket bilgisi, dosya sayısı ve boyutu. | read |
GET /buckets/:bucket/objects | Dosyaları 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/delete | Toplu siler: keys ya da prefix. | delete |
POST /buckets/:bucket/presign | Süreli bağlantı oluşturur. | read |
POST /buckets/:bucket/uploads | Parçalı yükleme başlatır; PUT …/:id/parts/:n, POST …/:id/complete, GET ve DELETE …/:id. | write |
POST /buckets/:bucket/upload-links | Tarayı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/stats | Gü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.