AWS SDK for Java

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

Getting startedGetting started

1. Create a service account.
2. Assign the service account the roles required for your project. For more information about roles, see the Identity and Access Management documentation.
3. Create a static access key.

InstallationInstallation

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

SetupSetup

1. Go to the ~/.aws/ directory (for macOS and Linux) or C:\Users\<username>\.aws\ (for Windows).

2. Create a file named credentials with the credentials for Object Storage and copy the following information to 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.

To access Object Storage, use the https://storage.yandexcloud.net endpoint.

Code snippetsCode snippets

The sample code is located in the aws-java-sdk/samples/AmazonS3 folder in the SDK distribution archive.

To connect to Object Storage, replace the code in the sample:

AmazonS3 s3 = AmazonS3ClientBuilder.standard()
    .withCredentials(new AWSStaticCredentialsProvider(credentials))
    .withRegion("us-west-2")
    .build();

to

AmazonS3 s3 = AmazonS3ClientBuilder.standard()
    .withCredentials(new AWSStaticCredentialsProvider(credentials))
    .withEndpointConfiguration(
        new AmazonS3ClientBuilder.EndpointConfiguration(
            "storage.yandexcloud.net","ru-central1"
        )
    )
    .build();