Zarządzanie bucketami¶
Bucket jest podstawowym kontenerem, w którym przechowywane są obiekty w Cloud4You Object Storage S3.
Każdy obiekt musi znajdować się w określonym buckecie.
Lista bucketów¶
Aby wyświetlić wszystkie buckety dostępne dla użytkownika:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
--region eu-pl-1 \
s3api list-buckets
Przykładowa odpowiedź:
Tworzenie bucketa¶
Przykład utworzenia bucketa o nazwie:
Polecenie:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
--region eu-pl-1 \
s3api create-bucket \
--bucket firma-backup \
--create-bucket-configuration LocationConstraint=eu-pl-1
Po poprawnym wykonaniu polecenia bucket będzie gotowy do użycia.
Nazwa bucketa¶
Nazwa bucketa powinna być możliwie prosta i jednoznaczna.
Zalecane przykłady:
Zalecamy używanie:
- małych liter,
- cyfr,
- myślników.
Unikaj:
Dobrze zaplanuj nazwy
Nazwa bucketa często pojawia się w konfiguracji aplikacji, skryptach i procedurach backupowych.
Warto ustalić spójny schemat nazewnictwa przed utworzeniem większej liczby bucketów.
Sprawdzenie, czy bucket istnieje¶
Możesz sprawdzić dostęp do konkretnego bucketa:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
--region eu-pl-1 \
s3api head-bucket \
--bucket firma-backup
Jeżeli polecenie zakończy się bez błędu, bucket istnieje i użytkownik posiada do niego wymagany dostęp.
Wyświetlenie zawartości bucketa¶
Aby wyświetlić obiekty znajdujące się w buckecie:
Przykład:
Wyświetlenie całej zawartości¶
Jeżeli obiekty używają prefiksów przypominających katalogi, możesz wyświetlić całą zawartość 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 serwer01/backup.zip
2026-08-27 12:16:10 2097152 serwer02/backup.zip
2026-08-27 12:20:11 2457 raporty/raport.txt
Limit liczby bucketów¶
Konto może posiadać limit maksymalnej liczby bucketów.
Dokładny limit zależy od parametrów uruchomionej usługi.
Jeżeli osiągniesz limit, utworzenie kolejnego bucketa zakończy się błędem.
W przypadku potrzeby zwiększenia limitu skontaktuj się z Cloud4You.
Pojemność a liczba bucketów¶
Przestrzeń przypisana do użytkownika może być współdzielona pomiędzy jego bucketami.
Przykład:
Przydzielona przestrzeń: 1 TB
firma-backup: 400 GB
firma-archiwum: 250 GB
projekt-a: 100 GB
Łączne wykorzystanie: 750 GB
Pozostało: 250 GB
Utworzenie nowego bucketa nie oznacza automatycznego przydzielenia mu osobnej przestrzeni.
Usuwanie bucketa¶
Pusty bucket można usunąć poleceniem:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
--region eu-pl-1 \
s3api delete-bucket \
--bucket firma-backup
Usuwanie bucketa
Usunięcia bucketa nie należy wykonywać bez upewnienia się, że nie jest już używany przez aplikację, system backupowy lub skrypt.
Bucket musi być pusty¶
Jeżeli bucket zawiera obiekty, jego usunięcie zakończy się błędem:
Najpierw sprawdź jego zawartość:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 ls s3://firma-backup/ --recursive
Jeżeli chcesz usunąć wszystkie aktualnie widoczne obiekty:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 rm s3://firma-backup/ --recursive
Operacja destrukcyjna
Polecenie s3 rm --recursive usuwa wszystkie wskazane obiekty.
Przed jego wykonaniem dokładnie sprawdź nazwę bucketa.
Bucket z włączonym versioningiem¶
Jeżeli bucket ma włączone wersjonowanie, usunięcie aktualnie widocznych obiektów może nie wystarczyć do usunięcia bucketa.
W buckecie mogą nadal znajdować się:
- starsze wersje obiektów,
- Delete Markery.
Sprawdź wersje:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3api list-object-versions \
--bucket firma-backup
Versioning
Bucket z historią wersji wymaga usunięcia wszystkich wersji i Delete Markerów przed jego całkowitym usunięciem.
Buckety prywatne¶
Buckety należy domyślnie traktować jako prywatne.
Dostęp do danych powinien być przyznawany wyłącznie użytkownikom i aplikacjom, które go potrzebują.
Publiczny dostęp
Nie włączaj publicznego dostępu do bucketa, jeżeli nie jest to świadoma i uzasadniona konfiguracja.
Backupy, archiwa i dane firmowe powinny pozostawać prywatne.
Jeden duży bucket czy kilka mniejszych?¶
Nie ma jednej poprawnej odpowiedzi dla każdego przypadku.
Osobne buckety warto stosować, gdy chcesz rozdzielić:
- różne aplikacje,
- różne środowiska,
- różne systemy backupowe,
- różne polityki przechowywania,
- różne poziomy dostępu.
Przykład:
Nie ma potrzeby tworzenia osobnego bucketa dla każdego pojedynczego katalogu lub małej grupy plików.
Zalecenia¶
Przy tworzeniu bucketów:
- stosuj czytelne nazwy,
- używaj małych liter,
- unikaj przypadkowego udostępniania publicznego,
- przed usunięciem zawsze sprawdzaj zawartość,
- pamiętaj o starszych wersjach przy włączonym versioningu,
- nie używaj bucketa do celów, dla których wymagany jest klasyczny filesystem.
Najczęściej używane polecenia¶
Lista bucketów:
Utworzenie:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
--region eu-pl-1 \
s3api create-bucket \
--bucket firma-backup \
--create-bucket-configuration LocationConstraint=eu-pl-1
Lista zawartości:
Usunięcie pustego bucketa: