Получить ссылку на объект

Вы можете:

• получить ссылку на объект в публичном бакете — все объекты доступны через публичные домены хранилища;
• получить ссылку на объект в приватном бакете — ссылку можно сделать постоянной или временной.

Мы не рекомендуем использовать кириллицу в именах объектов. Если вы используете кириллицу, для работы с ссылками на такие объекты кодируйте часть ссылки с кириллицей.

Получить ссылку на объект в публичном бакете

1. В панели управления в верхнем меню нажмите Продукты и выберите S3.
2. Перейдите в раздел Бакеты.
3. Откройте страницу бакета → вкладка Объекты.
4. В строке с объектом нажмите .
5. В строке с ссылкой нажмите .

Получить ссылку на объект в приватном бакете

Вы можете:

• создать постоянную или временную ссылку в панели управления. Ссылка будет сохранена в специальном бакете links в виде объекта с таким же именем, как у объекта, на который указывает ссылка. Доступ к объекту будет через публичный домен бакета links;
• получить временную ссылку через подписанный URL;
• получить постоянную ссылку через скрипт;
• получить постоянную или временную ссылку через инструменты, например Rclone, AWS CLI, Cyberduck и S3 Browser.

Создать ссылку в панели управления

Вы можете получить временную или постоянную ссылку на объект в приватном бакете.

Объект в приватном бакете будет доступен по ссылке вида https://<bucket_public_domain>/<object_name>, где:

• <bucket_public_domain> — публичный домен бакета;
• <object_name> — имя объекта.

Когда вы впервые создаете ссылку на объект в приватном бакете, в проекте автоматически создается публичный бакет links. Созданная ссылка добавляется в него в виде объекта с таким же именем, как у основного объекта. Объекты в бакете links имеют нулевой размер и не потребляют объем хранения. Если вы настроите ссылку как временную, объект со ссылкой автоматически удалится из бакета links, когда ссылка перестанет работать.

Чтобы создать ссылку:

1. В панели управления в верхнем меню нажмите Продукты и выберите S3.

2. Перейдите в раздел Бакеты.

3. Откройте страницу бакета → вкладка Объекты.

4. В меню объекта выберите Открыть доступ.

5. Опционально: в поле Адрес ссылки измените имя объекта, которое будет отображаться в ссылке, или оставьте текущее.

6. Опционально: чтобы по ссылке можно было перейти только один раз, отметьте чекбокс Одноразовая ссылка.

7. Опционально: чтобы ограничить время действия ссылки, отметьте чекбокс Временные ограничения и выберите один из вариантов:

   • Удалить через — ссылка перестанет работать через выбранный промежуток времени после создания;
   • Удалить в указанное время — ссылка перестанет работать в выбранную дату и время.

8. Нажмите Создать ссылку.

9. Чтобы скопировать ссылку, нажмите . Вы сможете скопировать ее позднее в бакете links.

Получить временную ссылку через подписанный URL

С помощью подписанных URL (Presigned URLs) AWS SDK можно получить временную ссылку на объект. Подробнее в инструкции Sharing objects with presigned URLs документации AWS.

Python

Пример скрипта:

import boto3

ACCESS_KEY = "<access_key>"      
SECRET_KEY = "<secret_key>"      
ENDPOINT_URL = "<s3_domain>" 
BUCKET_NAME = "<bucket_name>"       
OBJECT_KEY = "<path_to_object>"      
EXPIRES_IN = "<time>"

s3 = boto3.client(
    "s3",
    aws_access_key_id=ACCESS_KEY,
    aws_secret_access_key=SECRET_KEY,
    endpoint_url=ENDPOINT_URL,
)

url = s3.generate_presigned_url(
    ClientMethod="get_object",
    Params={"Bucket": BUCKET_NAME, "Key": OBJECT_KEY},
    ExpiresIn=EXPIRES_IN
)

