AWS SDK для JavaScript

AWS SDK для JavaScript — это комплект средств разработки для взаимодействия с сервисами AWS, совместимый с Yandex Object Storage.

Подготовка к работеПодготовка к работе

1. Создайте сервисный аккаунт.
2. Назначьте сервисному аккаунту роли, необходимые для вашего проекта. Подробнее о ролях см. в документации Identity and Access Management.
3. Создайте статический ключ доступа.

УстановкаУстановка

Чтобы установить AWS SDK для JavaScript:

1. Установите Node.js.

2. Склонируйте репозиторий AWS SDK Code Examples. Для этого в терминале выполните команду:

   git clone https://github.com/awsdocs/aws-doc-sdk-examples
   

НастройкаНастройка

1. Перейдите в директорию ~/.aws/ (для macOS и Linux) или C:\Users\<имя_пользователя>\.aws\ (для Windows).

2. Создайте файл credentials с аутентификационными данными для Object Storage и скопируйте в него следующую информацию:

   [default]
     aws_access_key_id = <идентификатор_статического_ключа>
     aws_secret_access_key = <секретный_ключ>
   

3. Создайте файл config с параметрами региона по умолчанию и скопируйте в него следующую информацию:

   [default]
     region=ru-central1
   

   Примечание

   Некоторые приложения, предназначенные для работы с Amazon S3, не позволяют указывать регион, поэтому Object Storage принимает также значение us-east-1.

Для доступа к Object Storage используйте эндпоинт https://storage.yandexcloud.net.

Примеры кодаПримеры кода

Пример кода для создания бакета находится в директории javascriptv3/example_code/nodegetstarted/src репозитория.

Чтобы подключиться к Object Storage и создать бакет:

1. Установите зависимости, описанные в файле javascriptv3/example_code/nodegetstarted/package.json:

   npm install node -g
   cd aws-doc-sdk-examples/javascriptv3/example_code/nodegetstarted
   npm install
   

2. В директории javascriptv3/example_code/nodegetstarted/src/libs/ откройте файл s3Client.js с описанием клиента для Object Storage.

3. Замените содержимое файла на следующий код:

   import { S3Client } from "@aws-sdk/client-s3";
   // Установка региона Object Storage
   const REGION = "ru-central1";
   // Установка эндпоинта Object Storage
   const ENDPOINT = "https://storage.yandexcloud.net";
   // Создание клиента для Object Storage
   const s3Client = new S3Client({ region: REGION, endpoint: ENDPOINT });
   export { s3Client };
   

4. В директории javascriptv3/example_code/nodegetstarted/src/ откройте файл sample.js с кодом для создания бакета и объекта в нем.

   Содержимое sample.js

   // Импорт клиентов и команд AWS SDK для работы с Node.js
   import { PutObjectCommand, CreateBucketCommand } from "@aws-sdk/client-s3";
   import { s3Client } from "./libs/s3Client.js";
   
   // Установка параметров
   const params = {
     Bucket: "<имя_бакета>", // Имя бакета, например 'sample-bucket-101'.
     Key: "<имя_объекта>", // Имя объекта, например 'sample_upload.txt'.
     Body: "<содержимое_объекта>", // Содержимое объекта, например 'Hello world!".
   };
   
   const run = async () => {
     // Создание бакета
     try {
       const data = await s3Client.send(
           new CreateBucketCommand({ Bucket: params.Bucket })
       );
       console.log(data);
       console.log("Successfully created a bucket called ", data.Location);
       return data; // Для модульного тестирования.
     } catch (err) {
       console.log("Error", err);
     }
     // Создание объекта и загрузка его в бакет
     try {
       const results = await s3Client.send(new PutObjectCommand(params));
       console.log(
           "Successfully created " +
           params.Key +
           " and uploaded it to " +
           params.Bucket +
           "/" +
           params.Key
       );
       return results; // Для модульного тестирования.
     } catch (err) {
       console.log("Error", err);
     }
   };
   run();
   

5. В блоке const params задайте имя бакета, имя и содержимое объекта в бакете.

6. Запустите приложение:

   node sample.js
   

Подробности о работе с AWS SDK для JavaScript см. в документации AWS.