Agentic Bucket(Go SDK V2)

更新时间:
复制 MD 格式

本文介绍如何使用OSS Go SDK V2完成Agentic Bucket的创建与管理、泛域名CNAME的绑定与解绑,以及BucketSpace的创建与文件上传。

注意事项

  • 使用Agentic Bucket相关功能,您需要安装V1.6.0及以上版本的alibabacloud-oss-go-sdk-v2。

  • 本文示例代码以华东1(杭州)的地域IDcn-hangzhou为例,默认使用外网Endpoint,如果您希望通过与OSS同地域的其他阿里云产品访问OSS,请使用内网Endpoint。关于OSS支持的Region与Endpoint的对应关系,请参见地域和Endpoint。

  • 使用oss/agentic包创建Agentic Bucket客户端(agentic.NewAgenticBucketClient)或BucketSpace客户端(agentic.NewBucketSpaceClient)时,必须在配置中通过WithRegion和WithAccountId同时设置地域与账号ID。请求中的Bucket参数为Bucket名称前缀,SDK会自动将其解析为完整名称:Agentic Bucket对应的完整名称为{prefix}-{accountId}-{region}-ab-apsr,BucketSpace对应的完整名称为{prefix}-{accountId}-{region}-bs-apsr。

  • 访问BucketSpace有两种方式,可按需选择:一是使用BucketSpace客户端(agentic.NewBucketSpaceClient),请求中的Bucket参数传入BucketSpace名称前缀,SDK自动将其解析为完整名称;二是使用agentic.NewBucketSpaceHelper创建BucketSpaceHelper,并通过其ToBucketName方法将名称前缀转换为完整名称,再通过标准客户端oss.NewClient访问BucketSpace,此方式下请求中的Bucket参数须传入完整名称。使用BucketSpaceHelper时,同样必须在配置中设置地域与账号ID。

  • CNAME相关操作(创建CnameToken、获取CnameToken、绑定CNAME、列举CNAME、删除CNAME)由标准客户端oss.NewClient(cfg)提供,请求中的Bucket参数须传入Agentic Bucket的完整名称,即{prefix}-{accountId}-{region}-ab-apsr。

  • 泛域名CNAME相关请求中,Domain或Cname参数须传入泛域名基础域(不含*.前缀),且基础域至少包含3段(例如example.com不合法,foo.example.com合法)。绑定泛域名CNAME前,需先为该基础域申请CnameToken并完成域名所有权验证;如果绑定证书,证书须为与*.基础域匹配的通配符证书。关于泛域名CNAME的完整规则,请参见PutCname。

示例代码

创建Agentic Bucket

以下代码用于创建Agentic 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/agentic"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)

// 定义命令行参数,包括必需的地域、Agentic Bucket名称前缀、账号ID以及可选的Endpoint
var (
	region    string
	bucket    string
	endpoint  string
	accountId string
)

func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucket, "bucket", "", "The name of the agentic bucket.")
	flag.StringVar(&endpoint, "endpoint", "", "The domain names that other services can use to access OSS.")
	flag.StringVar(&accountId, "account-id", "", "The account id.")
}

func main() {
	// 解析命令行参数,并校验必需参数
	flag.Parse()
	if len(bucket) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}
	if len(accountId) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, account id required")
	}

	// 使用SDK默认配置创建配置对象,并设置认证提供者、地域和账号ID。
	// 客户端会根据地域和账号ID自动将Bucket名称前缀解析为完整名称:
	// {prefix}-{accountId}-{region}-ab-apsr
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).
		WithAccountId(accountId)
	// 如果提供了自定义Endpoint,则更新配置对象中的Endpoint
	if len(endpoint) > 0 {
		cfg.WithEndpoint(endpoint)
	}

	// 使用上述配置初始化Agentic Bucket客户端
	client := agentic.NewAgenticBucketClient(cfg)

	// 创建Agentic Bucket,存储类型为Standard,数据容灾类型为LRS。
	// Bucket参数为Agentic Bucket名称前缀
	request := &agentic.CreateAgenticBucketRequest{
		Bucket: oss.Ptr(bucket),
		CreateAgenticBucketConfiguration: &agentic.CreateAgenticBucketConfiguration{
			StorageClass:       oss.StorageClassStandard,
			DataRedundancyType: oss.DataRedundancyLRS,
		},
	}
	result, err := client.CreateAgenticBucket(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to create agentic bucket %v", err)
	}
	log.Printf("create agentic bucket result:%#v\n", result)
}

