AWS SDK for .NET

The AWS SDK for NET is a software development kit for integration with AWS services.

Getting startedGetting started

1. Create a service account.

2. Assign to the service account the roles required for your project, e.g., storage.editor for a bucket (to work with a particular bucket) or a folder (to work with all buckets in this folder). For more information about roles, see Access management with Yandex Identity and Access Management.

   To work with objects in an encrypted bucket, a user or service account must have the following roles for the encryption key in addition to the storage.configurer role:

   • kms.keys.encrypter: To read the key, encrypt and upload objects.
   • kms.keys.decrypter: To read the key, decrypt and download objects.
   • kms.keys.encrypterDecrypter: This role includes the kms.keys.encrypter and kms.keys.decrypter permissions.

   For more information, see Key Management Service service roles.

3. Create a static access key.

   As a result, you will get the static access key data. To authenticate in Object Storage, you will need the following:

   • key_id: Static access key ID
   • secret: Secret key

   Save key_id and secret: you will not be able to get the key value again.

InstallationInstallation

To install the AWS SDK for.NET, follow the instructions on the manufacturer's website.

ConfigurationConfiguration

1. Create a directory to store the authentication data in and navigate to it:

   For macOS and Linux:

   mkdir ~/.aws/
   

   For Windows:

   mkdir C:\Users\<username>\.aws\
   

2. In the .aws directory, create a file named credentials with credentials for Object Storage and copy the following data into it:

   [default]
   aws_access_key_id = <static_key_ID>
   aws_secret_access_key = <secret_key>
   

3. Create a file named config with the default region settings and copy the following information to it:

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

   Note

   Some apps designed to work with Amazon S3 do not allow you to specify the region; this is why Object Storage may also accept the us-east-1 value.

FeaturesFeatures

• The AWS SDK for .NET incorrectly handles lifecycle configurations that contain no rule description (ID). Make sure to add a description to each lifecycle rule.
• To access Object Storage, e.g., when working with the AmazonS3Config class, use the s3.yandexcloud.net address.

Code examplesCode examples

To connect to Object Storage, use this code:

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

AmazonS3Client s3client = new AmazonS3Client(configsS3);