Obiekty i pliki¶
Dane w Cloud4You Object Storage S3 są przechowywane jako obiekty.
Najczęściej obiektem jest po prostu plik, na przykład:
Każdy obiekt znajduje się w określonym buckecie i posiada własny klucz, czyli Object Key.
Przykład¶
Bucket:
Obiekt:
Pełna ścieżka używana przez klienta S3:
Wysłanie pliku do S3¶
Aby przesłać plik:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 cp plik.zip s3://firma-backup/plik.zip
Po poprawnym przesłaniu AWS CLI wyświetli informację o zakończonym uploadzie.
Wysłanie pliku pod inną nazwą¶
Lokalny plik:
możesz zapisać w S3 jako:
Polecenie:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 cp backup.zip s3://firma-backup/backup-serwer01.zip
Wysłanie pliku do prefiksu¶
Możesz organizować obiekty za pomocą prefiksów przypominających katalogi.
Przykład:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 cp backup.zip s3://firma-backup/server01/backup.zip
Obiekt otrzyma klucz:
Wyświetlenie zawartości bucketa¶
Wyświetlenie całej zawartości¶
Aby zobaczyć wszystkie obiekty rekurencyjnie:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 ls s3://firma-backup/ --recursive
Przykład:
2026-08-27 12:15:43 1048576 server01/backup.zip
2026-08-27 12:20:11 2097152 server02/backup.zip
2026-08-27 12:30:01 2457 raporty/raport.txt
Pobranie pliku¶
Aby pobrać obiekt:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 cp s3://firma-backup/plik.zip ./plik.zip
Pobranie pliku pod inną nazwą¶
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 cp s3://firma-backup/plik.zip ./plik-pobrany.zip
Kopiowanie katalogu do S3¶
Jeżeli chcesz wysłać wszystkie pliki z lokalnego katalogu:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 cp ./dane/ s3://firma-backup/dane/ --recursive
Pobranie całego katalogu¶
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 cp s3://firma-backup/dane/ ./dane/ --recursive
Synchronizacja katalogu do S3¶
Polecenie sync przesyła nowe i zmienione pliki.
Przykład:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 sync ./dane/ s3://firma-backup/dane/
Synchronizacja z S3 na komputer¶
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 sync s3://firma-backup/dane/ ./dane/
Uważaj na opcję --delete
Polecenie sync może zostać uruchomione z opcją --delete.
W takim przypadku obiekty istniejące w miejscu docelowym, których nie ma w źródle, mogą zostać usunięte.
Przed użyciem --delete dokładnie sprawdź źródło i cel synchronizacji.
Usunięcie obiektu¶
Aby usunąć pojedynczy obiekt:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 rm s3://firma-backup/plik.zip
Usuwanie danych
Przed wykonaniem polecenia rm sprawdź dokładnie nazwę bucketa i obiektu.
Usunięcie wielu obiektów¶
Przykład usunięcia całego prefiksu:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 rm s3://firma-backup/test/ --recursive
Operacja destrukcyjna
Polecenie s3 rm --recursive może usunąć dużą liczbę obiektów.
Sprawdzenie informacji o obiekcie¶
Aby pobrać metadane konkretnego obiektu:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3api head-object \
--bucket firma-backup \
--key plik.zip
Odpowiedź może zawierać między innymi:
- rozmiar obiektu,
- typ zawartości,
- datę modyfikacji,
- ETag,
- własne metadane.
Object Key¶
Object Key jest pełną nazwą obiektu wewnątrz bucketa.
Przykład:
W tym przypadku:
Foldery w S3¶
S3 nie posiada klasycznych katalogów znanych z systemów plików.
Obiekt:
ma po prostu klucz:
Aplikacja może prezentować ten klucz jako:
Jest to wygodny sposób prezentacji danych, ale technicznie / pozostaje częścią nazwy obiektu.
Nadpisywanie obiektów¶
Jeżeli prześlesz nowy obiekt pod tym samym kluczem, istniejący obiekt może zostać zastąpiony.
Przykład:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 cp raport.pdf s3://firma-backup/raport.pdf
Jeżeli raport.pdf już istnieje, nowa wersja zostanie zapisana pod tym samym kluczem.
Ważne przy wyłączonym versioningu
Jeżeli versioning nie jest włączony, nadpisanie obiektu może spowodować utratę poprzedniej zawartości.
Dla ważnych danych rozważ włączenie versioningu.
Versioning a usuwanie¶
Jeżeli bucket ma włączony versioning, usunięcie obiektu może nie usuwać wszystkich jego wersji.
Standardowe polecenie:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 rm s3://firma-backup/raport.pdf
może utworzyć Delete Marker, podczas gdy wcześniejsze wersje nadal pozostają w buckecie.
Więcej informacji znajdziesz w rozdziale dotyczącym wersjonowania.
Duże pliki¶
Klienci S3 mogą używać mechanizmu Multipart Upload do przesyłania dużych obiektów.
AWS CLI obsługuje ten mechanizm automatycznie podczas przesyłania dużych plików.
W typowym przypadku nie musisz ręcznie dzielić pliku na części.
Przerwane wysyłanie¶
W przypadku przerwania Multipart Upload w systemie mogą pozostać nieukończone części uploadu.
W przyszłości warto okresowo kontrolować niedokończone uploady, szczególnie przy aplikacjach przesyłających bardzo duże pliki.
S3 nie jest klasycznym dyskiem¶
Object Storage dobrze nadaje się do:
- kopii zapasowych,
- archiwizacji,
- dokumentów,
- multimediów,
- eksportów,
- logów,
- danych aplikacyjnych.
Nie należy używać S3 bezpośrednio jako storage dla:
- aktywnych baz danych,
- dysków maszyn wirtualnych,
- aplikacji wymagających pełnej semantyki POSIX,
- danych wymagających klasycznych blokad plikowych.
Najczęściej używane polecenia¶
Upload:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 cp plik.zip s3://firma-backup/
Download:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 cp s3://firma-backup/plik.zip .
Lista:
Usunięcie:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 rm s3://firma-backup/plik.zip
Synchronizacja: