Zum Inhalt

Verwendung des Swift-Clients

Mit dem Swift-Client (swift) kannst Du einfach mit Deinem Object Storage interagieren. Hier findest Du praktische Beispiele, wie Du den Client für Deinen Bucket unter storage.netways.cloud nutzen kannst.

Voraussetzungen

  • Du besitzt einen Subuser mit Secret-Key.
  • Der Swift-Client ist auf Deinem System installiert. Falls nicht, installiere ihn mit:
pip install python-swiftclient

Konfiguration des Swift-Clients

1. Umgebungsvariablen setzen

Erstelle eine Datei swiftrc.sh mit folgendem Inhalt:

export ST_AUTH=https://storage.netways.cloud/auth/v1.0
export ST_USER=HAUPT_USER:SUBUSER
export ST_KEY=SECRET_KEY

Anschließend aktivieren:

source swiftrc.sh

Alternativ kannst Du die Zugangsdaten bei jedem Befehl mitgeben (siehe Beispiele weiter unten).


Grundlegende Beispiele

1. Container auflisten

swift list

Oder ohne Umgebungsvariablen:

swift -A https://storage.netways.cloud/auth/v1.0 \
      -U HAUPTKONTO:SUBUSER \
      -K DEIN_SECRET_KEY \
      list

2. Datei hochladen

swift upload mein-container ~/meine-datei.txt

3. Container-Inhalt anzeigen

swift list mein-container

4. Verzeichnis synchronisieren

swift upload mein-container ~/mein-verzeichnis

5. Datei herunterladen

swift download mein-container meine-datei.txt --output ~/Downloads/meine-datei.txt

6. Datei löschen

swift delete mein-container meine-datei.txt

7. Datei-Statistiken anzeigen

swift stat mein-container meine-datei.txt

8. Container erstellen

swift post mein-container2

Grundlegende Befehle für Container-Zugriffsrechte

1. Aktuelle ACL anzeigen

swift stat mein-container

2. Öffentlichen Lesezugriff erlauben

swift post mein-container -r '.r:*,.rlistings'

URL

Der Container ist dann unter https://storage.netways.cloud/swift/v1/mein-container öffentlich einsehbar.

3. Öffentlichen Zugriff entfernen

swift post mein-container -r ''

Achtung

Öffentlicher Zugriff ermöglicht jedem im Internet Zugriff auf Deine Objekte. Verwende dies nur in Ausnahmefällen!


Objekt-Metadaten

1. Metadaten für Container setzen

swift post mein-container -m X-Container-Meta-Projekt:MeinProjekt

2. Objekt-Metadaten anzeigen

swift stat mein-container meine-datei.txt

Tipps & Hinweise

Sicherheitshinweise

  • Container mit öffentlichem Zugriff (.r:*) sollten regelmäßig überprüft werden
  • Zugriff erfolgt immer Container-weit – nicht objektweise
  • Verwende Metadaten zur Strukturierung und Kategorisierung von Objekten
Debugging

Füge den Parameter --debug zu Deinen Befehlen hinzu, um detaillierte Informationen zu erhalten, z. B.:

swift --debug list