Object Storage Service：使用STS臨時訪問憑證訪問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 {
        // 請填寫步驟1.5產生的臨時存取金鑰AccessKey ID、AccessKey Secret和SecurityToken，而非RAM使用者的身份憑證資訊
        // 請注意區分STS服務擷取的AccessKey ID是以STS開頭
        String accessKeyId = "yourSTSAccessKeyID";
        String accessKeySecret = "yourSTSAccessKeySecret";
        // 填寫擷取的STS安全性權杖（SecurityToken）。
        String stsToken= "yourSecurityToken";

        // 使用DefaultCredentialProvider方法直接設定AK和SK
        CredentialsProvider credentialsProvider = new DefaultCredentialProvider(accessKeyId, accessKeySecret, stsToken);
        // 使用credentialsProvider初始化用戶端
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        // 顯式聲明使用 V4 簽名演算法
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
        // 建立OSSClient執行個體。
        // 當OSSClient執行個體不再使用時，調用shutdown方法以釋放資源。
        OSS ossClient = OSSClientBuilder.create()
                 // 請設定目的OSS訪問網域名稱  例如杭州地區：https://oss-cn-hangzhou.aliyuncs.com
                .endpoint("endpoint")
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(clientBuilderConfiguration)
                // 請設定為目標Bucket所處region  例如杭州地區：cn-hangzhou
                .region("region")
                .build();

        try {

            // 建立PutObjectRequest對象，將本地檔案exampletest.txt上傳至examplebucket
            PutObjectRequest putObjectRequest = new PutObjectRequest("examplebucket", "exampletest.txt", new File("D:\\localpath\\exampletest.txt"));

            // 如果需要上傳時設定儲存類型和存取權限，請參考以下範例程式碼。
            // ObjectMetadata metadata = new ObjectMetadata();
            // metadata.setHeader(OSSHeaders.OSS_STORAGE_CLASS, StorageClass.Standard.toString());
            // metadata.setObjectAcl(CannedAccessControlList.Private);
            // putObjectRequest.setMetadata(metadata);

            // 上傳檔案
            PutObjectResult result = ossClient.putObject(putObjectRequest);
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

Python

Python SDK目前提供V2和V1兩個版本。V2在V1基礎上全面重構，簡化了身分識別驗證、請求重試、錯誤處理等底層操作，提供更靈活的參數配置和新的進階介面。請根據您的實際使用需求，參考如下樣本。

import alibabacloud_oss_v2 as oss

def main():
    # 請填寫步驟1.5產生的臨時存取金鑰AccessKey ID、AccessKey Secret和SecurityToken，而非RAM使用者的身份憑證資訊
    # 請注意區分STS服務擷取的AccessKey ID是以STS開頭
    sts_access_key_id = 'yourSTSAccessKeyID'
    sts_access_key_secret = 'yourSTSAccessKeySecret'
    # 填寫擷取的STS安全性權杖（SecurityToken）
    sts_security_token = 'yourSecurityToken'
    
    # 建立靜態憑證提供者，顯式設定臨時存取金鑰AccessKey ID和AccessKey Secret，以及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,
    )

    # 載入SDK的預設配置，並設定憑證提供者
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider

    # 填寫Bucket所在地區。以華東1（杭州）為例，Region填寫為cn-hangzhou
    cfg.region = 'cn-hangzhou'

    # 使用配置好的資訊建立OSS用戶端
    client = oss.Client(cfg)

    # 待上傳本地檔案路徑  例如 D:\\localpath\\exampletest.txt
    local_file_path = 'D:\\localpath\\exampletest.txt'
    with open(local_file_path, 'rb') as file:
        data = file.read()

    # 執行上傳對象的請求，將本地檔案exampletest.txt上傳至examplebucket，指定儲存空間名稱、對象名稱和上傳檔案
    result = client.put_object(oss.PutObjectRequest(
        # Bucket名稱
        bucket='examplebucket',
        # 上傳到Bucket中的對象名稱
        key='exampletest.txt',
        body=data,
    ))

     # 輸出請求的結果狀態代碼、請求ID、內容MD5、ETag、CRC64校正碼和版本ID，用於檢查請求是否成功
    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},'
    )


# 當此指令碼被直接運行時，調用main函數
if __name__ == "__main__":
    main()  # 指令碼入口，當檔案被直接運行時調用main函數

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