查询Agentic Bucket信息

以下代码用于查询指定Agentic 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/agentic"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)

// 定义命令行参数,包括必需的地域、Agentic Bucket名称前缀、账号ID以及可选的Endpoint
var (
	region    string
	bucket    string
	endpoint  string
	accountId string
)

func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucket, "bucket", "", "The name of the agentic bucket.")
	flag.StringVar(&endpoint, "endpoint", "", "The domain names that other services can use to access OSS.")
	flag.StringVar(&accountId, "account-id", "", "The account id.")
}

func main() {
	// 解析命令行参数,并校验必需参数
	flag.Parse()
	if len(bucket) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}
	if len(accountId) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, account id required")
	}

	// 使用SDK默认配置创建配置对象,并设置认证提供者、地域和账号ID
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).
		WithAccountId(accountId)
	// 如果提供了自定义Endpoint,则更新配置对象中的Endpoint
	if len(endpoint) > 0 {
		cfg.WithEndpoint(endpoint)
	}

	// 使用上述配置初始化Agentic Bucket客户端
	client := agentic.NewAgenticBucketClient(cfg)

	// 查询指定Agentic Bucket的信息。Bucket参数为名称前缀
	request := &agentic.GetAgenticBucketRequest{
		Bucket: oss.Ptr(bucket),
	}
	result, err := client.GetAgenticBucket(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to get agentic bucket %v", err)
	}

	// 获取并打印Agentic Bucket的详细信息
	if info := result.AgenticBucketInfo; info != nil {
		log.Printf("agentic bucket info: name:%v, owner:%v, region:%v, storage class:%v, status:%v, acl:%v, versioning:%v, create time:%v\n",
			oss.ToString(info.Name), oss.ToString(info.Owner), oss.ToString(info.Region),
			oss.ToString(info.StorageClass), oss.ToString(info.Status), oss.ToString(info.ACL),
			oss.ToString(info.Versioning), oss.ToString(info.CreateTime))
	}
}

列举Agentic Bucket

以下代码用于列举当前账号在指定地域下的所有Agentic 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/agentic"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)

// 定义命令行参数,包括必需的地域、账号ID以及可选的Endpoint
var (
	region    string
	endpoint  string
	accountId string
)

func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&endpoint, "endpoint", "", "The domain names that other services can use to access OSS.")
	flag.StringVar(&accountId, "account-id", "", "The account id.")
}

func main() {
	// 解析命令行参数,并校验必需参数
	flag.Parse()
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}
	if len(accountId) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, account id required")
	}

	// 使用SDK默认配置创建配置对象,并设置认证提供者、地域和账号ID
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).
		WithAccountId(accountId)
	// 如果提供了自定义Endpoint,则更新配置对象中的Endpoint
	if len(endpoint) > 0 {
		cfg.WithEndpoint(endpoint)
	}

	// 使用上述配置初始化Agentic Bucket客户端
	client := agentic.NewAgenticBucketClient(cfg)

	// 创建ListAgenticBuckets分页器
	request := &agentic.ListAgenticBucketsRequest{}
	p := client.NewListAgenticBucketsPaginator(request)

	// 逐页遍历当前账号在指定地域下的所有Agentic Bucket
	var i int
	log.Println("Agentic Buckets:")
	for p.HasNext() {
		i++
		page, err := p.NextPage(context.TODO())
		if err != nil {
			log.Fatalf("failed to get page %v, %v", i, err)
		}
		for _, b := range page.AgenticBuckets {
			// 打印每个Agentic Bucket的完整名称、存储类型、数据容灾类型和创建时间
			log.Printf("Agentic Bucket: name:%v, storage class:%v, data redundancy type:%v, create time:%v\n",
				oss.ToString(b.Name), oss.ToString(b.StorageClass), oss.ToString(b.DataRedundancyType), oss.ToString(b.CreateTime))
		}
	}
}

