创建Agentic Bucket和Bucket Space

import com.aliyun.sdk.service.oss2.ClientConfiguration;
import com.aliyun.sdk.service.oss2.OSSClient;
import com.aliyun.sdk.service.oss2.agentic.BucketSpaceClient;
import com.aliyun.sdk.service.oss2.credentials.CredentialsProvider;
import com.aliyun.sdk.service.oss2.credentials.EnvironmentVariableCredentialsProvider;
import com.aliyun.sdk.service.oss2.models.*;

public class BucketSpacePutBucketSample {
    public static void main(String[] args) throws Exception {
        String region = "cn-hangzhou";
        String accountId = "1234567890123456";
        String agenticBucketPrefix = "my-agentic";
        String bucketSpacePrefix = "my-space";

        CredentialsProvider provider = new EnvironmentVariableCredentialsProvider();

        try (OSSClient client = BucketSpaceClient.create(ClientConfiguration.newBuilder()
                .credentialsProvider(provider)
                .region(region)
                .accountId(accountId)
                .build())) {

            PutBucketResult result = client.putBucket(PutBucketRequest.newBuilder()
                    .bucket(bucketSpacePrefix)
                    .agenticBucket(String.format("%s-%s-%s-ab-apsr", agenticBucketPrefix, accountId, region))
                    .build());

            System.out.printf("status code:%d, request id:%s%n",
                    result.statusCode(), result.requestId());

        } catch (Exception e) {
            System.out.printf("error:%n%s", e);
        }
    }
}

import argparse
import alibabacloud_oss_v2 as oss
import alibabacloud_oss_v2.agentic as oss_agentic

# 创建命令行参数解析器，并描述脚本用途：创建BucketSpace
parser = argparse.ArgumentParser(description="bucket space put bucket sample")

# 定义命令行参数，包括必需的地域、BucketSpace名称前缀、账号ID、
# 所属Agentic Bucket名称前缀以及可选的Endpoint
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
parser.add_argument('--bucket', help='The bucket space prefix name.', required=True)
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS')
parser.add_argument('--account_id', help='The account id.', required=True)
parser.add_argument('--agentic_bucket', help='The agentic bucket that the bucket space belongs to.', required=True)

def main():
    # 解析命令行参数，获取用户输入的值
    args = parser.parse_args()

    # 从环境变量中加载访问凭证信息，用于身份验证
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # 使用SDK默认配置创建配置对象，并设置认证提供者
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider

    # 设置配置对象的地域和账号ID属性
    cfg.region = args.region
    cfg.account_id = args.account_id

    # 如果提供了自定义Endpoint，则更新配置对象中的endpoint属性
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # 创建BucketSpace客户端。该客户端复用标准OSS Bucket/Object操作，
    # 并自动将BucketSpace名称前缀解析为完整名称{prefix}-{account_id}-{region}-bs-apsr
    client = oss_agentic.BucketSpaceClient.create(cfg)

    # 在指定的Agentic Bucket下创建BucketSpace。PutBucketRequest的bucket参数
    # 为BucketSpace名称前缀，agentic_bucket参数为所属Agentic Bucket的完整名称
    result = client.put_bucket(oss.models.PutBucketRequest(
        bucket=args.bucket,  # BucketSpace名称前缀
        agentic_bucket=f'{args.agentic_bucket}-{args.account_id}-{args.region}-ab-apsr',  # AgenticBucket完整名称
    ))

    # 打印操作结果的状态码和请求ID，以便确认请求状态
    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
          )

# 当此脚本被直接执行时，调用main函数开始处理逻辑
if __name__ == "__main__":
    main()

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

<?php

// 引入自动加载文件，加载依赖库
require_once __DIR__ . '/../vendor/autoload.php';

use AlibabaCloud\Oss\V2 as Oss;
use AlibabaCloud\Oss\V2\Agentic\BucketSpaceClient;

