S3 Object Storage HOSTKEY¶

Bu makalede

• Servis Açıklaması
• Temel Özellikler
• Teknik Parametreler
• Tarayıcı Erişimi ve CORS
• Presigned URL Desteği
• Fiyatlandırma
• S3 Depolama Oluşturma
• Invapi'de S3 Depolama Kontrol Paneli
• Invapi'de S3 Depolama Kimlik Bilgilerini Alma
• Invapi'de S3 Depolama Bucket'larını Yönetme
• S3 Browser Kullanarak
• Temel dosya işlemleri
• AWS CLI ile HOSTKEY S3 ile Çalışma

Servis Açıklaması¶

Temel Özellikler¶

• Bağımsız depolama birimleri oluşturma - Free Beta 1 planındaki ücretsiz beta dönemi boyunca kullanıcılar 3 adede kadar bağımsız S3 depolama bucket'ı oluşturabilir;
• VPS/VDS'den bağımsızlık - S3 depolamaları otonom olarak çalışır ve HOSTKEY sunucu kiralaması gerektirmez;
• Bucket Oluşturma - Depolama oluşturulurken, benzersiz bir isme sahip ilk bucket otomatik olarak oluşturulur. Bucket Oluşturma: Beta dönemi boyunca kullanıcılar her bir S3 depolama biriminde 10 adede kadar bucket oluşturabilir;
• S3 uyumlu erişim - Tüm veri işlemleri için standart Amazon S3 protokolü için tam destek;
• Herhangi bir S3 istemcisi ile çalışma - S3 Browser, Cyberduck, boto3 ve diğer S3 uyumlu araçları kullanın;
• Güvenli erişim - HTTPS protokolü üzerinden Access Key ve Secret Key ile yetkilendirme;
• Basit kimlik bilgisi yönetimi - Hesabınızın web arayüzü üzerinden erişim anahtarlarının oluşturulması ve görüntülenmesi;
• Hazır planlar - Sabit depolama hacmi ve bant genişliğine sahip plan seçenekleri.

Teknik Parametreler¶

• Endpoint URL: https://s3-nl.hostkey.com;
• Protokol: HTTPS (SSL/TLS);
• Yetkilendirme: AWS Signature Version 4.

Tarayıcı Erişimi ve CORS¶

Web uygulamalarında S3 Object Storage kullanırken (tarayıcıdan fetch/XHR ile doğrudan erişim), bucket tarafında CORS kurallarını yapılandırmanız gerekir. CORS politikalarını API/CLI (PutBucketCors metodu) kullanarak kendiniz yapılandırabilirsiniz.

Web uygulamaları için önerilen parametreler:

• Allowed Origins: Alan adı URL'niz (örneğin, https://your-app.com).
• Allowed Methods: GET, PUT, POST, HEAD.
• Allowed Headers: Authorization, Content-Type, Content-MD5, x-amz-*.
• Expose Headers: ETag (Multipart Upload işleminin doğru çalışması için gereklidir).

Presigned URL Desteği¶

S3 Object Storage, geçici erişim mekanizmalarını tam olarak destekler:

• Presigned GET/PUT URL: Yükleme ve indirme için imzalı bağlantıların oluşturulması.
• Multipart Upload: part-URL aracılığıyla büyük dosyaların yüklenmesi ve CompleteMultipartUpload ile işlemin tamamlanması desteği.

Fiyatlandırma¶

S3 depolama ücretli olarak sağlanmaktadır. Güncel fiyatlandırma planlarını buradan inceleyebilirsiniz. Ayrıca depolama ve trafik hacminizi artırabilir ve "kullandıkça öde" (pay-as-you-go) esasına göre ödeme yapabilirsiniz. Ek kullanım maliyeti günlük olarak hesaplanır.

Servis siparişi sırasında, seçilen fiyatlandırma planının şartlarına göre bir aylık gerçek kullanım tutarı hesap bakiyenizden düşülecektir. Sonraki ayların kullanım ödemeleri ve kaynak limitlerinin aşılması durumunda oluşacak ücretler de hesabınızdan tahsil edilecektir.

Faturalandırma geçmişinizi görüntülemek için Invapi içindeki kullanıcı profilinde bulunan Balance & Payments menüsüne gidin ve Billing Details bölümüne geçin.

Billing Details bölümünde, bu hesapla ilişkili tüm ek hizmetler (Managed Apps, S3) için işlem geçmişini ve bu hesaba tahakkuk eden toplam tutarı görüntüleyebilirsiniz. Her bir hizmet ücreti, aylık faturalandırma döngüsü içinde ayrı ayrı listelenir.

Faturalar, raporlama ayını takip eden ayın 2. günü saat 05:00 UTC'de oluşturulur. Faturaları Invapi içindeki Balance & Payments bölümünde, Billing Details sekmesi altında inceleyebilirsiniz. Faturalardaki tutar, bir takvim ayı için hesaplanır ve hizmet kullanım maliyetini içerir. Tüm ek hizmetler için toplam tutarı içeren tek bir birleştirilmiş fatura oluşturulabilir.

S3 Depolama Oluşturma¶

1. Invapi üzerinden hesabınıza giriş yapın.

2. S3 Storage bölümüne gidin;

3. Yeni depolama oluşturun:

   

   • Region: konumu seçin — NL (Hollanda, varsayılan) veya FR (Fransa). Her iki konum da Standard ve COLD planları için mevcuttur;
   • Bucket name: bucket adını girin (örneğin, bde347688-testbucket):
     • isim benzersiz olmalıdır;
     • maksimum 63 karakter;
     • sadece küçük harfler, sayılar ve tireler;
     • bir harf veya sayı ile başlamalı ve bitmelidir.
   • Plan: bir fiyatlandırma planı seçin. Seçmek için plan ismine tıklayın:
     • Standard Storage — sık talep edilen verilerin (yedekler, medya varlıkları, loglar, uygulama dosyaları ve statik içerik) aktif olarak yönetilmesi ve dağıtılması için: Çıkış bant genişliği plana dahildir;
     • Cold Storage — nadir talep edilen verilerin (arşivler, saklanan yedek kopyalar ve uyumlulukla ilgili veri setleri) uzun süreli depolanması için: Çıkış bant genişliği ilk gigabayttan itibaren ayrı olarak faturalandırılır.
   • Create S3 Storage butonuna tıklayın.

Depolama oluşturulduktan sonra siparişiniz için ödeme yapmanız istenecektir.

Invapi'de S3 Depolama Kontrol Paneli¶

Başarılı ödemeden sonra, şunları yapabileceğiniz Your Independent Storages paneline yönlendirileceksiniz (veya sol menüden S3 Storage seçilerek):

1. Ödenmiş depolama birimlerinizi ve tarifelerini görüntüleme
2. Yeni bir bağımsız S3 depolama birimi oluşturma
3. Detaylarını görüntülemek için listeden belirli bir depolama birimi seçme
4. Depolama hacmi ve trafik kullanımı istatistiklerini görüntüleme
5. Depolamaya bağlanmak için kimlik bilgilerini görüntüleme
6. Mevcut depolama birimine yeni bucket'lar ekleme
7. Eklenen bucket'ların listesini ve istatistiklerini görüntüleme
8. Bucket'lar üzerinde işlemler gerçekleştirme

Invapi'de S3 Depolama Kimlik Bilgilerini Alma¶

1. Depolama birimlerinizin listesinde, oluşturduğunuz depolama birimini bulun ve Credentials sekmesine gidin:

   

2. Kimlik bilgilerini kopyalayın:

   Şunlara ihtiyacınız olacak:

   • Host Name (Endpoint URL): https://s3-nl.hostkey.com;
   • S3 User ID: (örneğin, oab56UivbdcUURCTrMCrcB86YWzyy1hB);
   • Access Key: anahtarı görüntülemek için simgesine tıklayın;
   • Secret Key: anahtarı görüntülemek için simgesine tıklayın.

   Bu verileri kaydedin - bağlantı için gereklidir.