删除Agentic Bucket

以下代码用于删除指定的Agentic 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/agentic"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)

// 定义命令行参数,包括必需的地域、Agentic Bucket名称前缀、账号ID以及可选的Endpoint
var (
	region    string
	bucket    string
	endpoint  string
	accountId string
)

func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucket, "bucket", "", "The name of the agentic bucket.")
	flag.StringVar(&endpoint, "endpoint", "", "The domain names that other services can use to access OSS.")
	flag.StringVar(&accountId, "account-id", "", "The account id.")
}

func main() {
	// 解析命令行参数,并校验必需参数
	flag.Parse()
	if len(bucket) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}
	if len(accountId) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, account id required")
	}

	// 使用SDK默认配置创建配置对象,并设置认证提供者、地域和账号ID
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).
		WithAccountId(accountId)
	// 如果提供了自定义Endpoint,则更新配置对象中的Endpoint
	if len(endpoint) > 0 {
		cfg.WithEndpoint(endpoint)
	}

	// 使用上述配置初始化Agentic Bucket客户端
	client := agentic.NewAgenticBucketClient(cfg)

	// 删除指定的Agentic Bucket。Bucket参数为名称前缀
	request := &agentic.DeleteAgenticBucketRequest{
		Bucket: oss.Ptr(bucket),
	}
	result, err := client.DeleteAgenticBucket(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to delete agentic bucket %v", err)
	}
	log.Printf("delete agentic bucket result:%#v\n", result)
}

创建CnameToken(泛域名)

以下代码用于为Agentic Bucket上的泛域名基础域申请CnameToken。

package main

import (
	"context"
	"flag"
	"fmt"
	"log"

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

var (
	region    string
	bucket    string
	endpoint  string
	accountId string
	domain    string
)

func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucket, "bucket", "", "The name of the agentic bucket.")
	flag.StringVar(&endpoint, "endpoint", "", "The domain names that other services can use to access OSS.")
	flag.StringVar(&accountId, "account-id", "", "The account id.")
	flag.StringVar(&domain, "domain", "", "The base domain name of the wildcard domain, without the \"*.\" prefix.")
}

func main() {
	flag.Parse()
	if len(bucket) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}
	if len(accountId) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, account id required")
	}
	if len(domain) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, domain name required")
	}

	// 使用SDK默认配置创建配置对象,并从环境变量中加载访问凭证
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).
		WithAccountId(accountId)
	if len(endpoint) > 0 {
		cfg.WithEndpoint(endpoint)
	}

	// CNAME相关操作由标准客户端提供,请求中的Bucket须传入Agentic Bucket完整名称
	client := oss.NewClient(cfg)

	// Agentic Bucket完整名称为{bucket}-{accountId}-{region}-ab-apsr
	agenticBucket := fmt.Sprintf("%s-%s-%s-ab-apsr", bucket, accountId, region)

	// 为泛域名基础域申请CnameToken。Domain传入不含*.前缀的基础域,
	// IsWildCard设置为true,表示为泛域名CNAME申请CnameToken
	request := &oss.CreateCnameTokenRequest{
		Bucket: oss.Ptr(agenticBucket),
		BucketCnameConfiguration: &oss.BucketCnameConfiguration{
			Cname: &oss.Cname{
				Domain:     oss.Ptr(domain),
				IsWildCard: oss.Ptr(true),
			},
		},
	}
	result, err := client.CreateCnameToken(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to create cname token %v", err)
	}
	log.Printf("create cname token result:%#v\n", result)
}

获取CnameToken(泛域名)

以下代码用于获取Agentic Bucket上泛域名CNAME的CnameToken。

