S3 Nesne Depolama HOSTKEY¶

Bu makalede

• Hizmet Tanımı
• 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 Kovalarını Yönetme
• S3 Browser ile Kullanım
• Temel dosya işlemleri
• AWS CLI ile HOSTKEY S3 ile Çalışma

Hizmet Tanımı¶

Temel Özellikler¶

• Bağımsız depolar oluşturma - Ücretsiz Beta 1 planındaki ücretsiz beta dönemi boyunca, kullanıcılar en fazla 3 bağımsız S3 depolama kovası (bucket) oluşturabilir;
• VPS/VDS bağımsızlığı - S3 depoları özerk olarak çalışır ve HOSTKEY sunucu kiralaması gerektirmez;
• Kova (Bucket) Oluşturma - depolama oluşturulurken, benzersiz bir isimle ilk kova otomatik olarak oluşturulur. Kova Oluşturma: Beta dönemi boyunca, kullanıcılar her S3 depolama alanında en fazla 10 kova oluşturabilir;
• S3 uyumlu erişim - tüm veri işlemleri için standart Amazon S3 protokolünün tam desteği;
• Herhangi bir S3 istemcisiyle ç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 - hesap 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ği ile 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" esasına göre ödeme yapabilirsiniz. Ek kullanımın maliyeti günlük olarak hesaplanır.

Hizmet siparişi sırasında, seçilen fiyatlandırma planının koşullarına göre bir aylık gerçek kullanım için hesabınızdan bakiye düşülecektir. Sonraki aylık ödemeler ve kaynak limitlerinin aşılması nedeniyle oluşan ücretler de hesabınızdan bakiye düşülerek tahsil edilecektir.

Faturalandırma belgeleri, faturalandırma ayını takip eden ayın 2'sinde UTC saat 05:00'te oluşturulur. Faturalandırma belgelerini Invapi'nin Billing bölümünde görüntüleyebilirsiniz. Faturalandırma belgelerindeki tutar takvim ayını kapsar ve hizmet kullanım maliyetini, kaynak limitlerinin aşılması nedeniyle oluşan tüm ek ücretleri içerir.

S3 Depolama Oluşturma¶

1. Invapi'nde 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: kova adını girin (örneğin, bde347688-testbucket):
     • ad benzersiz olmalıdır;
     • maksimum 63 karakter;
     • yalnızca küçük harfler, rakamlar ve tireler;
     • bir harf veya rakamla 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ı ödeme sonrasında, Your Independent Storages paneline (veya üst menüden S3 Storage seçilerek) yönlendirileceksiniz; burada şunları yapabilirsiniz:

1. Ücretli depolarınızı ve tarifelerini görüntüleyin
2. Yeni bağımsız bir S3 depolama oluşturun
3. Listeden belirli bir depolamayı seçerek ayrıntılarını görüntüleyin
4. Depolama hacmi ve trafik kullanımı istatistiklerini görüntüleyin
5. Depolamaya bağlanmak için kimlik bilgilerini görüntüleyin
6. Mevcut depolamaya yeni kovalar ekleyin
7. Eklenen kovaların listesini ve istatistiklerini görüntüleyin
8. Kovalar üzerinde işlemler gerçekleştirin

Invapi'de S3 Depolama Kimlik Bilgilerini Alma¶

1. Depolarınızın listesinden oluşturulan 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östermek için simgesine tıklayın;
   • Secret Key: anahtarı göstermek için simgesine tıklayın.

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

Invapi'de S3 Depolama Kovalarını Yönetme¶

Invapi'deki S3 depolama arayüzünden doğrudan aşağıdaki kova işlemleri mevcuttur:

1. Kovanın depolamada kapladığı alanı ve içindeki nesne sayısını görüntüleyin;
2. Kovayı silin;
3. Adının bulunduğu satıra tıklayarak kova içeriğini görüntüleyin;
4. Kovadaki dosyalar için dosya boyutu ve oluşturma tarihi bilgilerini görüntüleyin;
5. Kovada dosya arayın;
6. Kovadan tek tek dosyaları silin.

S3 Browser ile 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 düğmesine tıklayın.

3. Formu doldurun:

   • Display name: HOSTKEY S3 (herhangi bir uygun isim);
   • Account type: S3 Compatible Storage (Amazon S3 Storage değil!);
   • 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 aktif bırakın.

4. Add new account düğmesine tıklayın;

5. Dosyalarla çalışma:

   

   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 işlemleri¶

S3 uyumlu bir istemci aracılığıyla bir S3 depolamaya bağlandıktan sonra aşağıdaki işlemler mevcuttur:

Dosya yükleme¶

1. S3 Browser üzerinden:

   • Sol panelden bir kova seçin;
   • Upload düğmesine 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 ile:

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

Dosya indirme¶

1. Kovada bir dosya seçin;

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

   

