Object Storage Service：Gunakan kredensial sementara yang disediakan oleh STS untuk mengakses OSS

Java

import com.aliyun.oss.*;
import com.aliyun.oss.common.auth.CredentialsProvider;
import com.aliyun.oss.common.auth.DefaultCredentialProvider;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.model.PutObjectRequest;
import com.aliyun.oss.model.PutObjectResult;

import java.io.File;

public class Demo {

    public static void main(String[] args) throws Exception {
        // Tentukan ID AccessKey sementara, Rahasia AccessKey, dan token STS yang dihasilkan di langkah 1.5. Jangan gunakan kredensial pengguna RAM.
        // Perhatikan bahwa ID AccessKey yang disediakan oleh STS dimulai dengan STS.
        String accessKeyId = "yourSTSAccessKeyID";
        String accessKeySecret = "yourSTSAccessKeySecret";
        // Tentukan token keamanan yang diperoleh dari STS.
        String stsToken= "yourSecurityToken";

        // Berikan ID AccessKey dan rahasia ke DefaultCredentialProvider untuk menginisialisasi penyedia kredensial.
        CredentialsProvider credentialsProvider = new DefaultCredentialProvider(accessKeyId, accessKeySecret, stsToken);
        // Gunakan credentialsProvider untuk menginisialisasi klien.
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        // Nyatakan secara eksplisit penggunaan algoritma signature V4.
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
        // Buat instance OSSClient.
        // Panggil metode shutdown untuk melepaskan sumber daya ketika OSSClient tidak lagi digunakan.
        OSS ossClient = OSSClientBuilder.create()
                 // Tentukan titik akhir wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah Tiongkok (Hangzhou), atur titik akhir ke https://oss-cn-hangzhou.aliyuncs.com.  
                .endpoint("endpoint")
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(clientBuilderConfiguration)
                // Tentukan ID wilayah. Contoh: cn-hangzhou.
                .region("region")
                .build();

        try {

            // Buat objek PutObjectRequest. Unggah file lokal exampletest.txt ke examplebucket.
            PutObjectRequest putObjectRequest = new PutObjectRequest("examplebucket", "exampletest.txt", new File("D:\\localpath\\exampletest.txt"));

            // Opsional. Tentukan kelas penyimpanan dan ACL objek.
            // ObjectMetadata metadata = new ObjectMetadata();
            // metadata.setHeader(OSSHeaders.OSS_STORAGE_CLASS, StorageClass.Standard.toString());
            // metadata.setObjectAcl(CannedAccessControlList.Private);
            // putObjectRequest.setMetadata(metadata);

            // Unggah objek. 
            PutObjectResult result = ossClient.putObject(putObjectRequest);
        } catch (OSSException oe) {
            System.out.println("Terjadi OSSException, yang berarti permintaan Anda sampai ke OSS, "
                    + "tetapi ditolak dengan tanggapan kesalahan karena suatu alasan.");
            System.out.println("Pesan Kesalahan:" + oe.getErrorMessage());
            System.out.println("Kode Kesalahan:" + oe.getErrorCode());
            System.out.println("ID Permintaan:" + oe.getRequestId());
            System.out.println("ID Host:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Terjadi ClientException, yang berarti klien mengalami "
                    + "masalah internal serius saat mencoba berkomunikasi dengan OSS, "
                    + "seperti tidak dapat mengakses jaringan.");
            System.out.println("Pesan Kesalahan:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

Python

SDK OSS untuk Python tersedia dalam dua versi, 2.0 dan 1.0. SDK OSS untuk Python 2.0 merupakan penyusunan ulang lengkap dari versi 1.0, menyederhanakan operasi inti seperti autentikasi, pengulangan permintaan, dan penanganan kesalahan. SDK ini menawarkan konfigurasi parameter yang lebih fleksibel dan memperkenalkan fitur-fitur canggih baru. Contoh berikut disediakan untuk membantu Anda mengimplementasikan SDK OSS untuk Python berdasarkan kebutuhan aktual Anda.

import alibabacloud_oss_v2 as oss

def main():
    # Tentukan ID AccessKey sementara, Rahasia AccessKey, dan token STS yang dihasilkan di langkah 1.5. Jangan gunakan kredensial pengguna RAM.
    # Perhatikan bahwa ID AccessKey yang disediakan oleh STS dimulai dengan STS.
    sts_access_key_id = 'yourSTSAccessKeyID'
    sts_access_key_secret = 'yourSTSAccessKeySecret'
    # Tentukan token STS yang diperoleh dari STS.
    sts_security_token = 'yourSecurityToken'
    
    # Buat penyedia kredensial statis dan nyatakan secara eksplisit ID AccessKey, Rahasia AccessKey, dan token STS yang disediakan oleh STS.
    credentials_provider = oss.credentials.StaticCredentialsProvider(
        access_key_id=sts_access_key_id,
        access_key_secret=sts_access_key_secret,
        security_token=sts_security_token,
    )

    # Muat konfigurasi default SDK dan tentukan penyedia kredensial.
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider

    # Tentukan wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah Tiongkok (Hangzhou), atur wilayah ke cn-hangzhou.
    cfg.region = 'cn-hangzhou'

    # Gunakan konfigurasi di atas untuk membuat instance OSSClient.
    client = oss.Client(cfg)

    # Tentukan path lengkap objek lokal yang ingin Anda unggah. Contoh: D:\\localpath\\exampletest.txt.
    local_file_path = 'D:\\localpath\\exampletest.txt'
    with open(local_file_path, 'rb') as file:
        data = file.read()

    # Jalankan permintaan untuk mengunggah exampletest.txt ke examplebucket. 
    result = client.put_object(oss.PutObjectRequest(
        # Nama bucket.
        bucket='examplebucket',
        # Nama objek yang akan diunggah. 
        key='exampletest.txt',
        body=data,
    ))

     # Tampilkan kode status HTTP, ID permintaan, hash MD5, ETag, nilai CRC-64, dan ID versi objek untuk memeriksa apakah permintaan berhasil.
    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
          f' content md5: {result.content_md5},'
          f' etag: {result.etag},'
          f' hash crc64: {result.hash_crc64},'
          f' version id: {result.version_id},'
    )


# Panggil fungsi utama saat skrip dijalankan secara langsung.
if __name__ == "__main__":
    main()  # Titik masuk skrip. Saat skrip dijalankan secara langsung, fungsi utama dipanggil.

# -*- coding: utf-8 -*-
import oss2

# Tentukan titik akhir wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah Tiongkok (Hangzhou), atur titik akhir ke https://oss-cn-hangzhou.aliyuncs.com. 
endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
# Tentukan ID AccessKey sementara dan Rahasia AccessKey yang dihasilkan di langkah 1.5. Jangan gunakan ID AccessKey dan Rahasia AccessKey akun Alibaba Cloud. 
sts_access_key_id = 'yourAccessKeyId'
sts_access_key_secret = 'yourAccessKeySecret'
# Tentukan nama bucket. 
bucket_name = 'examplebucket'
# Tentukan path lengkap objek menggunakan string. Jangan sertakan nama bucket dalam path lengkap.  
object_name = 'examplebt.txt'
# Masukkan token STS yang dihasilkan di Langkah 1.5. 
security_token = 'yourSecurityToken'
# Inisialisasi instance StsAuth menggunakan kredensial sementara. 
auth = oss2.StsAuth(sts_access_key_id,
                    sts_access_key_secret,
                    security_token)
# Inisialisasi bucket menggunakan instance StsAuth. 
bucket = oss2.Bucket(auth, endpoint, bucket_name)
# Unggah objek. 
result = bucket.put_object(object_name, "hello world")
print(result.status)

Go

SDK OSS untuk Go tersedia dalam dua versi, 2.0 dan 1.0. SDK OSS untuk Go 2.0 merupakan penyusunan ulang lengkap dari versi 1.0, menyederhanakan operasi inti seperti autentikasi, pengulangan permintaan, dan penanganan kesalahan. SDK ini menawarkan konfigurasi parameter yang lebih fleksibel dan memperkenalkan fitur-fitur canggih baru. Contoh berikut disediakan untuk membantu Anda mengimplementasikan SDK OSS untuk Go berdasarkan kebutuhan aktual Anda.

package main

import (
	"context"
	"log"

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

func main() {
	// Tentukan wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah Tiongkok (Hangzhou), atur wilayah ke cn-hangzhou.
	region := "cn-hangzhou"

	// Tentukan ID AccessKey sementara, Rahasia AccessKey, dan token STS yang dihasilkan di langkah 1.5. Jangan gunakan kredensial pengguna RAM.
        // Perhatikan bahwa ID AccessKey yang disediakan oleh STS dimulai dengan STS.
	accessKeyID := "yourSTSAccessKeyID"
	accessKeySecret := "yourSTSAccessKeySecret"
	// Tentukan token STS yang diperoleh dari STS.
	stsToken := "yourSecurityToken"

	// Gunakan metode NewStaticCredentialsProvider untuk menentukan ID AccessKey, Rahasia AccessKey, dan Token STS.
	provider := credentials.NewStaticCredentialsProvider(accessKeyID, accessKeySecret, stsToken)

	// Muat konfigurasi default SDK dan tentukan penyedia kredensial dan wilayah.
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(provider).
		WithRegion(region)

	// Buat klien OSS.
	client := oss.NewClient(cfg)

	// Tentukan path file lokal yang ingin Anda unggah. Contoh: D:\\localpath\\exampletest.txt.
	localFile := "D:\\localpath\\exampletest.txt"

	// Buat permintaan untuk mengunggah objek.
	putRequest := &oss.PutObjectRequest{
		Bucket:       oss.Ptr("examplebucket"),      // Nama bucket.
		Key:          oss.Ptr("exampletest.txt"),    // nama objek yang akan diunggah.
		StorageClass: oss.StorageClassStandard, // Atur kelas penyimpanan objek ke Standard.
		Acl:          oss.ObjectACLPrivate,     // Atur ACL objek ke private.
		Metadata: map[string]string{
			"yourMetadataKey1": "yourMetadataValue1", // Konfigurasikan metadata objek.
		},
	}

	// Jalankan permintaan untuk mengunggah exampletest.txt ke examplebucket.
	result, err := client.PutObjectFromFile(context.TODO(), putRequest, localFile)
	if err != nil {
		log.Fatalf("gagal mengunggah objek dari file %v", err)
	}

	// Tampilkan hasil pengunggahan objek.
	log.Printf("hasil unggah objek dari file:%#v\n", result)
	
}

package main

import (
    "fmt""github.com/aliyun/aliyun-oss-go-sdk/oss""os"
)

func main() {
    // Peroleh kredensial sementara dari variabel lingkungan. Sebelum menjalankan kode contoh, pastikan variabel lingkungan OSS_ACCESS_KEY_ID, OSS_ACCESS_KEY_SECRET, dan OSS_SESSION_TOKEN telah dikonfigurasi.
    provider, err := oss.NewEnvironmentVariableCredentialsProvider()
    if err != nil {
        fmt.Println("Error:", err)
        os.Exit(-1)
    }
    // Buat instance OSSClient. // Tentukan titik akhir wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah Tiongkok (Hangzhou), atur titik akhir ke https://oss-cn-hangzhou.aliyuncs.com. Tentukan titik akhir aktual Anda.
    client, err := oss.New("yourEndpoint", "", "", oss.SetCredentialsProvider(&provider))
    if err != nil {
        fmt.Println("Error:", err)
        os.Exit(-1)
    }
    // Tentukan nama bucket. Contoh: examplebucket.
    bucketName := "examplebucket"// Tentukan path lengkap objek. Jangan sertakan nama bucket dalam path lengkap. Contoh: exampledir/exampleobject.txt.
    objectName := "exampledir/exampleobject.txt"// Tentukan path lengkap objek lokal. Contoh: D:\\localpath\\examplefile.txt.
    filepath := "D:\\localpath\\examplefile.txt"
    bucket,err := client.Bucket(bucketName)
    // Unggah file lokal menggunakan kredensial sementara.
    err = bucket.PutObjectFromFile(objectName,filepath)
    if err != nil {
        fmt.Println("Error:", err)
        os.Exit(-1)
    }
    fmt.Println("upload success")
}

Node.js

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

// Gunakan kredensial sementara untuk menginisialisasi instance OSSClient. Instance ini digunakan untuk memberi otorisasi akses sementara ke sumber daya OSS.
const getToken = async () => {
  // Tentukan alamat yang digunakan klien untuk memperoleh kredensial sementara.
  await axios.get("http://localhost:8000/sts").then((token) => {
    const client = new OSS({
       // Tentukan wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah Tiongkok (Hangzhou), atur wilayah ke oss-cn-hangzhou.
      region: 'oss-cn-hangzhou',
      // Tentukan ID AccessKey sementara, Rahasia AccessKey, dan token STS yang dihasilkan di langkah 1.5. Jangan gunakan kredensial pengguna RAM.
      accessKeyId: token.data.AccessKeyId,
      accessKeySecret: token.data.AccessKeySecret,
      // Masukkan token STS yang dihasilkan di Langkah 1.5.
      stsToken: token.data.SecurityToken,
      authorizationV4: true,
      // Tentukan nama bucket.
      bucket: "examplebucket",
      // Segarkan kredensial sementara.
      refreshSTSToken: async () => {
        const refreshToken = await axios.get("http://localhost:8000/sts");
        return {
          accessKeyId: refreshToken.data.AccessKeyId,
          accessKeySecret: refreshToken.data.AccessKeySecret,
          stsToken: refreshToken.data.SecurityToken,
        };
      },
    });
    // Gunakan kredensial sementara untuk mengunggah objek.
    // Tentukan path lengkap objek. Jangan sertakan nama bucket dalam path lengkap. Contoh: exampleobject.jpg.
    // Tentukan path lengkap objek lokal. Contoh: D:\\example.jpg.
    client.put('exampleobject.jpg', 'D:\\example.jpg').then((res)=>{console.log(res)}).catch(e=>console.log(e))
  });
};
getToken()

php

<?php
if (is_file(__DIR__ . 'autoload.php')) {
    require_once __DIR__ . 'autoload.php';
}
if (is_file(__DIR__ . '/vendor/autoload.php')) {
    require_once __DIR__ . '/vendor/autoload.php';
}

use OSS\Credentials\StaticCredentialsProvider;
use OSS\OssClient;
use OSS\Core\OssException;

try {
    // Tentukan ID AccessKey sementara, Rahasia AccessKey, dan token STS yang dihasilkan di langkah 1.5. Jangan gunakan kredensial pengguna RAM.
    // Perhatikan bahwa ID AccessKey yang disediakan oleh STS dimulai dengan STS.
    $accessKeyId = 'yourSTSAccessKeyID';
    $accessKeySecret = 'yourSTSAccessKeySecret';
    // Tentukan token STS yang diperoleh dari STS.
    $securityToken = 'yourSecurityToken';

    // Buat penyedia kredensial menggunakan StaticCredentialsProvider.
    $provider = new StaticCredentialsProvider($accessKeyId, $accessKeySecret, $securityToken);

    // Tentukan titik akhir wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah Tiongkok (Hangzhou), atur titik akhir ke https://oss-cn-hangzhou.aliyuncs.com.
    $endpoint = "https://oss-cn-hangzhou.aliyuncs.com";

    // Tentukan nama bucket. Contoh: examplebucket.
    $bucket= "examplebucket";
    // Tentukan nama objek yang akan diunggah.
    $object = "exampletest.txt";
    // Tentukan path lengkap objek lokal yang ingin Anda unggah. Contoh: D:\\localpath\\exampletest.txt.
    $localFilePath = "D:\\localpath\\exampletest.txt";

    // Konfigurasikan header dalam permintaan unggah untuk menentukan informasi tentang string yang diunggah. Misalnya, atur ACL objek ke private dan konfigurasikan metadata pengguna objek.
    $options = array(
        OssClient::OSS_HEADERS => array(
            'x-oss-object-acl' => 'private',
            'x-oss-meta-info' => 'yourinfo'
        ),
    );

    $config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        // Tentukan wilayah tempat bucket berada. Misalnya, jika bucket Anda berada di wilayah Tiongkok (Hangzhou), atur wilayah ke cn-hangzhou.
        "region" => "cn-hangzhou"
    );
    
    // Gunakan konfigurasi di atas untuk membuat instance OSSClient.
    $ossClient = new OssClient($config);
    
     // Kirim permintaan untuk mengunggah file lokal bernama exampletest.txt ke examplebucket.
    $ossClient->putObject($bucket, $object, $localFilePath, $options);
} catch (OssException $e) {
    printf($e->getMessage() . "\n");
    return;
}

Ruby

require 'aliyun/sts'
require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  # Dalam contoh ini, digunakan titik akhir wilayah Tiongkok (Hangzhou). Tentukan titik akhir aktual Anda. 
  endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
  # Tentukan ID AccessKey sementara dan Rahasia AccessKey yang dihasilkan di langkah 1.5. Jangan gunakan ID AccessKey dan Rahasia AccessKey akun Alibaba Cloud.  
  access_key_id: 'token.access_key_id',
  access_key_secret: 'token.access_key_secret',
  # Masukkan token STS yang dihasilkan di Langkah 1.5. 
  sts_token: 'token.security_token'
  )
# Tentukan nama bucket. Contoh: examplebucket. 
bucket = client.get_bucket('examplebucket')
# Unggah objek. 
bucket.put_object('exampleobject.txt', :file => 'D:\test.txt')