Słownik pojęć¶
Poniżej znajdziesz najważniejsze pojęcia używane w dokumentacji Cloud4You Object Storage S3.
Access Key¶
Identyfikator użytkownika używany do uwierzytelniania w usłudze S3.
Można traktować go podobnie do loginu.
Przykład:
Access Key jest używany razem z Secret Key.
API¶
API, czyli Application Programming Interface, to interfejs pozwalający aplikacjom komunikować się z usługą.
Cloud4You Object Storage S3 udostępnia interfejs kompatybilny z Amazon S3 API.
Dzięki temu można używać między innymi:
- AWS CLI,
- rclone,
- aplikacji backupowych,
- bibliotek AWS SDK,
- własnych aplikacji.
AWS CLI¶
AWS Command Line Interface to narzędzie działające w terminalu, które pozwala wykonywać operacje na usługach zgodnych z Amazon S3 API.
Przykładowe zastosowania:
- lista bucketów,
- tworzenie bucketów,
- upload,
- download,
- synchronizacja,
- versioning.
Przykład:
Bucket¶
Podstawowy kontener na obiekty w S3.
Przykład:
W buckecie mogą znajdować się obiekty:
Bucket nie jest klasycznym katalogiem systemu plików.
Bucket Policy¶
Zestaw reguł określających, kto i w jaki sposób może uzyskiwać dostęp do bucketa i znajdujących się w nim obiektów.
Polityki mogą określać między innymi:
- możliwość odczytu,
- możliwość zapisu,
- możliwość usuwania,
- dostęp do konkretnych zasobów.
Nie należy nadawać dostępu publicznego bez świadomej potrzeby.
Content-Type¶
Metadana opisująca typ danych przechowywanych w obiekcie.
Przykłady:
Aplikacje mogą wykorzystywać Content-Type do określenia sposobu obsługi obiektu.
Delete Marker¶
Specjalny wpis tworzony przy usuwaniu obiektu z bucketa, który ma włączony versioning.
Delete Marker może sprawić, że obiekt przestanie być widoczny jako aktualna wersja, mimo że wcześniejsze wersje nadal istnieją.
Przykład:
Download¶
Pobranie obiektu z S3 na lokalny komputer lub serwer.
Przykład AWS CLI:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 cp s3://firma-backup/plik.zip .
Endpoint¶
Adres usługi S3.
Główny endpoint Cloud4You:
Endpoint podaje się w konfiguracji klienta S3, aplikacji lub SDK.
ETag¶
Wartość zwracana przez S3 jako część metadanych obiektu.
ETag może być używany przez aplikacje do identyfikacji zmian lub sprawdzania stanu obiektu.
Nie należy jednak zawsze zakładać, że ETag jest zwykłą sumą MD5 pliku, szczególnie w przypadku Multipart Upload.
HTTPS¶
Szyfrowany protokół używany do komunikacji z publicznym endpointem Cloud4You Object Storage S3.
Poprawny adres:
Lifecycle¶
Zestaw reguł pozwalających automatyzować zarządzanie cyklem życia obiektów.
Przykładowe zastosowania:
- usuwanie starych wersji,
- usuwanie danych po określonym czasie,
- czyszczenie nieukończonych Multipart Upload.
Dokładny zakres dostępnych funkcji zależy od konfiguracji usługi.
Metadata¶
Dodatkowe informacje opisujące obiekt.
Mogą zawierać między innymi:
- Content-Type,
- rozmiar,
- datę modyfikacji,
- dane aplikacji,
- własne pola użytkownika.
Multipart Upload¶
Mechanizm pozwalający przesyłać duże obiekty w wielu częściach.
Zamiast wysyłać cały plik jednym żądaniem, klient dzieli go na części.
Przykład:
Po przesłaniu wszystkich części usługa składa je w jeden obiekt.
AWS CLI obsługuje Multipart Upload automatycznie dla dużych plików.
Object¶
Pojedynczy element przechowywany w buckecie.
Najczęściej jest nim plik.
Przykład:
Obiekt posiada między innymi:
- Object Key,
- dane,
- metadane.
Object Key¶
Pełna nazwa obiektu wewnątrz bucketa.
Przykład:
Cały ten ciąg jest kluczem obiektu.
Znaki / mogą być prezentowane jako katalogi, ale technicznie są częścią Object Key.
Object Storage¶
Model przechowywania danych, w którym dane są zapisywane jako obiekty.
Object Storage różni się od:
- storage blokowego,
- lokalnego filesystemu,
- NFS,
- SMB.
Dobrze nadaje się między innymi do:
- backupów,
- archiwizacji,
- dokumentów,
- multimediów,
- dużych zbiorów danych.
Path-style¶
Sposób adresowania bucketa, w którym nazwa bucketa znajduje się w ścieżce URL.
Przykład:
Niektóre aplikacje mają opcję:
lub:
Prefix¶
Początkowa część Object Key wykorzystywana do grupowania obiektów.
Przykładowe klucze:
Prefiksem może być na przykład:
Aplikacje często prezentują prefiksy jako katalogi.
Presigned URL¶
Czasowy, podpisany adres pozwalający uzyskać dostęp do konkretnego obiektu bez przekazywania odbiorcy Access Key i Secret Key.
Przykładowe zastosowania:
- czasowe pobranie pliku,
- udostępnienie dokumentu,
- integracja z aplikacją.
Presigned URL ma ograniczony czas ważności.
Quota¶
Limit przestrzeni przydzielonej użytkownikowi lub usłudze.
Przykład:
Jeżeli użytkownik posiada kilka bucketów, mogą one wspólnie korzystać z tej samej quota.
Region¶
Logiczny region usługi S3.
Cloud4You Object Storage S3 używa regionu:
Region jest wykorzystywany między innymi podczas podpisywania żądań.
Request ID¶
Identyfikator konkretnego żądania przetwarzanego przez usługę.
Request ID jest bardzo przydatny podczas diagnostyki problemów.
Jeżeli aplikacja zwraca Request ID przy błędzie, warto dołączyć go do zgłoszenia technicznego.
rclone¶
Narzędzie do kopiowania i synchronizacji danych między lokalnym systemem a wieloma usługami storage.
Może być używane z Cloud4You Object Storage S3.
Przykład:
S3¶
Popularny interfejs Object Storage pierwotnie opracowany przez Amazon Web Services.
Obecnie wiele systemów storage udostępnia API kompatybilne z Amazon S3.
Cloud4You Object Storage S3 korzysta z takiego modelu dostępu.
S3-compatible¶
Określenie usługi, która udostępnia API zgodne lub kompatybilne z Amazon S3.
Dzięki temu aplikacje obsługujące własny endpoint S3 mogą pracować z usługą inną niż Amazon AWS.
W konfiguracji zazwyczaj trzeba podać własny endpoint:
Secret Key¶
Tajny klucz używany razem z Access Key do podpisywania żądań S3.
Można traktować go podobnie do hasła.
Secret Key jest poufny
Nigdy nie publikuj Secret Key.
Nie wysyłaj go również w standardowych zgłoszeniach technicznych.
Signature¶
Kryptograficzny podpis żądania używany do potwierdzenia, że żądanie zostało utworzone przez użytkownika posiadającego odpowiedni Secret Key.
Nieprawidłowy podpis może powodować błąd:
Sync¶
Operacja synchronizacji źródła i miejsca docelowego.
Przykład AWS CLI:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 sync ./dane/ s3://firma-backup/dane/
Synchronizacja może usuwać dane
Niektóre tryby synchronizacji mogą usuwać dane istniejące wyłącznie w miejscu docelowym.
Przed użyciem opcji usuwających wykonaj test z --dryrun lub --dry-run, jeśli klient to obsługuje.
Tenant¶
Logiczna przestrzeń służąca do oddzielenia zasobów różnych klientów lub użytkowników po stronie usługi.
W standardowej konfiguracji klienta S3 zazwyczaj nie musisz podawać Tenant ID.
Do połączenia wystarczą:
Upload¶
Przesłanie obiektu z lokalnego komputera lub serwera do S3.
Przykład AWS CLI:
aws \
--profile cloud4you \
--endpoint-url https://s3.cloud4you.pl \
s3 cp plik.zip s3://firma-backup/
Version ID¶
Unikalny identyfikator konkretnej wersji obiektu w buckecie z włączonym versioningiem.
Przykład:
Version ID pozwala odwołać się do konkretnej wersji obiektu.
Versioning¶
Mechanizm przechowujący wiele wersji tego samego obiektu.
Przykład:
Versioning może pomóc w ochronie przed przypadkowym nadpisaniem lub usunięciem danych.
Versioning zwiększa wykorzystanie przestrzeni
Każda zachowana wersja obiektu może zajmować miejsce w ramach dostępnej quota.
Virtual-hosted style¶
Sposób adresowania S3, w którym nazwa bucketa znajduje się w nazwie hosta.
Przykład dla bucketa:
Adres może wyglądać tak:
Wiele klientów S3 korzysta z tego sposobu automatycznie.