Invapi'de S3 Depolama Bucket'larını Yönetme¶

Doğrudan Invapi'deki S3 depolama arayüzünden aşağıdaki bucket işlemleri yapılabilir:

1. Bucket'ın depolamada kapladığı alanı ve içindeki nesne sayısını görüntüleme;
2. Bucket'ı silme;
3. İsmiyle olan satıra tıklayarak bucket içeriğini görüntüleme;
4. Bucket içindeki dosyalar için dosya boyutu ve oluşturma tarihi bilgilerini görüntüleme;
5. Bucket içindeki dosyalar için arama yapma;
6. Bucket'tan tekil dosyaları silme.

S3 Browser Kullanarak¶

1. S3 Browser'ın ücretsiz sürümünü indirin: https://s3browser.com;

2. Yeni bir hesap ekleyin:

   

   • S3 Browser'ı açın;
   • Accounts >> Add New Account seçeneğine tıklayın.

3. Formu doldurun:

   • Display name: HOSTKEY S3 (istediğiniz bir isim);
   • Account type: S3 Compatible Storage (Amazon S3 Storage DEĞİL!);
   • API endpoint: s3-nl.hostkey.com (https:// olmadan);
   • Access Key ID: HOSTKEY panelinden Access Key'inizi yapıştırın;
   • Secret Access Key: HOSTKEY panelinden Secret Key'inizi yapıştırın;
   • Use secure transfer (SSL/TLS): onay kutusunu işaretli bırakın.

4. Add new account butonuna tıklayın;

5. Dosyalarla çalışın:

   

   Başarılı bağlantıdan sonra şunları göreceksiniz:

   • Solda Bucket list;
   • Sağda Files in bucket;
   • Yönetim butonları: Upload, Download, Delete, New Folder, Refresh.

   Mevcut işlemler:

   • Upload - dosyaları yükle;
   • Download - dosyaları indir;
   • Delete - dosyaları sil;
   • New Folder - klasörler oluştur;
   • Refresh - listeyi yenile.

Temel dosya işlemleri¶

S3 uyumlu bir istemci aracılığıyla bir S3 depolama birimine bağlandıktan sonra aşağıdaki işlemler yapılabilir:

Dosya yükleme¶

1. S3 Browser aracılığıyla:

   • Sol panelden bir bucket seçin;
   • Upload butonuna veya Upload folder(s) seçeneğine tıklayın;
   • Bilgisayarınızdan dosyaları seçin;
   • Yüklemeyi onaylayın:

   

2. Sürükle-bırak yöntemiyle:

   • Dosyaları doğrudan gezgininizden S3 Browser penceresine sürükleyin.

Dosya indirme¶

1. Bucket içinden bir dosya seçin;

2. Download butonuna tıklayın veya sağ tıklayıp Download seçeneğini seçin:

   

3. Dosyanın bilgisayarınızda kaydedileceği klasörü belirtin.

Dosya ve klasör silme¶

1. Bir dosya veya klasör seçin;

2. Delete butonuna tıklayın veya klavyeden Delete tuşuna basın:

   

3. Silme işlemini onaylayın.

Klasör yapısı oluşturma¶

1. Bir bucket veya klasör seçin;

2. New Folder butonuna tıklayın:

   

3. Klasör adını girin:

   

4. Create new folder butonuna tıklayın.

Dosya kopyalama ve taşıma¶

• Kopyalama: bir dosya seçin > sağ tıklayın > Copy > hedef klasöre gidin > sağ tıklayın > Paste;
• Taşıma: farenin düğmesini basılı tutarak dosyayı istediğiniz klasöre sürükleyin.

Dosya yeniden adlandırma¶

1. Dosyaya sağ tıklayın;

2. Rename seçeneğini seçin:

   

3. Yeni bir ad girin;

4. Klavyeden Enter tuşuna basın.

Erişim izinlarını yönetme (ACL)¶

1. Dosyaya veya bucket'a sağ tıklayın;

2. Bağlam menüsünde Edit Permissions (ACL) seçeneğini seçin:

   

3. Açılan pencerede kullanıcılar için erişim izinlarını yapılandırın:

   • Owner - nesne üzerinde tam kontrol;
   • Any AWS Users - herhangi bir AWS kullanıcısı için erişim;
   • All Users - herkes için herkese açık erişim.

4. Her kullanıcı kategorisi için şunları ayarlayabilirsiniz:

   • Full Control - tam kontrol;
   • Read - nesneyi okuma;
   • Write - nesneyi yazma/değiştirme;
   • Read Permissions - okuma erişim izinleri;
   • Write Permissions - değiştirme erişim izinleri:

   

5. Hızlı yapılandırma için şu butonları kullanın:

   • Make public - dosyayı herkese açık yapın;
   • Make private - dosyayı özel yapın.

6. Yapılandırmadan sonra kaydetmek için Apply changes butonuna tıklayın.

Web bağlantıları oluşturma¶

S3 Object Storage'daki bir dosya veya klasör için herkese açık bir bağlantı oluşturmak için:

1. Dosyaya sağ tıklayın;

2. Bağlam menüsünde Generate Web URL seçeneğini seçin:

   

3. Açılan Web URL Generator penceresinde bağlantı oluşturma parametrelerini yapılandırın:

4. Use secure transfer (HTTPS) - güvenli bir bağlantı kullanın (gizli veriler için önerilir);

5. Expiration - bağlantı geçerlilik süresini seçin;

6. Hostname - ana makine seçimi:

   • Use default host name - varsayılan adresi kullanın (örneğin, https://s3-nl.hostkey.com/bfcc62b88-testbucket/);
   • Veya kendi alan adınızı belirtin;

7. Parametreleri yapılandırdıktan sonra sistem dosya için tam bir bağlantı oluşturacaktır, örneğin:

   https://s3-nl.hostkey.com/bfcc62b88-testbucket/dedicated-server-architecture.drawio

Bağlantıyı kısaltma:¶

1. Kısa bir bağlantı oluşturmak için Shorten butonuna tıklayın ve bir servis seçin:

   • Shorten with Bitly - Bitly ile kısaltın;
   • Shorten with TinyURL - TinyURL ile kısaltın;
   • Configure... - kısaltma servislarını yapılandırın;

   

   

2. Başarılı kısaltmadan sonra kısa bir bağlantı alacaksınız (örneğin, https://tinyurl.com/2dhcsk8y);

3. Şu butonları kullanın:

   • Copy - bağlantıyı panoya kopyalayın;
   • Close - oluşturucu penceresini kapatın.

   

AWS CLI ile HOSTKEY S3 ile Çalışma¶

AWS CLI Kurulumu¶

AWS CLI iki şekilde kurulabilir. Birini seçin:

Yöntem 1: pip ile kurulum (evrensel)¶

Avantajları:

• Tek bir komutla basit kurulum;
• Kolay güncelleme;
• Tüm platformlarda çalışır (Windows, Linux, macOS).

Dezavantajları:

• Python yüklü olmasını gerektirir;
• Bazı terminallerde uyarılar gösterebilir.

Kurulum:

pip install awscli boto3

Kurulumu doğrulayın:

aws --version

pip show awscli boto3

Güncelleme:

pip install --upgrade awscli boto3

Yöntem 2: Windows için MSI yükleyicisi (önerilen)¶

Avantajları:

• Python gerektirmez;
• Terminalde uyarı çıkmaz;
• Temiz sistem kurulumu sağlar.

Dezavantajları:

• Sadece Windows;
• Güncellemeler manuel olarak indirilmelidir.

Terminal üzerinden kurulum:

curl -o AWSCLIV2.msi https://awscli.amazonaws.com/AWSCLIV2.msi

msiexec /i AWSCLIV2.msi /quiet /norestart

Kurulumdan sonra:

1. Terminali yeniden başlatın;
2. Kurulumu doğrulayın.

   aws --version
   

   where aws
   

Beklenen sonuç:

aws-cli/2.x.x Python/3.x.x Windows/10 exe/AMD64
C:\Program Files\Amazon\AWSCLIV2\aws.exe

Alternatif kurulum yöntemi:

• Manuel indirin: https://awscli.amazonaws.com/AWSCLIV2.msi;
• Yükleyiciyi çift tıklayarak çalıştırın;
• Terminali yeniden başlatın.

Çakışmaları kontrol edin:

where aws

Birden fazla yol gösteriliyorsa, sürümlerden birini kaldırın:

pip uninstall awscli -y

wmic product where "name like 'AWS Command Line Interface%'" call uninstall

HOSTKEY S3 bağlantısını yapılandırma¶

1. HOSTKEY panelinden kimlik bilgilerini alma

1. Invapi üzerinden hesabınıza giriş yapın;
2. S3 Storage bölümüne gidin;
3. "Credentials" sekmesini açın;

4. Aşağıdaki verileri kopyalayın:

   S3 kullanıcı tanımlayıcısı (Access Key ID) için:

   • Anahtarı görüntülemek için göz simgesine tıklayın;
   • Görüntülenen değeri manuel olarak veya Copy butonu ile kopyalayın.

   Gizli anahtar (Secret Access Key) için:

   • Anahtarı görüntülemek için göz simgesine tıklayın;
   • Görüntülenen değeri manuel olarak veya Copy butonu ile kopyalayın.

   Dikkat

   Gerçek anahtar değerlerini görüntülemek için önce simgesine tıklamanız gerekir; ancak ondan sonra doğru şekilde kopyalanabilirler.

5. Şunlara da ihtiyacınız olacak:

6. Host name: https://s3-nl.hostkey.com;
7. Region: panelde görüntülenen bölge (örneğin, Hollanda için nl).

2. Profili ayarlama

aws configure --profile hostkey

İstenildiğinde şunları girin:

AWS Access Key ID [None]: your_access_key_id
AWS Secret Access Key [None]: your_secret_access_key
Default region name [None]: nl
Default output format [None]: json

Örnek:

AWS Access Key ID [None]: s3uid_XXXXXXXXXXXXXXXXX
AWS Secret Access Key [None]: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Default region name [None]: nl
Default output format [None]: json

3. Yapılandırmayı doğrulayın

aws configure list --profile hostkey

Beklenen çıktı:

NAME       : VALUE                    : TYPE             : LOCATION
profile    : hostkey                  : manual           : --profile
access_key : ****************xxxx     : shared-credentials-file :
secret_key : ****************xxxx     : shared-credentials-file :
region     : nl                       : config-file      : ~/.aws/config

4. Bağlantıyı doğrulayın

aws s3 ls --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Beklenen sonuç (bucket listesi):

2025-11-26 13:54:16 your-bucket-name

Temel dosya işlemleri¶

Bucket içeriğini görüntüleme¶

aws s3 ls s3://bucket-name/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Örnek:

aws s3 ls s3://your-bucket-name/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Sonuç:

2025-11-28 12:14:28         21 test.txt
2025-11-28 14:52:11         19 test_new.txt

Dosya yükleme¶

Bir test dosyası oluşturun:

echo Hello HOSTKEY S3 > test.txt

Dosyayı bucket'a yükleyin:

aws s3 cp test.txt s3://bucket-name/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Örnek:

aws s3 cp test_new.txt s3://your-bucket-name/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Sonuç:

upload: .\test_new.txt to s3://your-bucket-name/test_new.txt

Dosya indirme¶

aws s3 cp s3://bucket-name/file.txt ./local-file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Örnek:

aws s3 cp s3://your-bucket-name/test.txt ./downloaded.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Sonuç:

download: s3://your-bucket-name/test.txt to .\downloaded.txt

Dosya silme¶

aws s3 rm s3://bucket-name/file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Örnek:

aws s3 rm s3://your-bucket-name/test.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Sonuç:

delete: s3://your-bucket-name/test.txt

Klasör senkronizasyonu¶

Bir klasörü bucket'a yükleme:

aws s3 sync path/to/local/folder s3://bucket-name/path-in-bucket/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Örnek:

aws s3 sync C:\Users\User\Documents\Test s3://your-bucket-name/remote-folder/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Sonuç:

upload: Documents\Test\file1.txt to s3://your-bucket-name/remote-folder/file1.txt
upload: Documents\Test\file2.docx to s3://your-bucket-name/remote-folder/file2.docx

Bir klasörü bucket'tan indirme:

aws s3 sync s3://bucket-name/path-in-bucket/ path/to/local/folder --profile hostkey --endpoint-url https://s3-nl.hostkey.com

İlerleme gösterimi ile:

aws s3 sync C:\Users\User\Documents\Test s3://your-bucket-name/backup/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com --progress

Doğru:

aws s3 sync "C:\Users\Name\My Documents" s3://bucket/docs/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Yanlış (hata verecektir):

aws s3 sync C:\Users\Name\My Documents s3://bucket/docs/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Ek komutlar¶

Bucket oluşturma¶

aws s3 mb s3://new-bucket-name --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Boş bir bucket silme¶

aws s3 rb s3://bucket-name --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Tüm içeriğiyle birlikte bir bucket silme¶

aws s3 rb s3://bucket-name --force --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Bucket'lar arası kopyalama¶

aws s3 cp s3://source-bucket/file.txt s3://dest-bucket/file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Dosya taşıma¶

aws s3 mv s3://bucket-name/old-file.txt s3://bucket-name/new-file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Sorun Giderme¶

Hata: "aws" bir komut değil¶

Neden: AWS CLI yüklü değil veya PATH'e eklenmemiş.

Çözüm:

1. Kurulumdan sonra terminali yeniden başlatın;
2. where aws komutuyla kurulumu doğrulayın (bir yol göstermelidir);
3. Bu işe yaramazsa, AWS CLI'yi yeniden yükleyin.

Hata: Geçersiz bucket adı¶

Neden: Yanlış bucket adı.

Çözüm: HOSTKEY panelindeki tam bucket adını kullanın (örneğin, prefix-testbucket).

Hata: AccessDenied¶

Neden: Yanlış kimlik bilgileri veya yetersiz izinler.

Çözüm:

1. HOSTKEY panelindeki Access Key ve Secret Key'i kontrol edin;
2. Profili yeniden oluşturun.

   aws configure --profile hostkey
   

pip ve MSI sürümleri arasındaki çakışma¶

Belirtiler: where aws komutu iki yol gösteriyor.

Çözüm: Sürümlerden birini kaldırın (bkz. "Kurulum yöntemlerini karıştırmayın" bölümü).

Yapılandırmayı sıfırlama¶

Windows:

rmdir /S /Q %USERPROFILE%\.aws

Linux/macOS:

rm -rf ~/.aws

Tekrar kurulum:

aws configure --profile hostkey

Yapılandırma dosyalarının konumu¶

Windows:

C:\Users\KULLANICI_ADI\.aws\credentials
C:\Users\KULLANICI_ADI\.aws\config

Linux/macOS:

~/.aws/credentials
~/.aws/config

Dosya içerikleri:

• credentials - Access Key ve Secret Key;
• config - bölge (region) ve çıktı formatı ayarları.

Doğrulama için yararlı komutlar¶

AWS CLI sürümü:

aws --version

Yürütülebilir dosyanın konumu:

where aws

Profil bilgisi:

aws configure list --profile hostkey

Paket bilgisi (pip sürümü için):

pip show awscli boto3

Güncelleme (pip sürümü için):

pip install --upgrade awscli boto3