# yourEndpoint填寫Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
# 填寫步驟1.5產生的臨時存取金鑰AccessKey ID和AccessKey Secret，非阿里雲帳號AccessKey ID和AccessKey Secret。
sts_access_key_id = 'yourAccessKeyId'
sts_access_key_secret = 'yourAccessKeySecret'
# 填寫Bucket名稱。
bucket_name = 'examplebucket'
# 填寫Object完整路徑和字串。Object完整路徑中不能包含Bucket名稱。 
object_name = 'examplebt.txt'
# 填寫步驟1.5產生的STS安全性權杖（SecurityToken）。
security_token = 'yourSecurityToken'
# 使用臨時訪問憑證中的認證資訊初始化StsAuth執行個體。
auth = oss2.StsAuth(sts_access_key_id,
                    sts_access_key_secret,
                    security_token)
# 使用StsAuth執行個體初始化儲存空間。
bucket = oss2.Bucket(auth, endpoint, bucket_name)
# 上傳Object。
result = bucket.put_object(object_name, "hello world")
print(result.status)

Go

Go SDK目前提供V2和V1兩個版本。V2在V1基礎上全面重構，簡化了身分識別驗證、請求重試、錯誤處理等底層操作，提供更靈活的參數配置和新的進階介面。請根據您的實際使用需求，參考如下樣本。

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() {
	// 填寫Bucket所在地區。以華東1（杭州）為例，Region填寫為cn-hangzhou
	region := "cn-hangzhou"

	// 請填寫步驟1.5產生的臨時存取金鑰AccessKey ID、AccessKey Secret和SecurityToken，而非RAM使用者的身份憑證資訊
        // 請注意區分STS服務擷取的AccessKey ID是以STS開頭
	accessKeyID := "yourSTSAccessKeyID"
	accessKeySecret := "yourSTSAccessKeySecret"
	// 填寫擷取的STS安全性權杖（SecurityToken）
	stsToken := "yourSecurityToken"

	// 使用NewStaticCredentialsProvider方法直接設定AK、SK和STS Token
	provider := credentials.NewStaticCredentialsProvider(accessKeyID, accessKeySecret, stsToken)

	// 載入預設配置並設定憑證提供者和地區
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(provider).
		WithRegion(region)

	// 建立OSS用戶端
	client := oss.NewClient(cfg)

	// 填寫要上傳的本地檔案路徑和檔案名稱，例如 D:\\localpath\\exampletest.txt
	localFile := "D:\\localpath\\exampletest.txt"

	// 建立上傳對象的請求
	putRequest := &oss.PutObjectRequest{
		Bucket:       oss.Ptr("examplebucket"),      // Bucket名稱
		Key:          oss.Ptr("exampletest.txt"),    // 上傳到Bucket中的對象名稱
		StorageClass: oss.StorageClassStandard, // 指定對象的儲存類型為標準儲存
		Acl:          oss.ObjectACLPrivate,     // 指定對象的存取權限為私人訪問
		Metadata: map[string]string{
			"yourMetadataKey1": "yourMetadataValue1", // 設定對象的中繼資料
		},
	}

	// 執行上傳對象的請求，將本地檔案exampletest.txt上傳至examplebucket
	result, err := client.PutObjectFromFile(context.TODO(), putRequest, localFile)
	if err != nil {
		log.Fatalf("failed to put object from file %v", err)
	}

	// 列印上傳對象的結果
	log.Printf("put object from file result:%#v\n", result)
	
}

package main

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