package main

import (
	"context"
	"flag"
	"fmt"
	"log"

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

var (
	region    string
	bucket    string
	endpoint  string
	accountId string
	domain    string
)

func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucket, "bucket", "", "The name of the agentic bucket.")
	flag.StringVar(&endpoint, "endpoint", "", "The domain names that other services can use to access OSS.")
	flag.StringVar(&accountId, "account-id", "", "The account id.")
	flag.StringVar(&domain, "domain", "", "The base domain name of the wildcard domain, without the \"*.\" prefix.")
}

func main() {
	flag.Parse()
	if len(bucket) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}
	if len(accountId) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, account id required")
	}
	if len(domain) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, domain name required")
	}

	// 使用SDK默认配置创建配置对象,并从环境变量中加载访问凭证
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).
		WithAccountId(accountId)
	if len(endpoint) > 0 {
		cfg.WithEndpoint(endpoint)
	}

	// CNAME相关操作由标准客户端提供,请求中的Bucket须传入Agentic Bucket完整名称
	client := oss.NewClient(cfg)

	// Agentic Bucket完整名称为{bucket}-{accountId}-{region}-ab-apsr
	Agentic Bucket := fmt.Sprintf("%s-%s-%s-ab-apsr", bucket, accountId, region)

	// 获取泛域名基础域的CnameToken。Cname传入不含*.前缀的基础域,
	// Wildcard设置为true,表示获取泛域名CNAME的CnameToken
	request := &oss.GetCnameTokenRequest{
		Bucket:   oss.Ptr(agenticBucket),
		Cname:    oss.Ptr(domain),
		Wildcard: oss.Ptr(true),
	}
	result, err := client.GetCnameToken(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to get cname token %v", err)
	}
	log.Printf("get cname token result:%#v\n", result)
}

绑定泛域名CNAME

以下代码用于为Agentic Bucket绑定泛域名CNAME。

package main

import (
	"context"
	"flag"
	"fmt"
	"log"

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

var (
	region    string
	bucket    string
	endpoint  string
	accountId string
	domain    string
)

func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucket, "bucket", "", "The name of the agentic bucket.")
	flag.StringVar(&endpoint, "endpoint", "", "The domain names that other services can use to access OSS.")
	flag.StringVar(&accountId, "account-id", "", "The account id.")
	flag.StringVar(&domain, "domain", "", "The base domain name of the wildcard domain, without the \"*.\" prefix.")
}

func main() {
	flag.Parse()
	if len(bucket) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}
	if len(accountId) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, account id required")
	}
	if len(domain) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, domain name required")
	}

	// 使用SDK默认配置创建配置对象,并从环境变量中加载访问凭证
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).
		WithAccountId(accountId)
	if len(endpoint) > 0 {
		cfg.WithEndpoint(endpoint)
	}

	// CNAME相关操作由标准客户端提供,请求中的Bucket须传入Agentic Bucket完整名称
	client := oss.NewClient(cfg)

	// Agentic Bucket完整名称为{bucket}-{accountId}-{region}-ab-apsr
	agenticBucket := fmt.Sprintf("%s-%s-%s-ab-apsr", bucket, accountId, region)

	// SSL证书相关参数。泛域名CNAME须使用与*.基础域匹配的通配符证书
	certId := "493****-cn-hangzhou"
	certificate := `-----BEGIN CERTIFICATE-----
MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC
**** -----END CERTIFICATE-----`
	privateKey := `-----BEGIN CERTIFICATE-----
MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC
**** -----END CERTIFICATE-----`

	// 为Agentic Bucket绑定泛域名CNAME。Domain传入不含*.前缀的基础域,
	// IsWildCard设置为true,表示绑定泛域名CNAME
	request := &oss.PutCnameRequest{
		Bucket: oss.Ptr(agenticBucket),
		BucketCnameConfiguration: &oss.BucketCnameConfiguration{
			Cname: &oss.Cname{
				Domain:     oss.Ptr(domain),
				IsWildCard: oss.Ptr(true),
				CertificateConfiguration: &oss.CertificateConfiguration{
					Certificate: oss.Ptr(certificate),
					PrivateKey:  oss.Ptr(privateKey),
					CertId:      oss.Ptr(certId),
				},
			},
		},
	}
	result, err := client.PutCname(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to put cname %v", err)
	}
	log.Printf("put cname result:%#v\n", result)
}

