本文介绍如何使用OSS Go SDK V2完成Agentic Bucket的创建与管理、泛域名CNAME的绑定与解绑,以及BucketSpace的创建与文件上传。
注意事项
使用Agentic Bucket相关功能,您需要安装V1.6.0及以上版本的alibabacloud-oss-go-sdk-v2。
本文示例代码以华东1(杭州)的地域ID
cn-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(®ion, "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(®ion, "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(®ion, "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(®ion, "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(®ion, "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(®ion, "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(®ion, "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(®ion, "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(®ion, "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(®ion, "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(®ion, "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(®ion, "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(®ion, "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)
}相关文档
关于创建Agentic Bucket的完整示例代码,请参见create_agentic_bucket.go。
关于查询Agentic Bucket信息的完整示例代码,请参见get_agentic_bucket.go。
关于列举Agentic Bucket的完整示例代码,请参见list_agentic_buckets.go。
关于删除Agentic Bucket的完整示例代码,请参见delete_agentic_bucket.go。
关于创建域名所有权验证所需CnameToken的完整示例代码,请参见create_cname_token.go。
关于获取CnameToken的完整示例代码,请参见get_cname_token.go。
关于添加CNAME记录的完整示例代码,请参见put_cname.go。
关于查看CNAME记录的完整示例代码,请参见list_cname.go。
关于删除CNAME记录的完整示例代码,请参见delete_cname.go。
关于创建BucketSpace的完整示例代码,请参见bucket_space_put_bucket.go。
关于向BucketSpace上传文件的完整示例代码,请参见bucket_space_put_object.go。
关于CNAME相关接口的详细参数说明,请参见CreateCnameToken、PutCname、ListCname、GetCnameToken和DeleteCname。