.. _AwsSdkNetManual:

################
AWS SDK для .NET
################

**********************************
Использование S3 через aws-sdk-net
**********************************

Для подключения AWS SDK для .NET (AWSSDK.core версии 3.3.22.3 или старше) к объектному хранилищу Облака КРОК необходимо выполнить следующие шаги:

1. `Скачать <https://docs.cloud.croc.ru/ru/api/tools/c2-ec2.html#id3>`__ параметры подключения к Облаку КРОК в виде текстового файла ``.sh``.

2. Установить в переменные окружения параметры подключения к Облаку КРОК.

3. Создать проект .NET и добавить в него пакеты *AWSSDK.Core* и *AWSSDK.S3* `из документации aws-sdk <https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/net-dg-install-assemblies.html>`__.

4. Добавить в проект файл ``endpoints.json`` и установить ему ``Copy to Output Directory: Copy always`` (либо положить этот файл в уже собранную директорию с приложением).

   .. dropdown:: ``endpoints.json``
      :open:

      .. code-block:: json

         {
           "endpoints": {
             "croc/s3": {
               "endpoint": "storage.cloud.{region}.ru",
               "auth-region": "croc"
             },
             "croc/ec2": {
               "endpoint": "monitoring.cloud.{region}.ru",
               "auth-region": "croc"
             },
             "croc/monitoring": {
               "endpoint": "api.cloud.{region}.ru"
             }
           },
           "partitions": [
             {
               "defaults": {
                 "protocols": [ "https" ],
                 "signatureVersions": [ "v4" ]
               },
               "dnsSuffix": "cloud.croc.ru",
               "partition": "croc",
               "partitionName": "CROC Cloud",
               "regionRegex": "^croc$",
               "regions": {
                 "croc": {
                   "description": "Main CROC Cloud region"
                 }
               },
               "services": {
                 "ec2": {
                   "defaults": {
                     "hostname": "api.cloud.{region}.ru",
                     "protocols": [ "http", "https" ]
                   },
                   "endpoints": {
                     "croc": {}
                   }
                 },
                 "monitoring": {
                   "defaults": {
                     "hostname": "monitoring.cloud.{region}.ru",
                     "protocols": [ "http", "https" ]
                   },
                   "endpoints": {
                     "croc": {}
                   }
                 },
                 "s3": {
                   "defaults": {
                     "hostname": "storage.cloud.{region}.ru",
                     "protocols": [ "http", "https" ],
                     "signatureVersions": [ "s3", "s3v4" ]
                   },
                   "endpoints": {
                     "croc": {}
                   }
                 }
               }
             }
           ],
           "version": 3
         }

5. Прописать в конфигурационном файле ``App.config`` раздел ``aws``:

   .. code-block:: xml
      :caption: ``App.config``

      <aws region="croc"/>

6. Создать клиента api:

   .. code-block:: csharp
      :caption: ``Program.cs``

      var client = new AmazonS3Client();