func main() {
    // 從環境變數中擷取步驟1.5產生的臨時訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID、OSS_ACCESS_KEY_SECRET、OSS_SESSION_TOKEN。
    provider, err := oss.NewEnvironmentVariableCredentialsProvider()
    if err != nil {
        fmt.Println("Error:", err)
        os.Exit(-1)
    }
    // 建立OSSClient執行個體。// yourEndpoint填寫Bucket對應的Endpoint，以華東1（杭州）為例，填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
    client, err := oss.New("yourEndpoint", "", "", oss.SetCredentialsProvider(&provider))
    if err != nil {
        fmt.Println("Error:", err)
        os.Exit(-1)
    }
    // 填寫Bucket名稱，例如examplebucket。
    bucketName := "examplebucket"// 填寫Object的完整路徑，完整路徑中不能包含Bucket名稱，例如exampledir/exampleobject.txt。
    objectName := "exampledir/exampleobject.txt"// 填寫本地檔案的完整路徑，例如D:\\localpath\\examplefile.txt。
    filepath := "D:\\localpath\\examplefile.txt"
    bucket,err := client.Bucket(bucketName)
    // 通過STS授權第三方上傳檔案。
    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");

// 在用戶端使用臨時訪問憑證初始化OSS用戶端，用於臨時授權訪問OSS資源
const getToken = async () => {
  // 設定用戶端請求訪問憑證的地址。
  await axios.get("http://localhost:8000/sts").then((token) => {
    const client = new OSS({
       // yourRegion填寫Bucket所在地區。以華東1（杭州）為例，yourRegion填寫為oss-cn-hangzhou
      region: 'oss-cn-hangzhou',
      // 填寫步驟1.5產生的臨時存取金鑰AccessKey ID和AccessKey Secret，非阿里雲帳號AccessKey ID和AccessKey Secret
      accessKeyId: token.data.AccessKeyId,
      accessKeySecret: token.data.AccessKeySecret,
      // 填寫步驟1.5產生的STS安全性權杖（SecurityToken）
      stsToken: token.data.SecurityToken,
      authorizationV4: true,
      // 填寫Bucket名稱
      bucket: "examplebucket",
      // 重新整理臨時訪問憑證
      refreshSTSToken: async () => {
        const refreshToken = await axios.get("http://localhost:8000/sts");
        return {
          accessKeyId: refreshToken.data.AccessKeyId,
          accessKeySecret: refreshToken.data.AccessKeySecret,
          stsToken: refreshToken.data.SecurityToken,
        };
      },
    });
    // 使用臨時訪問憑證上傳檔案
    // 填寫不包含Bucket名稱在內的Object的完整路徑，例如exampleobject.jpg
    // 填寫本地檔案的完整路徑，例如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 {
    // 請填寫步驟1.5產生的臨時存取金鑰AccessKey ID、AccessKey Secret和SecurityToken，而非RAM使用者的身份憑證資訊
    // 請注意區分STS服務擷取的AccessKey ID是以STS開頭
    $accessKeyId = 'yourSTSAccessKeyID';
    $accessKeySecret = 'yourSTSAccessKeySecret';
    // 填寫擷取的STS安全性權杖（SecurityToken）
    $securityToken = 'yourSecurityToken';

    // 使用StaticCredentialsProvider類建立憑證提供者
    $provider = new StaticCredentialsProvider($accessKeyId, $accessKeySecret, $securityToken);

    // 填寫Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com
    $endpoint = "https://oss-cn-hangzhou.aliyuncs.com";

    // 填寫Bucket名稱，例如examplebucket。
    $bucket= "examplebucket";
    // 填寫上傳到Bucket中的對象名稱
    $object = "exampletest.txt";
    // 填寫待上傳本地檔案路徑，例如 D:\\localpath\\exampletest.txt
    $localFilePath = "D:\\localpath\\exampletest.txt";

    // 上傳時可以設定相關的headers，例如設定存取權限為private、自訂中繼資料等
    $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,
        // 填寫Bucket所在地區。以華東1（杭州）為例，Region填寫為cn-hangzhou
        "region" => "cn-hangzhou"
    );
    
    // 使用配置好的資訊建立OSS用戶端
    $ossClient = new OssClient($config);
    
     // 發送請求 將本地檔案exampletest.txt上傳至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(
  # Endpoint以華東1（杭州）為例，其它Region請按實際情況填寫。
  endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
  # 填寫步驟1.5產生的臨時存取金鑰AccessKey ID和AccessKey Secret，非阿里雲帳號AccessKey ID和AccessKey Secret。
  access_key_id: 'token.access_key_id',
  access_key_secret: 'token.access_key_secret',
  # 填寫步驟1.5產生的STS安全性權杖（SecurityToken）。
  sts_token: 'token.security_token'
  )
# 填寫Bucket名稱，例如examplebucket。
bucket = client.get_bucket('examplebucket')
# 上傳檔案。
bucket.put_object('exampleobject.txt', :file => 'D:\test.txt')