列举CNAME记录

以下代码用于列举Agentic Bucket下的CNAME记录。

package main

import (
	"context"
	"flag"
	"fmt"
	"log"

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

var (
	region    string
	bucket    string
	endpoint  string
	accountId string
)

func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucket, "bucket", "", "The name of the agentic bucket.")
	flag.StringVar(&endpoint, "endpoint", "", "The domain names that other services can use to access OSS.")
	flag.StringVar(&accountId, "account-id", "", "The account id.")
}

func main() {
	flag.Parse()
	if len(bucket) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}
	if len(accountId) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, account id required")
	}

	// 使用SDK默认配置创建配置对象,并从环境变量中加载访问凭证
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).
		WithAccountId(accountId)
	if len(endpoint) > 0 {
		cfg.WithEndpoint(endpoint)
	}

	// CNAME相关操作由标准客户端提供,请求中的Bucket须传入Agentic Bucket完整名称
	client := oss.NewClient(cfg)

	// Agentic Bucket完整名称为{bucket}-{accountId}-{region}-ab-apsr
	agenticBucket := fmt.Sprintf("%s-%s-%s-ab-apsr", bucket, accountId, region)

	// 列举指定Agentic Bucket下的CNAME记录
	request := &oss.ListCnameRequest{
		Bucket: oss.Ptr(agenticBucket),
	}
	result, err := client.ListCname(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to list cname %v", err)
	}

	// 遍历并打印每条CNAME记录的详细信息
	for _, r := range result.Cnames {
		// IsWildCard为true表示该条记录为泛域名CNAME
		log.Printf("cname: domain:%v, last modified:%v, is wild card:%v, status:%v\n",
			oss.ToString(r.Domain), oss.ToString(r.LastModified), oss.ToBool(r.IsWildCard), oss.ToString(r.Status))
	}
}

删除泛域名CNAME

以下代码用于删除Agentic Bucket上的泛域名CNAME。

package main

import (
	"context"
	"flag"
	"fmt"
	"log"

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

var (
	region    string
	bucket    string
	endpoint  string
	accountId string
	domain    string
)

func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucket, "bucket", "", "The name of the agentic bucket.")
	flag.StringVar(&endpoint, "endpoint", "", "The domain names that other services can use to access OSS.")
	flag.StringVar(&accountId, "account-id", "", "The account id.")
	flag.StringVar(&domain, "domain", "", "The base domain name of the wildcard domain, without the \"*.\" prefix.")
}

func main() {
	flag.Parse()
	if len(bucket) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}
	if len(accountId) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, account id required")
	}
	if len(domain) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, domain name required")
	}

	// 使用SDK默认配置创建配置对象,并从环境变量中加载访问凭证
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).
		WithAccountId(accountId)
	if len(endpoint) > 0 {
		cfg.WithEndpoint(endpoint)
	}

	// CNAME相关操作由标准客户端提供,请求中的Bucket须传入Agentic Bucket完整名称
	client := oss.NewClient(cfg)

	// Agentic Bucket完整名称为{bucket}-{accountId}-{region}-ab-apsr
	agenticBucket := fmt.Sprintf("%s-%s-%s-ab-apsr", bucket, accountId, region)

	// 删除Agentic Bucket上的泛域名CNAME。Domain传入不含*.前缀的基础域,
	// IsWildCard设置为true,表示删除泛域名CNAME
	request := &oss.DeleteCnameRequest{
		Bucket: oss.Ptr(agenticBucket),
		BucketCnameConfiguration: &oss.BucketCnameConfiguration{
			Cname: &oss.Cname{
				Domain:     oss.Ptr(domain),
				IsWildCard: oss.Ptr(true),
			},
		},
	}
	result, err := client.DeleteCname(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to delete cname %v", err)
	}
	log.Printf("delete cname result:%#v\n", result)
}