print("\PresignedUrl
:")
print(url)

Укажите:

• <access_key> — значение поля Access key из S3-ключа;
• <secret_key> — значение поля Secret key из S3-ключа;
• <s3_domain> — домен S3 API в зависимости от пула, в котором находится бакет;
• <bucket_name> — имя бакета;
• <path_to_object> — путь к объекту в бакете;
• <time> — время действия ссылки в секундах.

PHP

Пример скрипта:

<?php
require 'vendor/autoload.php';

use Aws\S3\S3Client;
use Aws\Exception\AwsException;

$servercoreS3 = new S3Client([
    'version' => 'latest',
    'region'  => '<pool>',
    'endpoint' => '<s3_domain>':,
    'use_path_style_endpoint' => true,
    'credentials' => [
        'key'    => '<access_key>',
        'secret' => '<secret_key>',
    ],
]);

$bucket = '<bucket_name>';
$key = '<path_to_object>';

try {
    $cmd = $servercoreS3->getCommand('GetObject', [
        'Bucket' => $bucket,
        'Key'    => $key
    ]);

    $request = $servercoreS3->createPresignedRequest($cmd, '<time>');
    $presignedUrl = (string)$request->getUri();

    echo "Публичная ссылка: $presignedUrl\n";
} catch (AwsException $e) {
    echo "Ошибка генерации ссылки: " . $e->getMessage() . "\n";
}

Укажите:

• <pool> — пул, в котором находится бакет;
• <s3_domain> — домен S3 API в зависимости от пула, в котором находится бакет;
• <access_key> — значение поля Access key из S3-ключа;
• <secret_key> — значение поля Secret key из S3-ключа;
• <bucket_name> — имя бакета;
• <path_to_object> — путь к объекту в бакете;
• <time> — время действия ссылки, например +1 hour.

JavaScript

Пример скрипта:

import { S3Client, GetObjectCommand } from "@aws-sdk/client-s3";
import { getSignedUrl } from "@aws-sdk/s3-request-presigner";

const client = new S3Client({
region: "<pool>",
endpoint: "<s3_domain>",
forcePathStyle: true,
credentials: {
    accessKeyId: "<access_key>",
    secretAccessKey: "<secret_key>",
},
});

async function generatePresignedUrl() {
const bucket = "<bucket_name>";   
const key = "<path_to_object>";          

const command = new GetObjectCommand({ Bucket: bucket, Key: key });

const url = await getSignedUrl(client, command, { expiresIn: <time> });
console.log("Presigned URL:", url);
}

generatePresignedUrl().catch(console.error);

Укажите:

• <pool> — пул, в котором находится бакет;
• <s3_domain> — домен S3 API в зависимости от пула, в котором находится бакет;
• <access_key> — значение поля Access key из S3-ключа;
• <secret_key> — значение поля Secret key из S3-ключа;
• <bucket_name> — имя бакета;
• <path_to_object> — путь к объекту в бакете;
• <time> — время действия ссылки в секундах.

Java

Пример скрипта:

package com.example;

import software.amazon.awssdk.auth.credentials.AwsBasicCredentials;
import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3.S3Client;
import software.amazon.awssdk.services.s3.model.GetObjectRequest;
import software.amazon.awssdk.services.s3.model.S3Exception;
import software.amazon.awssdk.services.s3.presigner.S3Presigner;
import software.amazon.awssdk.services.s3.presigner.model.GetObjectPresignRequest;
import software.amazon.awssdk.services.s3.presigner.model.PresignedGetObjectRequest;

import java.net.URI;
import java.time.Duration;

public class ServercoreS3PresignedUrlGenerator {
    public static void main(String[] args) {

        String endpoint = "<s3_domain>"; 
        String region = "<pool>";
        String accessKey = "<access_key>";
        String secretKey = "<secret_key>";
        String bucketName = "<bucket_name>";
        String objectKey = "<path_to_object>";

        StaticCredentialsProvider credentials = StaticCredentialsProvider.create(
                AwsBasicCredentials.create(accessKey, secretKey)
        );

        S3Client s3Client = S3Client.builder()
                .endpointOverride(URI.create(endpoint))
                .region(Region.of(region))
                .credentialsProvider(credentials)
                .build();

        S3Presigner presigner = S3Presigner.builder()
                .endpointOverride(URI.create(endpoint))
                .region(Region.of(region))
                .credentialsProvider(credentials)
                .build();

        try {
            GetObjectRequest getObjectRequest = GetObjectRequest.builder()
                    .bucket(bucketName)
                    .key(objectKey)
                    .build();

            GetObjectPresignRequest presignRequest = GetObjectPresignRequest.builder()
                    .signatureDuration(Duration.ofMinutes(<time>))
                    .getObjectRequest(getObjectRequest)
                    .build();

            PresignedGetObjectRequest presignedRequest = presigner.presignGetObject(presignRequest);

            System.out.println("Presigned URL: " + presignedRequest.url());
            System.out.println("Expires at: " + presignedRequest.expiration());

        } catch (S3Exception e) {
            System.err.println("Ошибка при генерации presigned URL: " + e.awsErrorDetails().errorMessage());
        } finally {
            s3Client.close();
            presigner.close();
        }
    }
}

Укажите:

• <s3_domain> — домен S3 API в зависимости от пула, в котором находится бакет;
• <pool> — пул, в котором находится бакет;
• <access_key> — значение поля Access key из S3-ключа;
• <secret_key> — значение поля Secret key из S3-ключа;
• <bucket_name> — имя бакета;
• <path_to_object> — путь к объекту в бакете;
• <time> — время действия ссылки в минутах.

Go

Пример скрипта:

package main 
import (
    "context"
    "fmt"
    "log"
    "time"
    "github.com/aws/aws-sdk-go-v2/aws"
    "github.com/aws/aws-sdk-go-v2/config"
    "github.com/aws/aws-sdk-go-v2/credentials"
    "github.com/aws/aws-sdk-go-v2/service/s3"
)
func main() {
    cfg, err := config.LoadDefaultConfig(context.TODO(),
        config.WithCredentialsProvider(
            credentials.NewStaticCredentialsProvider("<access_key>", "<secret_key>", ""),
        ),
    )
    if err != nil {
        log.Fatal(err.Error())
    }
    client := s3.NewFromConfig(cfg, func(o *s3.Options) {
        o.BaseEndpoint = aws.String("<s3_domain>")
        o.Region = "<pool>"
    })
    presignClient := s3.NewPresignClient(client)
    req, err := presignClient.PresignGetObject(context.TODO(), &s3.GetObjectInput{
        Bucket: aws.String("<bucket_name>"),
        Key:    aws.String("<path_to_object>"),
    }, s3.WithPresignExpires(<time>))
    if err != nil {
        log.Fatal(err.Error())
    }
    fmt.Println("Публичная ссылка:", req.URL)
}

Укажите:

• <access_key> — значение поля Access key из S3-ключа;
• <secret_key> — значение поля Secret key из S3-ключа;
• <s3_domain> — домен S3 API в зависимости от пула, в котором находится бакет;
• <pool> — пул, в котором находится бакет;
• <bucket_name> — имя бакета;
• <path_to_object> — путь к объекту в бакете;
• <time> — время действия ссылки, например 24*time.Hour.

Получить постоянную ссылку через скрипт

Python

Пример скрипта:

import boto3

def get_public_url(bucket_uuid: str, object_key: str) -> str:
    
    return f"https://{bucket_uuid}.selstorage.ru/{object_key}"

if __name__ == "<python_file_name>":
    bucket_uuid = "<uuid>"
    object_key = "<path_to_object>"
    url = get_public_url(bucket_uuid, object_key)
    print("Public URL:", url)

Укажите:

• <python_file_name> — имя файла;
• <uuid> — уникальный идентификатор бакета, можно посмотреть в публичном домене бакета;
• <path_to_object> — путь к объекту в бакете.

PHP

Пример скрипта:

<?php
function get_public_url(string $bucket_uuid, string $object_key): string {
    return "https://{$bucket_uuid}.selstorage.ru/{$object_key}";
}

$bucket_uuid = "<uuid>";
$object_key = "<path_to_object>";

$public_url = get_public_url($bucket_uuid, $object_key);
echo "Public URL: " . $public_url . PHP_EOL;

Укажите:

• <uuid> — уникальный идентификатор бакета, можно посмотреть в публичном домене бакета;
• <path_to_object> — путь к объекту в бакете.

JavaScript

Пример скрипта:

function getPublicUrl(bucketUuid, objectKey) {
    return `https://${bucketUuid}.selstorage.ru/${objectKey}`;
}

const bucketUuid = "<uuid>";
const objectKey = "<path_to_object>";

const publicUrl = getPublicUrl(bucketUuid, objectKey);
console.log("Public URL:", publicUrl);

Укажите:

• <uuid> — уникальный идентификатор бакета, можно посмотреть в публичном домене бакета;
• <path_to_object> — путь к объекту в бакете.

Java

Пример скрипта:

public class ServercorePublicLink {

    public static String getPublicUrl(String bucketUuid, String objectKey) {
        return "https://" + bucketUuid + ".selstorage.ru/" + objectKey;
    }

    public static void main(String[] args) {

        String bucketUuid = "<uuid>";
        String objectKey = "<path_to_object>";

        String publicUrl = getPublicUrl(bucketUuid, objectKey);
        System.out.println("Public URL: " + publicUrl);
    }
}

Укажите:

• <uuid> — уникальный идентификатор бакета, можно посмотреть в публичном домене бакета;
• <path_to_object> — путь к объекту в бакете.

Go

Пример скрипта:

package main

import (
    "fmt"
)

func getPublicURL(bucketUUID, objectKey string) string {
    return fmt.Sprintf("https://%s.selstorage.ru/%s", bucketUUID, objectKey)
}

func main() {

    bucketUUID := "<uuid>"
    objectKey := "<path_to_object>"

    publicURL := getPublicURL(bucketUUID, objectKey)
    fmt.Println("Public URL:", publicURL)
}

Укажите:

• <uuid> — уникальный идентификатор бакета, можно посмотреть в публичном домене бакета;
• <path_to_object> — путь к объекту в бакете.