amazon-s3 Samouczek
Rozpoczęcie pracy z amazon-s3

Uwagi

Wersje

Instalacja interfejsu AWS CLI w celu uzyskania dostępu do S3

Instalowanie aws cli w Instancji Ubuntu / Debian

sudo apt-get install -y python-dev python-pip
sudo pip install awscli
aws --version
aws configure

Instalowanie aws cli przy użyciu Pythona

Za pomocą pip możesz zainstalować aws cli w Windows, OS X i Linux

sudo pip install awscli

Konfigurowanie interfejsu wiersza polecenia AWS

W tej sekcji wyjaśniono, jak skonfigurować ustawienia używane przez interfejs wiersza polecenia AWS podczas interakcji z AWS, takie jak poświadczenia bezpieczeństwa i region domyślny.

$ aws configure
AWS Access Key ID [None]: <Your access key >
AWS Secret Access Key [None]: <Your secret key>
Default region name [None]: us-west-2
Default output format [None]: json

Uzyskaj klucz dostępu i klucz tajny ze strony konta w AWS

Tworzenie wiader

Użyj polecenia aws s3 mb, aby utworzyć nowy segment. Nazwy segmentów muszą być unikalne i powinny być zgodne z systemem DNS. Nazwy segmentów mogą zawierać małe litery, cyfry, łączniki i kropki

aws s3 mb s3://bucket-name

Usuwanie wiader

Aby usunąć segment, użyj komendy aws s3 rb. Domyślnie segment powinien być pusty.

aws s3 rb s3://bucket-name

Aby usunąć niepuste wiadro, musisz dołączyć opcję --force.

aws s3 rb s3://bucket-name --force

Wiadra aukcyjne

Aby wyświetlić listę wszystkich segmentów lub ich zawartości, użyj polecenia aws s3 ls

aws s3 ls
aws s3 ls s3://bucket-name

Następujące polecenie wyświetla listę obiektów w wiadro-nazwa / ścieżka

aws s3 ls s3://bucket-name/path

Synchronizuj pliki między lokalnym systemem plików a S3

aws s3 sync . s3://my-bucket/path 

Prześle wszystkie pliki z bieżącego katalogu do S3. Aby pobrać pliki z S3 do bieżącego katalogu, uruchom

aws s3 sync s3://my-bucket/path .

Lista poleceń AWS CLI S3

Lista często używanych poleceń S3 AWS CLI

Utwórz wiadro

aws s3 mb s3://bucket-name

Usuń wiadro

aws s3 rb s3://bucket-name

Lista wiader

aws s3 ls

Wyświetl zawartość w wiadrze

aws s3 ls s3://bucket-name

Lista Wiadro ze ścieżką

aws s3 ls s3://bucket-name/path

Skopiować plik

aws s3 cp file.txt s3://my-bucket/ 

Synchronizuj pliki

aws s3 sync . s3://my-bucket/path

Usuń plik lokalny

rm ./MyFile1.txt

Próba synchronizacji bez opcji --delete - nic się nie dzieje

aws s3 sync . s3://my-bucket/path

Synchronizuj z usuwaniem - obiekt jest usuwany z wiadra

aws s3 sync . s3://my-bucket/path --delete

Usuń obiekt z wiadra

aws s3 rm s3://my-bucket/path/MySubdirectory/MyFile3.txt

Synchronizuj z usuwaniem - plik lokalny jest usuwany

aws s3 sync s3://my-bucket/path . --delete

Synchronizuj z klasą pamięci o rzadkim dostępie

aws s3 sync . s3://my-bucket/path --storage-class STANDARD_IA

Skopiuj MyFile.txt z bieżącego katalogu do s3: // my-bucket / path

aws s3 cp MyFile.txt s3://my-bucket/path/

Przenieś wszystkie pliki .jpg z s3: // my-bucket / path do ./MyDirectory

aws s3 mv s3://my-bucket/path ./MyDirectory --exclude '*' --include '*.jpg' --recursive

