全部產品
Search

搜尋本產品

    Object Storage Service：資源群組（Go SDK V2）

    文件中心

    Object Storage Service：資源群組（Go SDK V2）

    更新時間：Aug 02, 2025

    本文介紹如何配置儲存空間（Bucket）所屬資源群組以及擷取Bucket資源群組ID。

    注意事項

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

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

    • 要配置Bucket所屬資源群組，您必須擁有oss:PutBucketResourceGroup許可權。要擷取Bucket資源群組ID，您必須擁有oss:GetBucketResourceGroup許可權；具體操作，請參見為RAM使用者授予自訂的權限原則。

    方法定義

    配置Bucket所屬資源群組

    func (c *Client) PutBucketResourceGroup(ctx context.Context, request *PutBucketResourceGroupRequest, optFns ...func(*Options)) (*PutBucketResourceGroupResult, error)

    擷取Bucket資源群組ID

    func (c *Client) GetBucketResourceGroup(ctx context.Context, request *GetBucketResourceGroupRequest, optFns ...func(*Options)) (*GetBucketResourceGroupResult, error)

    請求參數列表

    參數名

    類型

    說明

    ctx

    context.Context

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

    request

    *PutBucketResourceGroupRequest

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

    *GetBucketResourceGroupRequest

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

    optFns

    ...func(*Options)

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

    傳回值列表

    傳回值名

    類型

    說明

    result

    *PutBucketResourceGroupResult

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

    *GetBucketResourceGroupRequest

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

    err

    error

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

    範例程式碼

    配置Bucket所屬資源群組

    重要

    配置Bucket所屬資源群組時，如果未指定資源群組ID，則Bucket歸屬於預設資源群組。如果您需要將Bucket加入指定資源群組，請確保已建立資源群組。具體操作，請參見建立資源群組。

    您可以使用以下代碼配置bucket所屬資源群組。

    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()

	// 填寫資源群組ID。如果未填寫資源群組ID，則bucket歸屬於預設資源群組
	var groupId string = "rg-aekz****"

	// 檢查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)

	// 建立設定儲存空間資源群組的請求
	request := &oss.PutBucketResourceGroupRequest{
		Bucket: oss.Ptr(bucketName), // 儲存空間名稱
		BucketResourceGroupConfiguration: &oss.BucketResourceGroupConfiguration{
			ResourceGroupId: oss.Ptr(groupId),
		},
	}

	// 發送設定儲存空間資源群組的請求
	result, err := client.PutBucketResourceGroup(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to put bucket resource group %v", err)
	}

	// 列印設定儲存空間資源群組的結果
	log.Printf("put bucket resource group result:%#v\n", result)
}

    擷取Bucket資源群組ID

    您可以使用以下代碼擷取bucket的資源群組ID。

    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)

	// 建立擷取儲存空間資源群組ID的請求
	request := &oss.GetBucketResourceGroupRequest{
		Bucket: oss.Ptr(bucketName), // 儲存空間名稱
	}

	// 執行擷取儲存空間資源群組ID的操作並處理結果
	result, err := client.GetBucketResourceGroup(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to get bucket resource group %v", err)
	}

	// 列印擷取儲存空間資源群組ID的結果
	log.Printf("get bucket resource group id:%#v\n", *result.BucketResourceGroupConfiguration.ResourceGroupId)
}

    相關文檔

    • 關於配置Bucket所屬資源群組的完整範例程式碼，請參見Github樣本。

    • 關於配置Bucket所屬資源群組的API介面，請參見PutBucketResourceGroup。

    • 關於擷取Bucket資源群組ID的完整範例程式碼，請參見Github樣本。

    • 關於擷取Bucket資源群組ID的API介面說明，請參見GetBucketResourceGroup。