全部產品
Search

搜尋本產品

    Object Storage Service：要求者付費模式（Go SDK V2）

    文件中心

    Object Storage Service：要求者付費模式（Go SDK V2）

    更新時間：Aug 02, 2025

    要求者付費模式是指由要求者支付讀取儲存空間（Bucket）內資料時產生的流量費用和請求費用，而Bucket擁有者僅支付儲存費用。您可以啟用此功能，適用於需要共用資料且避免承擔額外流量費用和請求費用的情況。

    注意事項

    • 本文範例程式碼以華東1（杭州）的地區IDcn-hangzhou為例，預設使用外網Endpoint，如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS，請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係，請參見OSS地區和訪問網域名稱。

    • 本文以從環境變數讀取存取憑證為例。如何配置訪問憑證，請參見配置訪問憑證。

    • 要佈建要求者付費模式，您必須有oss:PutBucketRequestPayment許可權；要擷取要求者付費模式，您必須有oss:GetBucketRequestPayment許可權。具體操作，請參見為RAM使用者授予自訂的權限原則。

    方法定義

    佈建要求者付費模式

    func (c *Client) PutBucketRequestPayment(ctx context.Context, request *PutBucketRequestPaymentRequest, optFns ...func(*Options)) (*PutBucketRequestPaymentResult, error)

    擷取要求者付費模式配置

    func (c *Client) GetBucketRequestPayment(ctx context.Context, request *GetBucketRequestPaymentRequest, optFns ...func(*Options)) (*GetBucketRequestPaymentResult, error)

    請求參數列表

    參數名

    類型

    說明

    ctx

    context.Context

    請求的上下文，可以用來佈建要求的總時限

    request

    *PutBucketRequestPaymentRequest

    設定具體介面的請求參數，具體請參見PutBucketRequestPaymentRequest

    *GetBucketRequestPaymentRequest

    設定具體介面的請求參數，具體請參見GetBucketRequestPaymentRequest

    optFns

    ...func(*Options)

    （可選）介面級的配置參數, 具體請參見Options

    傳回值列表

    傳回值名

    類型

    說明

    result

    *PutBucketRequestPaymentResult

    介面傳回值，當 err 為nil 時有效，具體請參見PutBucketRequestPaymentResult

    *GetBucketRequestPaymentResult

    介面傳回值，當 err 為nil 時有效，具體請參見GetBucketRequestPaymentResult

    err

    error

    請求的狀態，當請求失敗時，err 不為 nil

    範例程式碼

    佈建要求者付費模式

    您可以使用以下代碼佈建要求者付費模式。

    package main

import (
	"context"
	"flag"
	"log"

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

// 定義全域變數
var (
	region     string // 儲存地區
	bucketName string // 儲存空間名稱
)

// init函數用於初始化命令列參數
func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucketName, "bucket", "", "The name of the bucket.")
}

func main() {
	// 解析命令列參數
	flag.Parse()

	// 檢查bucket名稱是否為空白
	if len(bucketName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}

	// 檢查region是否為空白
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}

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

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

	// 建立設定儲存空間請求支付方式的請求
	putRequest := &oss.PutBucketRequestPaymentRequest{
		Bucket: oss.Ptr(bucketName), // 儲存空間名稱
		PaymentConfiguration: &oss.RequestPaymentConfiguration{
			Payer: oss.Requester, // 佈建要求支付方為要求者
		},
	}

	// 發送設定儲存空間請求支付方式的請求
	putResult, err := client.PutBucketRequestPayment(context.TODO(), putRequest)
	if err != nil {
		log.Fatalf("failed to put bucket request payment %v", err)
	}

	// 列印設定儲存空間請求支付方式的結果
	log.Printf("put bucket request payment result:%#v\n", putResult)
}

    擷取要求者付費模式配置

    您可以使用以下代碼擷取要求者付費模式配置資訊。

    package main

import (
	"context"
	"flag"
	"log"

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

// 定義全域變數
var (
	region     string // 儲存地區
	bucketName string // 儲存空間名稱
)

// init函數用於初始化命令列參數
func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucketName, "bucket", "", "The name of the bucket.")
}

func main() {
	// 解析命令列參數
	flag.Parse()

	// 檢查bucket名稱是否為空白
	if len(bucketName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}

	// 檢查region是否為空白
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}

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

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

	// 建立擷取儲存空間請求支付方式的請求
	getRequest := &oss.GetBucketRequestPaymentRequest{
		Bucket: oss.Ptr(bucketName), // 儲存空間名稱
	}

	// 執行擷取儲存空間請求支付方式的操作並處理結果
	getResult, err := client.GetBucketRequestPayment(context.TODO(), getRequest)
	if err != nil {
		log.Fatalf("failed to get bucket request payment %v", err)
	}

	// 列印擷取儲存空間請求支付方式的結果
	log.Printf("get bucket request payment result:%#v\n", getResult)
}

    相關文檔

    • 關於佈建要求者付費模式的完整範例程式碼，請參見Github樣本。

    • 關於佈建要求者付費模式的API介面，請參見PutBucketRequestPayment。

    • 關於擷取要求者付費模式配置資訊的完整範例程式碼，請參見Github樣本

    • 關於擷取要求者付費模式配置資訊的API介面，請參見GetBucketRequestPayment。