Wyświetl zawartość mojego wiadra

aws s3 ls s3://my-bucket

Wyświetl zawartość ścieżki w moim wiadrze

aws s3 ls s3://my-bucket/path

Usuń s3: //my-bucket/path/MyFile.txt

aws s3 rm s3://my-bucket/path/MyFile.txt

Usuń s3: // my-bucket / path i całą jego zawartość

aws s3 rm s3://my-bucket/path --recursive

Przykład Hello World przy użyciu Java

W tym przykładzie podjęto próbę utworzenia segmentu o nazwie „hello-world”, a ponieważ element hello-world został już utworzony przez kogoś innego w globalnej przestrzeni nazw S3, zgłasza następujący wyjątek. Zmień „hello-world” na coś innego, aby uniknąć wyjątku, tworząc unikatowy wiadro. Tak utworzony nowy segment można usunąć za pomocą konsoli AWS

Wyjątek w wątku „main” com.amazonaws.services.s3.model.AmazonS3 Wyjątek: Żądana nazwa segmentu nie jest dostępna. Przestrzeń nazw segmentu jest wspólna dla wszystkich użytkowników systemu. Wybierz inną nazwę i spróbuj ponownie. (Usługa: Amazon S3; Kod statusu: 409; Kod błędu: BucketAlreadyExists; Identyfikator żądania: ...

           import com.amazonaws.services.s3.AmazonS3;
           import com.amazonaws.services.s3.AmazonS3ClientBuilder;
           import com.amazonaws.services.s3.model.CreateBucketRequest;
           import com.amazonaws.services.s3.model.Bucket;

            /** S3 "hello world" example. */
            public class S3Hello {

                    /** Name of hello-world bucket -- must be globally unique.  The
                     *  bucket namespace is shared by all users of the system.
                     */
                    static final String BUCKET_NAME = "hello-world";

                    /** Creates bucket
                     *  @param args Command line arguments
                     */
                    public static void main(final String[] args) {

                            AmazonS3 s3 = AmazonS3ClientBuilder.defaultClient();

                            CreateBucketRequest request
                                 = new CreateBucketRequest(BUCKET_NAME);

                            Bucket bucket = s3.createBucket(request);
                            System.out.println("S3 Hello World completed.");
                    }
            }

Ten przykład wymaga następujących zależności:

• Java zainstalowana z działającą konsolą.
• Zainstalowano AWS Java SDK. https://aws.amazon.com/sdk-for-java/
• Poświadczenia pliku credentials skonfigurowane w .aws w katalogu domowym. https://aws.amazon.com/developers/getting-started/java/
• Poświadczenie posiadania uprawnień administratora lub „tworzenia segmentu” w S3. http://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-buckets

Witaj świecie za pomocą programu PowerShell

Ten przykład oczekuje błędu, ponieważ wiadro hello-world już istnieje, a S3 używa globalnej przestrzeni nazw.

    New-S3Bucket -BucketName "hello-world"

New-S3Bucket: Żądana nazwa segmentu jest niedostępna. Przestrzeń nazw segmentu jest wspólna dla wszystkich użytkowników systemu. Wybierz inną nazwę i spróbuj ponownie.

Jeśli zastąpisz hello-world czymś innym, co jest unikalne, segment zostanie utworzony bez błędów i uzyskasz następujący wynik:

    CreationDate                                      BucketName
    ------------                                      ----------
    3/30/2017 11:43:03 PM                             hello-world-832jklsdJF

Ten przykład wymaga następujących zależności:

• PowerShell. Zobacz http://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html

• Kwalifikacje. Można je utworzyć za pomocą konsoli AWS. Istnieje kilka opcji zarządzania nimi za pomocą PowerShell. Poniżej znajduje się prosty przykład konfiguracji. Zobacz http://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html

    PS C:\> Set-AWSCredentials -AccessKey AKIAIOSFODNN7LAJD8A 
           -SecretKey  "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEjw9JFKS3" -StoreAs default