Object Storage Service:OSS SDK for Goを使用してバケットに関する情報を照会する

バケットは、オブジェクトをOSS (Object Storage Service) に格納するために使用されるコンテナーです。 OSS SDK for Goを使用して、アクセス追跡状態、リージョン、作成日、アクセス制御リスト (ACL) 、所有者の名前とID、ストレージクラス、冗長性タイプ、パブリックエンドポイント、内部エンドポイント、クロスリージョンレプリケーション (CRR) 状態、バージョン管理状態、暗号化方法などのバケット情報を照会できます。 これにより、後続の操作を実行できます。 たとえば、取得したパブリックエンドポイントをオブジェクトの名前と一緒に使用して、オブジェクトにアクセスできます。

使用上の注意

• このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。 OSSと同じリージョンにある他のAlibaba CloudサービスからOSSにアクセスする場合は、内部エンドポイントを使用します。 OSSリージョンとエンドポイントの詳細については、「リージョン、エンドポイント、オープンポート」をご参照ください。

• このトピックでは、アクセス資格情報は環境変数から取得します。 アクセス資格情報の設定方法の詳細については、「アクセス資格情報の設定」をご参照ください。

• このトピックでは、OSSエンドポイントを使用してOSSClientインスタンスを作成します。 カスタムドメイン名またはSTS (Security Token Service) を使用してOSSClientインスタンスを作成する場合は、「初期化」をご参照ください。

• バケットに関する情報を照会するには、oss:GetBucketInfo権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

• Go 2.2.5以降のObject Storage Service (OSS) SDKは、次のサンプルコードに含まれるすべての属性をサポートします。

例

次のサンプルコードは、バケットに関する情報を照会する方法の例を示しています。

package main

import (
	"log"

	"github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func main() {
	// Obtain access credentials from environment variables. 
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		log.Fatalf("Failed to get credentials from environment variables: %v", err)
	}

	// Create an OSSClient instance. 
	// Specify the endpoint of the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com. Specify your actual endpoint. 
	// Specify the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou. Specify the actual region.
	clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
	clientOptions = append(clientOptions, oss.Region("yourRegion"))
	// Specify the version of the signature algorithm.
	clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
	client, err := oss.New("yourEndpoint", "", "", clientOptions...)
	if err != nil {
		log.Fatalf("Failed to create new OSS client: %v", err)
	}

	// Specify the name of the bucket. Example: examplebucket. 
	bucketName := "examplebucket"
	res, err := client.GetBucketInfo(bucketName)
	if err != nil {
		log.Fatalf("Failed to get bucket info for bucket '%s': %v", bucketName, err)
	}

	log.Printf("Bucket Info Name: %s\n", res.BucketInfo.Name)         // Display the name of the bucket.
	log.Printf("Bucket Info Location: %s\n", res.BucketInfo.Location) // Display the region in which the bucket is located.
}

バケット情報の共通パラメータ

関連ドキュメント

• バケットの詳細については、「概要」をご参照ください。

• バケットに関する情報を照会するために呼び出すことができるAPI操作の詳細については、「GetBucketInfo」をご参照ください。