Object Storage Service：Menggunakan URL yang ditandatangani sebelumnya untuk mengunduh atau melihat pratinjau file

Java

import argparse
import alibabacloud_oss_v2 as oss

parser = argparse.ArgumentParser(description="contoh presign untuk mengambil objek")
parser.add_argument('--region', required=True)
parser.add_argument('--bucket', required=True)
parser.add_argument('--endpoint')
parser.add_argument('--key', required=True)

def main():
    args = parser.parse_args()
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider
    cfg.region = args.region
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    client = oss.Client(cfg)
    pre_result = client.presign(
        oss.GetObjectRequest(
            bucket=args.bucket,
            key=args.key,
        )
    )
    print(f'method: {pre_result.method},'
          f' expiration: {pre_result.expiration.strftime("%Y-%m-%dT%H:%M:%S.000Z")},'
          f' url: {pre_result.url}')
    for key, value in pre_result.signed_headers.items():
        print(f'signed headers key: {key}, signed headers value: {value}')

if __name__ == "__main__":
    main()

Untuk informasi lebih lanjut, lihat Unduh file menggunakan presigned URL di Java.

Python

import argparse
import alibabacloud_oss_v2 as oss

parser = argparse.ArgumentParser(description="presign get object sample")
parser.add_argument('--region', required=True)
parser.add_argument('--bucket', required=True)
parser.add_argument('--endpoint')
parser.add_argument('--key', required=True)

def main():
    args = parser.parse_args()
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider
    cfg.region = args.region
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    client = oss.Client(cfg)
    pre_result = client.presign(
        oss.GetObjectRequest(
            bucket=args.bucket,
            key=args.key,
        )
    )
    print(f'method: {pre_result.method},'
          f' expiration: {pre_result.expiration.strftime("%Y-%m-%dT%H:%M:%S.000Z")},'
          f' url: {pre_result.url}')
    for key, value in pre_result.signed_headers.items():
        print(f'signed headers key: {key}, signed headers value: {value}')

if __name__ == "__main__":
    main()

Untuk informasi lebih lanjut, lihat Unduh file menggunakan presigned URL di Python.

Go

package main

import (
    "context"
    "flag"
    "log"
    "time"

    "github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
    "github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)

var (
    region     string
    bucketName string
    objectName string
)

func init() {
    flag.StringVar(&region, "region", "", "Wilayah tempat bucket berada.")
    flag.StringVar(&bucketName, "bucket", "", "Nama bucket.")
    flag.StringVar(&objectName, "object", "", "Nama objek.")
}

func main() {
    flag.Parse()
    if len(bucketName) == 0 || len(region) == 0 || len(objectName) == 0 {
        flag.PrintDefaults()
        log.Fatalf("parameter tidak valid: region, bucket, dan object wajib diisi")
    }

    cfg := oss.LoadDefaultConfig().
        WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
        WithRegion(region)

    client := oss.NewClient(cfg)

    result, err := client.Presign(context.TODO(), &oss.GetObjectRequest{
        Bucket: oss.Ptr(bucketName),
        Key:    oss.Ptr(objectName),
    },
        oss.PresignExpires(10*time.Minute),
    )
    if err != nil {
        log.Fatalf("gagal membuat presigned URL: %v", err)
    }

    log.Printf("method: %v", result.Method)
    log.Printf("expiration: %v", result.Expiration)
    log.Printf("url: %v", result.URL)
}

Untuk informasi lebih lanjut, lihat Unduh file menggunakan presigned URL di Go.

Node.js

const OSS = require("ali-oss");

async function generateSignatureUrl(fileName) {
    const client = await new OSS({
        accessKeyId: process.env.OSS_ACCESS_KEY_ID,
        accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
        bucket: 'examplebucket',
        region: 'oss-cn-hangzhou',
        // Gunakan HTTPS untuk mencegah browser memblokir tautan unduhan.
        secure: true,
        authorizationV4: true
    });

    return await client.signatureUrlV4('GET', 3600, {
        headers: {}
    }, fileName);
}

generateSignatureUrl('yourFileName').then(url => {
    console.log('Generated URL:', url);
}).catch(err => {
    console.error('Error:', err);
});

Untuk informasi lebih lanjut, lihat Unduh file menggunakan presigned URL di Node.js.

PHP

<?php

require_once __DIR__ . '/../vendor/autoload.php';

use AlibabaCloud\Oss\V2 as Oss;

$optsdesc = [
    "region"   => ['help' => 'Wilayah tempat bucket berada.', 'required' => true],
    "endpoint" => ['help' => 'Endpoint OSS.', 'required' => false],
    "bucket"   => ['help' => 'Nama bucket.', 'required' => true],
    "key"      => ['help' => 'Nama objek.', 'required' => true],
];
$longopts = array_map(fn($key) => "$key:", array_keys($optsdesc));
$options = getopt("", $longopts);

foreach ($optsdesc as $key => $value) {
    if ($value['required'] && empty($options[$key])) {
        echo "Error: --$key wajib diisi. " . $value['help'] . PHP_EOL;
        exit(1);
    }
}

$credentialsProvider = new Oss\Credentials\EnvironmentVariableCredentialsProvider();
$cfg = Oss\Config::loadDefault();
$cfg->setCredentialsProvider($credentialsProvider);
$cfg->setRegion($options["region"]);
if (isset($options["endpoint"])) {
    $cfg->setEndpoint($options["endpoint"]);
}

$client = new Oss\Client($cfg);
$request = new Oss\Models\GetObjectRequest(bucket: $options["bucket"], key: $options["key"]);
$result = $client->presign($request);

print('url: ' . $result->url . PHP_EOL);

Untuk informasi lebih lanjut, lihat Unduh file menggunakan presigned URL di PHP.

Java

// Tentukan nama domain kustom sebagai endpoint.
String endpoint = "https://static.example.com"; // Ganti dengan nama domain kustom Anda.
String region = "cn-hangzhou";
String bucketName = "examplebucket";
String objectName = "exampleobject.txt";

EnvironmentVariableCredentialsProvider credentialsProvider =
    CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();

ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
clientBuilderConfiguration.setSupportCname(true);   // Aktifkan CNAME
clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);

OSS ossClient = OSSClientBuilder.create()
        .endpoint(endpoint)
        .credentialsProvider(credentialsProvider)
        .clientConfiguration(clientBuilderConfiguration)
        .region(region)
        .build();

try {
    Date expiration = new Date(new Date().getTime() + 3600 * 1000L);
    GeneratePresignedUrlRequest request =
        new GeneratePresignedUrlRequest(bucketName, objectName, HttpMethod.GET);
    request.setExpiration(expiration);
    URL signedUrl = ossClient.generatePresignedUrl(request);
    System.out.println("Preview URL: " + signedUrl);
} finally {
    if (ossClient != null) ossClient.shutdown();
}

Python

cfg = oss.config.load_default()
cfg.credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
cfg.region = args.region
cfg.endpoint = "http://static.example.com"  # Ganti dengan nama domain kustom Anda.
cfg.use_cname = True                         # Aktifkan CNAME

client = oss.Client(cfg)
pre_result = client.presign(
    oss.GetObjectRequest(bucket=args.bucket, key=args.key)
)
print(f'url: {pre_result.url}')

Go

cfg := oss.LoadDefaultConfig().
    WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
    WithRegion(region).
    WithEndpoint("http://static.example.com"). // Ganti dengan nama domain kustom Anda.
    WithUseCName(true)                          // Aktifkan CNAME

client := oss.NewClient(cfg)
result, err := client.Presign(context.TODO(), &oss.GetObjectRequest{
    Bucket: oss.Ptr(bucketName),
    Key:    oss.Ptr(objectName),
},
    oss.PresignExpires(10*time.Minute),
)

Node.js

const client = await new OSS({
    endpoint: 'http://static.example.com',  // Ganti dengan nama domain kustom Anda.
    accessKeyId: process.env.OSS_ACCESS_KEY_ID,
    accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
    bucket: 'examplebucket',
    region: 'oss-cn-hangzhou',
    authorizationV4: true,
    cname: true  // Aktifkan CNAME
});

PHP

$cfg->setEndpoint("http://static.example.com"); // Ganti dengan nama domain kustom Anda.
$cfg->setUseCname(true);                         // Aktifkan CNAME

Java

String versionId = "CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3****";
Map<String, String> queryParam = new HashMap<>();
queryParam.put("versionId", versionId);
request.setQueryParameter(queryParam);

Python

pre_result = client.presign(
    oss.GetObjectRequest(
        bucket=bucket_name,
        key=object_name,
        version_id='CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3****',
    )
)

Go

result, err := client.Presign(context.TODO(), &oss.GetObjectRequest{
    Bucket:    oss.Ptr(bucketName),
    Key:       oss.Ptr(objectName),
    VersionId: oss.Ptr("CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE7****"),
},
    oss.PresignExpires(10*time.Minute),
)

Node.js

const signedUrl = await client.signatureUrlV4('GET', 3600, {
    queries: {
        "versionId": 'CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE7****'
    }
}, objectName);

PHP

$versionId = "yourVersionId";
$request = new Oss\Models\GetObjectRequest(bucket: $bucket, key: $key, versionId: $versionId);

Java

// Periode validitas: 1 jam
Date expiration = new Date(new Date().getTime() + 3600 * 1000L);
URL url = ossClient.generatePresignedUrl(bucketName, objectName, expiration);

Python

pre_result = client.presign(
    oss.GetObjectRequest(bucket=args.bucket, key=args.key)
)

Go

result, err := client.Presign(context.TODO(), &oss.GetObjectRequest{
    Bucket: oss.Ptr(bucketName),
    Key:    oss.Ptr(objectName),
},
    oss.PresignExpires(10*time.Minute), // Atur periode validitas
)

Node.js

// Parameter kedua menetapkan periode validitas dalam detik. Contoh: 3600 = 1 jam.
return await client.signatureUrlV4('GET', 3600, {headers: {}}, fileName);

PHP

Lihat Unduh objek menggunakan presigned URL di PHP.