创建BucketSpace

以下代码用于在指定的Agentic Bucket下创建BucketSpace。SDK提供两种访问BucketSpace的方式,以下示例分别演示,您可按需选择。

方式一:使用agentic.NewBucketSpaceClient创建BucketSpace客户端,请求中的Bucket参数传入BucketSpace名称前缀。

package main

import (
	"context"
	"flag"
	"fmt"
	"log"

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

var (
	region        string
	bucket        string
	endpoint      string
	accountId     string
	agenticBucket string
)

func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucket, "bucket", "", "The bucket space prefix name.")
	flag.StringVar(&endpoint, "endpoint", "", "The domain names that other services can use to access OSS.")
	flag.StringVar(&accountId, "account-id", "", "The account id.")
	flag.StringVar(&agenticBucket, "agentic-bucket", "", "The agentic bucket that the bucket space belongs to.")
}

func main() {
	flag.Parse()
	if len(bucket) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}
	if len(accountId) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, account id required")
	}
	if len(agenticBucket) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, agentic bucket name required")
	}

	// 使用SDK默认配置创建配置对象,并从环境变量中加载访问凭证
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).
		WithAccountId(accountId)
	if len(endpoint) > 0 {
		cfg.WithEndpoint(endpoint)
	}

	// 创建BucketSpace客户端。该客户端复用标准OSS Bucket/Object操作,
	// 并自动将BucketSpace名称前缀解析为完整名称{bucket}-{accountId}-{region}-bs-apsr
	client := agentic.NewBucketSpaceClient(cfg)

	// 在指定的Agentic Bucket下创建BucketSpace。PutBucketRequest的Bucket参数
	// 为BucketSpace名称前缀,Agentic Bucket参数为所属Agentic Bucket的完整名称
	request := &oss.PutBucketRequest{
		Bucket:        oss.Ptr(bucket),
		AgenticBucket: oss.Ptr(fmt.Sprintf("%s-%s-%s-ab-apsr", agenticBucket, accountId, region)),
	}
	result, err := client.PutBucket(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to put bucket space %v", err)
	}
	log.Printf("put bucket space result:%#v\n", result)
}

方式二:使用agentic.NewBucketSpaceHelper和标准客户端oss.NewClient,请求中的Bucket参数传入转换后的BucketSpace完整名称。

package main

import (
	"context"
	"flag"
	"fmt"
	"log"

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

var (
	region        string
	bucket        string
	endpoint      string
	accountId     string
	agenticBucket string
)

func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucket, "bucket", "", "The bucket space prefix name.")
	flag.StringVar(&endpoint, "endpoint", "", "The domain names that other services can use to access OSS.")
	flag.StringVar(&accountId, "account-id", "", "The account id.")
	flag.StringVar(&agenticBucket, "agentic-bucket", "", "The agentic bucket that the bucket space belongs to.")
}

func main() {
	flag.Parse()
	if len(bucket) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}
	if len(accountId) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, account id required")
	}
	if len(agenticBucket) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, agentic bucket name required")
	}

	// 使用SDK默认配置创建配置对象,并从环境变量中加载访问凭证
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).
		WithAccountId(accountId)
	if len(endpoint) > 0 {
		cfg.WithEndpoint(endpoint)
	}

	// 创建标准OSS客户端
	client := oss.NewClient(cfg)

	// 创建BucketSpaceHelper。该Helper根据配置中的账号ID和地域,
	// 将BucketSpace名称前缀转换为完整名称{bucket}-{accountId}-{region}-bs-apsr
	helper := agentic.NewBucketSpaceHelper(cfg)

	// 在指定的Agentic Bucket下创建BucketSpace。PutBucketRequest的Bucket参数
	// 为helper.ToBucketName转换后的BucketSpace完整名称,Agentic Bucket参数为所属Agentic Bucket的完整名称
	request := &oss.PutBucketRequest{
		Bucket:        oss.Ptr(helper.ToBucketName(bucket)),
		AgenticBucket: oss.Ptr(fmt.Sprintf("%s-%s-%s-ab-apsr", agenticBucket, accountId, region)),
	}
	result, err := client.PutBucket(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to put bucket space %v", err)
	}
	log.Printf("put bucket space result:%#v\n", result)
}

