SDK с WebShield S3
Использование AWS SDK (boto3, JavaScript, Go, PHP) с S3-совместимым объектным хранилищем WebShield.
С объектным хранилищем WebShield работает любой AWS SDK — направьте S3-клиент на endpoint WebShield. Поддерживаются имя бакета в пути и доменная адресация. Как получить ключи и создать бакеты — см. Объектное хранилище.
Что понадобится
Заголовок раздела «Что понадобится»- Endpoint:
https://s3.webshield.pro - Access Key ID и Secret Access Key со страницы Хранилище S3 в личном кабинете.
- Точное имя бакета из личного кабинета (например,
company-backups).
Не вшивайте секретный ключ в исходный код — читайте его из переменной окружения или менеджера секретов.
Python (boto3)
Заголовок раздела «Python (boto3)»import boto3from botocore.config import Config
s3 = boto3.client( "s3", endpoint_url="https://s3.webshield.pro", aws_access_key_id="WSS...", aws_secret_access_key="<секрет>", config=Config(signature_version="s3v4", request_checksum_calculation="when_required"),)
s3.upload_file("backup.tar.gz", "company-backups", "db/backup.tar.gz")s3.download_file("company-backups", "db/backup.tar.gz", "restored.tar.gz")
for obj in s3.list_objects_v2(Bucket="company-backups", Prefix="db/").get("Contents", []): print(obj["Key"], obj["Size"])JavaScript (AWS SDK v3)
Заголовок раздела «JavaScript (AWS SDK v3)»import { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";import { readFileSync } from "node:fs";
const s3 = new S3Client({ endpoint: "https://s3.webshield.pro", region: "ru-1", credentials: { accessKeyId: "WSS...", secretAccessKey: process.env.WS_SECRET_KEY, },});
await s3.send(new PutObjectCommand({ Bucket: "company-backups", Key: "db/backup.tar.gz", Body: readFileSync("backup.tar.gz"),}));Go (aws-sdk-go-v2)
Заголовок раздела «Go (aws-sdk-go-v2)»cfg, _ := config.LoadDefaultConfig(context.TODO(), config.WithRegion("ru-1"), config.WithCredentialsProvider(credentials.NewStaticCredentialsProvider( "WSS...", os.Getenv("WS_SECRET_KEY"), "")),)client := s3.NewFromConfig(cfg, func(o *s3.Options) { o.BaseEndpoint = aws.String("https://s3.webshield.pro")})PHP (aws-sdk-php)
Заголовок раздела «PHP (aws-sdk-php)»$s3 = new Aws\S3\S3Client([ 'version' => 'latest', 'region' => 'ru-1', 'endpoint' => 'https://s3.webshield.pro', 'credentials' => [ 'key' => 'WSS...', 'secret' => getenv('WS_SECRET_KEY'), ],]);