AWS SDK для .NET

AWS SDK для .NET — это комплект средств разработки для работы с сервисами AWS.

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

1. Создайте сервисный аккаунт.

2. Назначьте сервисному аккаунту роли, которые нужны для вашего проекта, например storage.editor на бакет — для работы с конкретным бакетом, или на каталог — для работы со всеми бакетами в каталоге. Подробнее о ролях см. на странице Управление доступом с помощью Yandex Identity and Access Management.

   Чтобы работать с объектами в зашифрованном бакете, у пользователя или сервисного аккаунта вместе с ролью storage.configurer должны быть следующие роли на ключ шифрования:

   • kms.keys.encrypter — для чтения ключа, шифрования и загрузки объектов;
   • kms.keys.decrypter — для чтения ключа, расшифровки и скачивания объектов;
   • kms.keys.encrypterDecrypter — включает разрешения, предоставляемые ролями kms.keys.encrypter и kms.keys.decrypter.

   Подробнее см. Сервисные роли Key Management Service.

3. Создайте статический ключ доступа.

   В результате вы получите данные статического ключа доступа. Для аутентификации в Object Storage вам понадобятся:

   • key_id — идентификатор статического ключа доступа;
   • secret — секретный ключ.

   Сохраните key_id и secret, так как повторное получение значения ключа будет невозможно.

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

Для установки AWS SDK для .NET воспользуйтесь инструкцией на сайте производителя.

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

1. Создайте директорию для хранения аутентификационных данных и перейдите в нее:

   Для macOS и Linux:

   mkdir ~/.aws/
   

   Для Windows:

   mkdir C:\Users\<имя_пользователя>\.aws\
   

2. В директории .aws создайте файл credentials и скопируйте в него аутентификационные данные, полученные ранее:

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

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

   [default]
   region = ru-central1
   endpoint_url = https://storage.yandexcloud.net
   

   Примечание

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

ОсобенностиОсобенности

• AWS SDK для .NET некорректно обрабатывает конфигурации для жизненных циклов, которые не содержат в себе описания правил (ID). Добавьте описания ко всем правилам жизненного цикла.
• Для доступа к Object Storage, например при работе с классом AmazonS3Config, используйте адрес s3.yandexcloud.net.

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

Чтобы подключиться к Object Storage, используйте код

AmazonS3Config configsS3 = new AmazonS3Config {
    ServiceURL = "https://s3.yandexcloud.net"
};

AmazonS3Client s3client = new AmazonS3Client(configsS3);