すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:アクセス追跡 (Go SDK V2)

最終更新日:Nov 09, 2025

このトピックでは、OSS SDK for Go V2 を使用してバケットのアクセス追跡を有効にする方法について説明します。

使用上の注意

  • このトピックのサンプルコードでは、中国 (杭州) リージョンのリージョン ID cn-hangzhou を使用します。 デフォルトでは、パブリックエンドポイントを使用してバケット内のリソースにアクセスします。 ただし、バケットと同じリージョンにある他の Alibaba Cloud サービスからリソースにアクセスするには、内部エンドポイントを使用する必要があります。 詳細については、「OSS のリージョンとエンドポイント」をご参照ください。

  • このトピックのサンプルコードは、環境変数からアクセス資格情報を読み取ります。 詳細については、「アクセス資格情報の設定」をご参照ください。

サンプルコード

アクセス追跡を有効にする

次のコードは、バケットのアクセス追跡を有効にする方法の例を示しています。

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.")
}

// main 関数はバケットのアクセス追跡を有効にします。
func main() {
	// コマンドラインパラメーターを解析します。
	flag.Parse()

	// バケット名が空かどうかを確認します。
	if len(bucketName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}

	// リージョンが空かどうかを確認します。
	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.PutBucketAccessMonitorRequest{
		Bucket: oss.Ptr(bucketName),
		AccessMonitorConfiguration: &oss.AccessMonitorConfiguration{
			Status: oss.AccessMonitorStatusEnabled, // アクセス追跡を有効にします。
		},
	}

	// バケットのアクセス追跡を有効にする操作を実行します。
	putResult, err := client.PutBucketAccessMonitor(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to put bucket access monitor %v", err)
	}

	// 結果を出力します。
	log.Printf("put bucket access monitor 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()

	// バケット名が空かどうかを確認します。
	if len(bucketName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}

	// リージョンが空かどうかを確認します。
	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.GetBucketAccessMonitorRequest{
		Bucket: oss.Ptr(bucketName),
	}

	// アクセス追跡設定をクエリする操作を実行し、結果を処理します。
	result, err := client.GetBucketAccessMonitor(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to get bucket access monitor %v", err)
	}

	// 結果を出力します。
	log.Printf("get bucket access monitor result:%#v\n", result)
}

関連情報

  • アクセス追跡を有効にする API 操作の詳細については、「PutBucketAccessMonitor」をご参照ください。

  • アクセス追跡ステータスをクエリする API 操作の詳細については、「GetBucketAccessMonitor」をご参照ください。