Get a link to an object
You can:
- get a link to an object in a public bucket — all objects are available through public domains of the storage;
- get a link to an object in a private bucket — a link can be made permanent or temporary.
We do not recommend using Cyrillic in object names. If you use Cyrillic, encode the Cyrillic part of the link to work with links to such objects.
Get a link to an object in a public bucket
- In the control panel, on the top menu, click Products and select S3.
- Перейдите in раздел Бакеты.
- Откройте страницу бакета → вкладка Объекты.
- In the object line, click .
- In the link line, click .
Get a link to an object in a private bucket
You can:
- create a permanent or temporary link in the control panel. The link will be saved in a special
linksbucket as an object with the same name as the object the link points to. The object will be accessible via the bucket public domainlinks; - get a temporary link via a presigned URL;
- get a permanent link via a script;
- get a permanent or temporary link using tools, for example, Rclone, AWS CLI, Cyberduck and S3 Browser.
Create a link in the control panel
You can get a temporary or permanent link to an object in a private bucket.
An object in a private bucket will be available via a link of the type https://<bucket_public_domain>/<object_name>, where:
<bucket_public_domain>— bucket public domain;<object_name>— the object name.
When you first create a link to an object in a private bucket, a public links bucket is automatically created in the project. The created link is added to it as an object with the same name as the main object. Objects in the links bucket have zero size and do not consume storage volume. If you set the link to be temporary, the object with the link will be automatically deleted from the links bucket when the link stops working.
To create a link:
-
In the control panel, on the top menu, click Products and select S3.
-
Перейдите in раздел Бакеты.
-
Откройте страницу бакета → вкладка Объекты.
-
In the menu for the object, select Share.
-
Optional: in the Link URL field, change the object name that will display in the link or leave the current one.
-
Optional: to allow the link to be used only once, check the One-time link checkbox.
-
Optional: to limit the link duration, check the Time limits checkbox and select one of the options:
- Delete after — the link will stop working after the selected period of time after creation;
- Delete at specified time — the link will stop working at the selected date and time.
-
Click Create link.
-
To copy the link, click . You will be able to copy it later in the
linksbucket.
Get a temporary link via a presigned URL
Using AWS SDK presigned URLs (Presigned URLs) you can get a temporary link to an object. Learn more in the Sharing objects with presigned URLs instruction in the AWS documentation.
Python
PHP
JavaScript
Java
Go
Script example:
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)
Specify:
<access_key>— the value of the Access key field from the S3 key;<secret_key>— the value of the Secret key field from the S3 key;<s3_domain>— the S3 API domain depending on the pool where the bucket is located;<bucket_name>— the bucket name;<path_to_object>— the path to the object in the bucket;<time>— the link duration in seconds.
Get a permanent link via a script
Python
PHP
JavaScript
Java
Go
Script example:
import boto3
def get_public_url(bucket_uuid: str, object_key: str) -> str:
return f"https://{bucket_uuid}.selstorage.ru/{object_key}"
if __name__ == "<file_name>":
bucket_uuid = "<uuid>"
object_key = "<path_to_object>"
url = get_public_url(bucket_uuid, object_key)
print("Public URL:", url)
Specify:
<file_name>— the Python file name;<uuid>— the unique bucket identifier, can be viewed in the bucket public domain;<path_to_object>— the path to the object in the bucket.