S3 Object Storage HOSTKEY¶

Bu makalede

• Servis Açıklaması
• Temel Özellikler
• Teknik Parametreler
• Fiyatlandırma
• S3 Depolama Oluşturma
• Invapi'de S3 Depolama Kontrol Paneli
• Invapi'de S3 Depolama Kimlik Bilgilerini Alma
• Invapi'de S3 Depolama Bucket Yönetimi
• S3 Browser Kullanımı
• Temel Dosya İşlemleri
• AWS CLI ile HOSTKEY S3 Kullanımı

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 S3 depolamasında 10 adede kadar bucket oluşturabilirler;
• 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çimi.

Teknik Parametreler¶

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

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ımları için ödemeler ve kaynak limitlerinin aşılması durumunda oluşacak ücretler de hesabınızdan tahsil edilecektir.

İşlem geçmişinizi görüntülemek için Invapi üzerindeki Billing sekmesine gidin ve Billing Details bölümüne ilerleyin.

Billing Details bölümünde, bu hesaba bağlı tüm ek servislerin (Managed Apps, S3) işlem geçmişini ve ayrıca bu hesaptan tahsil edilen toplam tutarı görüntüleyebilirsiniz. Her bir servis ücreti aylık fatura döngüsü içinde ayrı olarak listelenir.

Fatura belgeleri, fatura ayını takip eden ayın 2'sinde saat 05:00 UTC'de oluşturulur. Fatura belgelerini Invapi içindeki Billing bölümünde görüntüleyebilirsiniz. Fatura belgelerindeki tutar, takvim ayını kapsar ve servis kullanım maliyetinin yanı sıra kaynak limitlerinin aşılması durumunda oluşan tüm ek ücretleri içerir.

S3 Depolama Oluşturma¶

1. Invapi üzerindeki hesabınıza giriş yapın;

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

3. Yeni depolama oluşturun:

   

   • Region: bölgeyi seçin (varsayılan NL - Hollanda);
   • 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 (örneğin, Standart). Seçmek için plan adına tıklayın;
   • Create S3 Storage düğmesine tıklayın.

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

Invapi'de S3 Depolama Kontrol Paneli¶

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

1. Ödenmiş depolamalarınızı ve tarifelerini görüntüleme
2. Yeni bir bağımsız S3 depolama oluşturma
3. Detaylarını görüntülemek için listeden belirli bir depolama 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 depolamaya yeni bucket'lar ekleme
7. Eklenen bucket listesini ve istatistiklerini görüntüleme
8. Bucket'lar üzerinde işlemler gerçekleştirme

Invapi'de S3 Depolama Kimlik Bilgilerini Alma¶

1. Depolamalarınızın listesinde, oluşturduğunuz depolamayı 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 gerekecektir.

Invapi'de S3 Depolama Bucket Yönetimi¶

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. İsminin bulunduğu 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çinde dosya arama;
6. Bucket'tan tekil dosyaları silme.

S3 Browser Kullanımı¶

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 yolunu izleyin.

3. Formu doldurun:

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

4. Add new account düğmesine 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 düğmeleri: Upload, Download, Delete, New Folder, Refresh.

   Mevcut işlemler:

   • Upload - dosya yükleme;
   • Download - dosya indirme;
   • Delete - dosya silme;
   • New Folder - klasör oluşturma;
   • Refresh - listeyi yenileme.

Temel Dosya İşlemleri¶

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

Dosya Yükleme¶

1. S3 Browser ile:

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

   

2. Sürükle ve bırak ile:

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

Dosya İndirme¶

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

2. Download düğmesine tıklayın veya sağ tıklayıp Download seçeneğini belirleyin:

   

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 düğmesine 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 düğmesine tıklayın:

   

3. Klasör adını girin:

   

4. Create new folder düğmesine 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 sol tuşuna 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 belirleyin:

   

3. Yeni bir isim girin;

4. Klavyeden Enter tuşuna basın.

Erişim İzinları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 belirleyin:

   

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 genel (public) 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 düğmeleri kullanın:

   • Make public - dosyayı herkese açık hale getirir;
   • Make private - dosyayı özel (private) hale getirir.

6. Yapılandırmadan sonra, kaydetmek için Apply changes düğmesine tıklayın.

Web Bağlantıları Oluşturma¶

S3 Object Storage'da bir dosya veya klasör için genel 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 belirleyin:

   

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 bilgisayar 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 düğmesine 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 düğmeleri kullanın:

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

   

AWS CLI ile HOSTKEY S3 Kullanımı¶

AWS CLI Kurulumu¶

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

Yöntem 1: pip aracılığıyla 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ı vermez;
• Temiz sistem kurulumu sağlar.

Dezavantajları:

• Sadece Windows içindir;
• 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

Eğer birden fazla yol gösteriliyorsa, versiyonlardan 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 üzerindeki 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 düğmesi 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 düğmesi 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. Ayrıca ş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

İstendiğ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 listeniz):

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/test_new.txt --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 kontrolü (Windows):¶

type downloaded.txt

Dosya kontrolü (Linux/macOS):¶

cat 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

Bucket'tan bir klasör 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 versiyonları arasındaki çakışma¶

Belirtiler: where aws komutu iki farklı yol gösterir.

Çözüm: Versiyonlardan 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 yapın:

aws configure --profile hostkey

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

Windows:

C:\Users\KULLANICI_ADI\.aws\credentials
C:\Users\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 versiyonu:

aws --version

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

where aws

Profil bilgisi:

aws configure list --profile hostkey

Paket bilgisi (pip versiyonu için):

pip show awscli boto3

Güncelleme (pip versiyonu için):

pip install --upgrade awscli boto3