// 定义命令行参数描述，包括必需的地域、BucketSpace名称前缀、账号ID、
// 所属AgenticBucket名称前缀以及可选的Endpoint
$optsdesc = [
    "region" => ['help' => 'The region in which the bucket is located.', 'required' => True],
    "endpoint" => ['help' => 'The domain names that other services can use to access OSS.', 'required' => False],
    "account-id" => ['help' => 'The ID of the Alibaba Cloud account that owns the bucket.', 'required' => True],
    "bucket" => ['help' => 'The bucket space prefix name.', 'required' => True],
    "agentic-bucket" => ['help' => 'The agentic bucket that the bucket space belongs to.', 'required' => True],
];
$longopts = \array_map(function ($key) {
    return "$key:";
}, array_keys($optsdesc));
$options = getopt("", $longopts);
foreach ($optsdesc as $key => $value) {
    if ($value['required'] === True && empty($options[$key])) {
        $help = $value['help'];
        echo "Error: the following arguments are required: --$key, $help";
        exit(1);
    }
}

$region = $options["region"];
$accountId = $options["account-id"];
$bucket = $options["bucket"];
$agenticBucket = $options["agentic-bucket"];

// 从环境变量中加载访问凭证信息，用于身份验证
$credentialsProvider = new Oss\Credentials\EnvironmentVariableCredentialsProvider();

// 使用SDK默认配置创建配置对象。BucketSpaceClient会根据地域和账号ID
// 自动将BucketSpace名称前缀解析为完整名称：{prefix}-{accountId}-{region}-bs-apsr
$cfg = Oss\Config::loadDefault();
$cfg->setCredentialsProvider($credentialsProvider);
$cfg->setRegion($region);
$cfg->setAccountId($accountId);
if (isset($options["endpoint"])) {
    $cfg->setEndpoint($options["endpoint"]);
}

// 创建BucketSpace客户端。该客户端复用标准OSS Bucket/Object操作
$client = BucketSpaceClient::newClient($cfg);

try {
    // 在指定的AgenticBucket下创建BucketSpace。PutBucketRequest的bucket参数
    // 为BucketSpace名称前缀，agenticBucket参数为所属AgenticBucket的完整名称
    $request = new Oss\Models\PutBucketRequest($bucket);
    $request->agenticBucket = sprintf('%s-%s-%s-ab-apsr', $agenticBucket, $accountId, $region);

    $result = $client->putBucket($request);

    printf(
        'status code: %d' . PHP_EOL . 'request id: %s' . PHP_EOL,
        $result->statusCode,
        $result->requestId
    );
} catch (\Throwable $e) {
    printf("error: %s" . PHP_EOL, $e->getMessage());
    exit(1);
}

import AlibabaCloudOSS
import AlibabaCloudOSSAgentic
import Foundation
import ArgumentParser

@main
struct BucketSpacePutBucket: AsyncParsableCommand {
    func run() async throws {
        do {
            // 设置 OSS 区域（Region）
            let region = "cn-hangzhou"

            // 设置阿里云账号ID
            let accountId = "1234567890123456"

            // 设置所属AgenticBucket的名称前缀
            let agenticBucketPrefix = "my-agentic"

            // 设置要创建的BucketSpace名称前缀
            let bucketSpacePrefix = "my-space"

            // 创建配置对象，设置区域和账号ID
            let config = Configuration.default()
                .withRegion(region)
                .withCredentialsProvider(EnvironmentCredentialsProvider())
                .withAccountId(accountId)

            // 创建BucketSpace客户端。该客户端复用标准OSS Bucket/Object操作，
            // 并自动将BucketSpace名称前缀解析为完整名称：
            // {prefix}-{accountId}-{region}-bs-apsr
            let client = BucketSpaceClient.make(config)

            // 调用 putBucket 接口在指定的AgenticBucket下创建BucketSpace。
            // bucket参数为BucketSpace名称前缀，
            // agenticBucket参数为所属AgenticBucket的完整名称
            let result = try await client.putBucket(
                PutBucketRequest(
                    bucket: bucketSpacePrefix,
                    agenticBucket: "\(agenticBucketPrefix)-\(accountId)-\(region)-ab-apsr"
                )
            )

            // 打印请求结果信息
            print("PutBucket done, StatusCode:\(result.statusCode), RequestId:\(result.requestId).")
        } catch {
            BucketSpacePutBucket.exit(withError: error)
        }
    }
}