向BucketSpace上传文件

以下代码用于向指定的BucketSpace上传文件(Object)。以下示例分别演示两种访问方式。

方式一:使用agentic.NewBucketSpaceClient创建BucketSpace客户端,请求中的Bucket参数传入BucketSpace名称前缀。

package main

import (
	"context"
	"flag"
	"log"
	"strings"

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

var (
	region    string
	bucket    string
	endpoint  string
	accountId string
	object    string
)

func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucket, "bucket", "", "The name of the bucket space.")
	flag.StringVar(&endpoint, "endpoint", "", "The domain names that other services can use to access OSS.")
	flag.StringVar(&accountId, "account-id", "", "The account id.")
	flag.StringVar(&object, "object", "", "The name of the object.")
}

func main() {
	flag.Parse()
	if len(bucket) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}
	if len(accountId) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, account id required")
	}
	if len(object) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, object name required")
	}

	// 使用SDK默认配置创建配置对象,并从环境变量中加载访问凭证
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).
		WithAccountId(accountId)
	if len(endpoint) > 0 {
		cfg.WithEndpoint(endpoint)
	}

	// 创建BucketSpace客户端。该客户端复用标准OSS Bucket/Object操作,
	// 并自动将BucketSpace名称前缀解析为完整名称{bucket}-{accountId}-{region}-bs-apsr
	client := agentic.NewBucketSpaceClient(cfg)

	// 向指定的BucketSpace上传文件
	request := &oss.PutObjectRequest{
		Bucket: oss.Ptr(bucket),
		Key:    oss.Ptr(object),
		Body:   strings.NewReader("hello world"),
	}
	result, err := client.PutObject(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to put object %v", err)
	}
	log.Printf("put object result:%#v\n", result)
}

方式二:使用agentic.NewBucketSpaceHelper和标准客户端oss.NewClient,请求中的Bucket参数传入转换后的BucketSpace完整名称。

package main

import (
	"context"
	"flag"
	"log"
	"strings"

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

var (
	region    string
	bucket    string
	endpoint  string
	accountId string
	object    string
)

func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucket, "bucket", "", "The name of the bucket space.")
	flag.StringVar(&endpoint, "endpoint", "", "The domain names that other services can use to access OSS.")
	flag.StringVar(&accountId, "account-id", "", "The account id.")
	flag.StringVar(&object, "object", "", "The name of the object.")
}

func main() {
	flag.Parse()
	if len(bucket) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}
	if len(accountId) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, account id required")
	}
	if len(object) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, object name required")
	}

	// 使用SDK默认配置创建配置对象,并从环境变量中加载访问凭证
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).
		WithAccountId(accountId)
	if len(endpoint) > 0 {
		cfg.WithEndpoint(endpoint)
	}

	// 创建标准OSS客户端
	client := oss.NewClient(cfg)

	// 创建BucketSpaceHelper,用于将BucketSpace名称前缀转换为完整名称
	// {bucket}-{accountId}-{region}-bs-apsr
	helper := agentic.NewBucketSpaceHelper(cfg)

	// 向指定的BucketSpace上传文件。PutObjectRequest的Bucket参数
	// 为helper.ToBucketName转换后的BucketSpace完整名称
	request := &oss.PutObjectRequest{
		Bucket: oss.Ptr(helper.ToBucketName(bucket)),
		Key:    oss.Ptr(object),
		Body:   strings.NewReader("hello world"),
	}
	result, err := client.PutObject(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to put object %v", err)
	}
	log.Printf("put object result:%#v\n", result)
}