amazon-s3 учебник
Начало работы с amazon-s3

замечания

Версии

Установка CLI AWS для доступа к S3

Установка aws cli в Ubuntu / Debian Instance

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

Установка aws cli с использованием python

Используя pip, вы можете установить aws cli в windows, OS X и Linux

sudo pip install awscli

Настройка интерфейса командной строки AWS

В этом разделе объясняется, как настроить параметры, используемые интерфейсом командной строки AWS при взаимодействии с AWS, например, ваши учетные данные безопасности и область по умолчанию.

$ 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

Получить ключ доступа и секретный ключ со страницы учетной записи в AWS

Создание ковшей

Используйте команду aws s3 mb для создания нового ведра. Имена контейнеров должны быть уникальными и должны соответствовать требованиям DNS. Имена ковша могут содержать строчные буквы, цифры, дефисы и периоды

aws s3 mb s3://bucket-name

Удаление ковшей

Чтобы удалить ведро, используйте команду aws s3 rb. По умолчанию ведро должно быть пустым.

aws s3 rb s3://bucket-name

Чтобы удалить непустое ведро, вам необходимо включить параметр -force.

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

Листинговые ковши

Чтобы перечислить все ведра или их содержимое, используйте команду aws s3 ls

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

Следующая команда перечисляет объекты в bucket-name / path

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

Синхронизация файлов между локальной файловой системой и S3

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

Он загрузит все файлы в текущем каталоге на S3. Чтобы загрузить файлы из S3 в текущий каталог, выполните

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

Список команд AWS CLI S3

Список часто используемых команд консоли S3 AWS

Создать ведро

aws s3 mb s3://bucket-name

Удалить ведро

aws s3 rb s3://bucket-name

Список ковшей

aws s3 ls

Список содержимого внутри ведра

aws s3 ls s3://bucket-name

Список ведра с дорожкой

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

Копировать файл

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

Синхронизировать файлы

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

Удалить локальный файл

rm ./MyFile1.txt

Попытка синхронизации без опции --delete - ничего не происходит

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

Синхронизация с удалением - объект удаляется из ведра

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

Удалить объект из ведра

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

Синхронизация с удалением - удаляется локальный файл

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

Синхронизация с классом хранения нечетного доступа

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

Скопируйте файл MyFile.txt в текущий каталог на s3: // my-bucket / path

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

Переместите все .jpg файлы в s3: // my-bucket / путь к ./MyDirectory

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

Список содержимого моего ведра

aws s3 ls s3://my-bucket

Перечислить содержимое пути в моем ковше

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

Удалить s3: //my-bucket/path/MyFile.txt

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

Удалить s3: // my-bucket / path и все его содержимое

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

Пример Hello World с использованием Java

Этот пример пытается создать ведро, называемое «hello-world», и, поскольку ведро hello-world уже создано кем-то еще в глобальном пространстве имен S3, выдает следующее исключение. Измените «hello-world» на что-то еще, чтобы избежать исключения, создав одноименный ведро. Созданное таким образом новое ведро можно удалить с помощью консоли AWS

Исключение в потоке «main» com.amazonaws.services.s3.model.AmazonS3Exception: запрошенное имя ковша недоступно. Пространство имен ведра используется всеми пользователями системы. Выберите другое имя и повторите попытку. (Сервис: Amazon S3; Код состояния: 409; Код ошибки: BucketAlreadyExists; Идентификатор запроса: ...

           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.");
                    }
            }

Этот пример требует следующих зависимостей:

• Java установлена ​​с консолью.
• Установлен AWS Java SDK. https://aws.amazon.com/sdk-for-java/
• Учетные credentials учетных credentials установленных в .aws в вашем домашнем каталоге. https://aws.amazon.com/developers/getting-started/java/
• Учетные данные для администрирования или создания прав на ведро в S3. http://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-buckets

Привет, мир, используя PowerShell

Этот пример ожидает ошибки, поскольку ведро hello-world уже существует, а S3 использует глобальное пространство имен.

    New-S3Bucket -BucketName "hello-world"

New-S3Bucket: запрашиваемое имя ковша недоступно. Пространство имен ведра используется всеми пользователями системы. Выберите другое имя и повторите попытку.

Если вы замените hello-world другим уникальным, то ведро будет создано без ошибок, и вы получите следующий результат:

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

Этот пример требует следующих зависимостей:

• PowerShell. См. Http://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html.

• Полномочия. Они могут быть созданы с помощью консоли AWS. Существует несколько вариантов управления ими с помощью PowerShell. Ниже приведен простой пример настройки. См. 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