3. Dosyayı bilgisayarınızda kaydedilecek 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 kova 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: dosyayı istediğiniz klasöre fare tuşunu basılı tutarak sürükleyin.

Dosya yeniden adlandırma¶

1. Dosyaya sağ tıklayın;

2. Rename seçeneğini belirleyin:

   

3. Yeni bir ad girin;

4. Klavyeden Enter tuşuna basın.

Erişim izinlerini yönetme (ACL)¶

1. Dosyaya veya kovaya sağ tıklayın;

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

   

3. Açılan pencerede kullanıcılar için erişim izinlerini 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 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 - erişim izinlerini okuma;
   • Write Permissions - erişim izinlerini değiştirme:

   

5. Hızlı yapılandırma için düğmeleri 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 düğmesine tıklayın.

Web bağlantıları oluşturma¶

S3 Nesne Depolama'daki bir dosyaya veya klasöre genel bir bağlantı oluşturmak için:

1. Dosyaya sağ tıklayın;

2. Bağlam menüsünden 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 bağlantı kullanın (gizli veriler için önerilir);

5. Expiration - bağlantı süresinin dolma süresini seçin;

6. Hostname - ana bilgisayar adı 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, dosyaya 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 hizmet seçin:

   • Shorten with Bitly - Bitly ile kısaltın;
   • Shorten with TinyURL - TinyURL ile kısaltın;
   • Configure... - kısaltma hizmetlerini 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. Düğmeleri 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. Bunlardan birini seçin:

Yöntem 1: pip üzerinden kurulum (evrensel)¶

Avantajlar:

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

Dezavantajlar:

• Python'un kurulu olması gerekir;
• Bazı terminallerde uyarılar gösterebilir.

Kurulum:

pip install awscli boto3

Kurulumu doğrulama:

aws --version

pip show awscli boto3

Güncelleme:

pip install --upgrade awscli boto3

Yöntem 2: Windows için MSI kurulumu (önerilen)¶

Avantajlar:

• Python gerektirmez;
• Terminalde uyarı yok;
• Temiz sistem kurulumu.

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 olarak indirin: https://awscli.amazonaws.com/AWSCLIV2.msi;
• Kurulumu çift tıklayarak çalıştırın;
• Terminali yeniden başlatın.

Çakışmaları kontrol edin:

where aws

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

pip uninstall awscli -y

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

HOSTKEY S3'e Bağlantıyı Yapılandırma¶

1. HOSTKEY panelinden kimlik bilgilerini alma

1. Invapi'nde 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ı için (Access Key ID):

   • Anahtarı göstermek için göz simgesine tıklayın;
   • Görüntülenen değeri manuel olarak veya Copy düğmesi aracılığıyla kopyalayın.

   Gizli anahtar için (Secret Access Key):

   • Anahtarı göstermek için göz simgesine tıklayın;
   • Görüntülenen değeri manuel olarak veya Copy düğmesi aracılığıyla kopyalayın.

   Dikkat

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

5. Ayrıca şunlara ihtiyacınız olacak:

6. Ana bilgisayar adı: https://s3-nl.hostkey.com;
7. Bölge: panelde görüntülenen (örneğin, Hollanda için nl).

2. Profili ayarlama

aws configure --profile hostkey

İstenildiğinde 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ğrulama

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ğrulama

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

Beklenen sonuç (kovalarınızın listesi):

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

Temel dosya işlemleri¶

Kova 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¶

Test dosyası oluşturun:

echo Hello HOSTKEY S3 > test.txt

Dosyayı kovaya 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

İndirilen dosyayı kontrol edin (Windows):

type downloaded.txt

İndirilen dosyayı kontrol edin (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örleri senkronize etme¶

Bir klasörü kovaya 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ü kovadan 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östergesi 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 yapacaktır):

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

Ek komutlar¶

Kova oluşturma¶

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

Boş bir kovayı silme¶

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

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

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

Kovalar arasında 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 kurulu değil veya PATH'e eklenmemiş.

Çözüm:

1. Kurulumdan sonra terminali yeniden başlatın;
2. where aws komutunu kullanarak kurulumu doğrulayın (bir yol göstermelidir);
3. Bu yardımcı olmazsa, AWS CLI'yi yeniden kurun.

Hata: Geçersiz kova adı¶

Neden: Yanlış kova adı.

Çözüm: HOSTKEY panelindeki tam kova 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ında ç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

Yeniden ayarlayın:

aws configure --profile hostkey

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

Windows:

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

Linux/macOS:

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

Dosya içerikleri:

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

Doğrulama için yararlı komutlar¶

AWS CLI sürümü:

aws --version

Çalıştırılabilenin konumu:

where aws

Profil bilgileri:

aws configure list --profile hostkey

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

pip show awscli boto3

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

pip install --upgrade awscli boto3