AgentBay:OSS

Golang

// OSS 環境変数を初期化して作成します。
func (o *Oss) EnvInit(accessKeyId, accessKeySecret, securityToken, endpoint, region string) (*EnvInitResult, error)

パラメーター:

• accessKeyId: OSS 認証用の AccessKey ID。

• accessKeySecret: OSS 認証用の AccessKey Secret。

• securityToken: OSS 認証用のセキュリティトークン。

• endpoint: OSS サービスのエンドポイント。このパラメーターを指定しない場合は、デフォルト値が使用されます。

• region: OSS リージョン。このパラメーターを指定しない場合は、デフォルト値が使用されます。

戻り値:

• *EnvInitResult: 初期化結果とリクエスト ID を含むオブジェクト。

• error: 操作が失敗した場合のエラーメッセージ。

EnvInitResult 構造体:

type EnvInitResult struct {
    RequestID string // デバッグ用の一意のリクエスト識別子。
    Result    string // 環境初期化操作の結果。
}

例:

package main

import (
	"fmt"
	"os"

	"github.com/aliyun/wuying-agentbay-sdk/golang/pkg/agentbay"
)

func main() {
	// SDK を初期化します。
	client, err := agentbay.NewAgentBay("your_api_key", nil)
	if err != nil {
		fmt.Printf("Error initializing AgentBay client: %v\n", err)
		os.Exit(1)
	}

	// OSS 環境を初期化します。
	result, err := client.Oss.EnvInit(
		"your_access_key_id",
		"your_access_key_secret",
		"your_security_token",
		"oss-cn-hangzhou.aliyuncs.com",
		"cn-hangzhou",
	)
	if err != nil {
		fmt.Printf("Error initializing OSS environment: %v\n", err)
		os.Exit(1)
	}

	fmt.Printf("OSS environment initialized successfully, request ID: %s\n", result.RequestID)
}

Python

def env_init(self, access_key_id: str, access_key_secret: str, securityToken: Optional[str] = None,
             endpoint: Optional[str] = None, region: Optional[str] = None) -> OSSClientResult

パラメーター:

• access_key_id: OSS 認証用の AccessKey ID。

• access_key_secret: OSS 認証用の AccessKey Secret。

• securityToken: OSS 認証用のセキュリティトークン。このパラメーターはオプションです。

• endpoint: OSS サービスのエンドポイント。このパラメーターを指定しない場合は、デフォルト値が使用されます。

• region: OSS リージョン。このパラメーターを指定しない場合は、デフォルト値が使用されます。

戻り値:

• OSSClientResult: クライアント構成、リクエスト ID、成功ステータス、およびエラーメッセージを含む結果オブジェクト。

OSSClientResult 構造体:

class OSSClientResult(ApiResponse):
    def __init__(self, request_id: str = "", success: bool = False,
                 client_config: Optional[Dict[str, Any]] = None, error_message: str = "")

例:

from agentbay import AgentBay

# SDK を初期化します。
agent_bay = AgentBay(api_key="your_api_key")

# OSS 環境を初期化します。
result = agent_bay.oss.env_init(
    access_key_id="your_access_key_id",
    access_key_secret="your_access_key_secret",
    securityToken="your_security_token",
    endpoint="oss-cn-hangzhou.aliyuncs.com",
    region="cn-hangzhou"
)

if result.success:
    print(f"OSS environment initialized successfully, request ID: {result.request_id}")
else:
    print(f"Failed to initialize OSS environment: {result.error_message}")

TypeScript

async envInit(
  accessKeyId: string,
  accessKeySecret: string,
  securityToken: string,
  endpoint?: string,
  region?: string
): Promise<string>

パラメーター:

• accessKeyId: OSS 認証用の AccessKey ID。

• accessKeySecret: OSS 認証用の AccessKey Secret。

• securityToken: OSS 認証用のセキュリティトークン。

• endpoint: OSS サービスのエンドポイント。このパラメーターを指定しない場合は、デフォルト値が使用されます。

• region: OSS リージョン。このパラメーターを指定しない場合は、デフォルト値が使用されます。

戻り値:

• Promise<string>: 環境初期化操作の結果。

例外:

• APIError: 環境の初期化が失敗した場合にスローされます。

例:

import { AgentBay } from 'wuying-agentbay-sdk';

// SDK を初期化します。
const agentBay = new AgentBay({ apiKey: 'your_api_key' });

// OSS 環境を初期化します。
async function initializeOSS() {
  try {
    const result = await agentBay.oss.envInit(
      'your_access_key_id',
      'your_access_key_secret',
      'your_security_token',
      'oss-cn-hangzhou.aliyuncs.com',
      'cn-hangzhou'
    );
    console.log('OSS environment initialized successfully:', result);
  } catch (error) {
    console.error('Error initializing OSS environment:', error);
  }
}

initializeOSS();

Golang

// ローカルファイルまたはフォルダを OSS にアップロードします。
func (o *Oss) Upload(bucket, object, path string) (*UploadResult, error)

パラメーター:

• bucket: OSS バケットの名前。

• object: OSS のオブジェクトキー。

• path: ローカルファイルまたはフォルダのパス。

戻り値:

• *UploadResult: アップロード URL とリクエスト ID を含むオブジェクト。

• error: 操作が失敗した場合のエラーメッセージ。

UploadResult 構造体:

type UploadResult struct {
    RequestID string // デバッグ用の一意のリクエスト識別子。
    URL       string // アップロードされたファイルの URL。
}

例:

package main

import (
	"fmt"
	"os"

	"github.com/aliyun/wuying-agentbay-sdk/golang/pkg/agentbay"
)

func main() {
	// SDK を初期化します。
	client, err := agentbay.NewAgentBay("your_api_key", nil)
	if err != nil {
		fmt.Printf("Error initializing AgentBay client: %v\n", err)
		os.Exit(1)
	}

	// ステップ 1: OSS 環境を初期化します。
	_, err = client.Oss.EnvInit(
		"your_access_key_id",
		"your_access_key_secret",
		"your_security_token",
		"oss-cn-hangzhou.aliyuncs.com",
		"cn-hangzhou",
	)
	if err != nil {
		fmt.Printf("Error initializing OSS environment: %v\n", err)
		os.Exit(1)
	}

	// ステップ 2: ファイルを OSS にアップロードします。
	result, err := client.Oss.Upload("my-bucket", "my-object", "/path/to/local/file")
	if err != nil {
		fmt.Printf("Error uploading file: %v\n", err)
		os.Exit(1)
	}

	fmt.Printf("File uploaded successfully, URL: %s, request ID: %s\n", result.URL, result.RequestID)
}

Python

def upload(self, bucket: str, object: str, path: str) -> OSSUploadResult

パラメーター:

• bucket: OSS バケットの名前。

• object: OSS のオブジェクトキー。

• path: ローカルファイルまたはフォルダのパス。

戻り値:

• OSSUploadResult: アップロード結果、リクエスト ID、成功ステータス、およびエラーメッセージを含む結果オブジェクト。

OSSUploadResult 構造体:

class OSSUploadResult(ApiResponse):
    def __init__(self, request_id: str = "", success: bool = False,
                 content: str = "", error_message: str = "")

例:

from wuying_agentbay_sdk import AgentBay

# SDK を初期化します。
agent_bay = AgentBay(api_key="your_api_key")

# ステップ 1: OSS 環境を初期化します。
agent_bay.oss.env_init(
    access_key_id="your_access_key_id",
    access_key_secret="your_access_key_secret",
    security_token="your_security_token",
    endpoint="oss-cn-hangzhou.aliyuncs.com",
    region="cn-hangzhou"
)

# ステップ 2: ファイルをアップロードします。
result = agent_bay.oss.upload("my-bucket", "my-object", "/path/to/local/file")
print("File uploaded successfully:", result)

TypeScript

async createClient(
  accessKeyId: string,
  accessKeySecret: string,
  endpoint?: string,
  region?: string
): Promise<string>

パラメーター:

• accessKeyId: OSS 認証用の AccessKey ID。

• accessKeySecret: OSS 認証用の AccessKey Secret。

• endpoint: OSS サービスのエンドポイント。このパラメーターを指定しない場合は、デフォルト値が使用されます。

• region: OSS リージョン。このパラメーターを指定しない場合は、デフォルト値が使用されます。

戻り値:

• Promise<string>: クライアント作成操作の結果。

例外:

• APIError: クライアントの作成が失敗した場合にスローされます。

例:

import { AgentBay } from 'wuying-agentbay-sdk';

// SDK を初期化します。
const agentBay = new AgentBay({ apiKey: 'your_api_key' });

// OSS クライアントを作成します。
async function createOSSClient() {
  try {
    const result = await agentBay.oss.createClient(
      'your_access_key_id',
      'your_access_key_secret',
      'oss-cn-hangzhou.aliyuncs.com',
      'cn-hangzhou'
    );
    console.log('OSS client created successfully:', result);
  } catch (error) {
    console.error('Error creating OSS client:', error);
  }
}

createOSSClient();

Golang

// ローカルファイルまたはフォルダを OSS にアップロードします。
func (o *Oss) Upload(bucket, object, path string) (*UploadResult, error)

パラメーター:

• bucket: OSS バケットの名前。

• object: OSS のオブジェクトキー。

• path: ローカルファイルまたはフォルダのパス。

戻り値:

• *UploadResult: アップロード URL とリクエスト ID を含むオブジェクト。

• error: 操作が失敗した場合のエラーメッセージ。

UploadResult 構造体:

type UploadResult struct {
    RequestID string // デバッグ用の一意のリクエスト識別子。
    URL       string // アップロードされたファイルの URL。
}

例:

package main

import (
	"fmt"
	"os"

	"github.com/aliyun/wuying-agentbay-sdk/golang/pkg/agentbay"
)

func main() {
	// SDK を初期化します。
	client, err := agentbay.NewAgentBay("your_api_key", nil)
	if err != nil {
		fmt.Printf("Error initializing AgentBay client: %v\n", err)
		os.Exit(1)
	}

	// ステップ 1: OSS 環境を初期化します。
	_, err = client.Oss.EnvInit(
		"your_access_key_id",
		"your_access_key_secret",
		"your_security_token",
		"oss-cn-hangzhou.aliyuncs.com",
		"cn-hangzhou",
	)
	if err != nil {
		fmt.Printf("Error initializing OSS environment: %v\n", err)
		os.Exit(1)
	}

	// ステップ 2: ファイルを OSS にアップロードします。
	result, err := client.Oss.Upload("my-bucket", "my-object", "/path/to/local/file")
	if err != nil {
		fmt.Printf("Error uploading file: %v\n", err)
		os.Exit(1)
	}

	fmt.Printf("File uploaded successfully, URL: %s, request ID: %s\n", result.URL, result.RequestID)
}

Python

def upload(self, bucket: str, object: str, path: str) -> OSSUploadResult

パラメーター:

• bucket: OSS バケットの名前。

• object: OSS のオブジェクトキー。

• path: ローカルファイルまたはフォルダのパス。

戻り値:

• OSSUploadResult: アップロード結果、リクエスト ID、成功ステータス、およびエラーメッセージを含む結果オブジェクト。

OSSUploadResult 構造体:

class OSSUploadResult(ApiResponse):
    def __init__(self, request_id: str = "", success: bool = False,
                 content: str = "", error_message: str = "")

例:

from wuying_agentbay_sdk import AgentBay

# SDK を初期化します。
agent_bay = AgentBay(api_key="your_api_key")

# ステップ 1: OSS 環境を初期化します。
agent_bay.oss.env_init(
    access_key_id="your_access_key_id",
    access_key_secret="your_access_key_secret",
    security_token="your_security_token",
    endpoint="oss-cn-hangzhou.aliyuncs.com",
    region="cn-hangzhou"
)

# ステップ 2: ファイルをアップロードします。
result = agent_bay.oss.upload("my-bucket", "my-object", "/path/to/local/file")
print("File uploaded successfully:", result)

TypeScript

async upload(bucket: string, object: string, path: string): Promise<string>

パラメーター:

• bucket: OSS バケットの名前。

• object: OSS のオブジェクトキー。

• path: ローカルファイルまたはフォルダのパス。

戻り値:

• Promise<string>: アップロード操作の結果。

例外:

• APIError: アップロードが失敗した場合にスローされます。

例:

import { AgentBay } from 'wuying-agentbay-sdk';

// SDK を初期化します。
const agentBay = new AgentBay({ apiKey: 'your_api_key' });

async function uploadFile() {
  try {
    // ステップ 1: OSS 環境を初期化します。
    await agentBay.oss.envInit(
      'your_access_key_id',
      'your_access_key_secret',
      'your_security_token',
      'oss-cn-hangzhou.aliyuncs.com',
      'cn-hangzhou'
    );
    // ステップ 2: ファイルを OSS にアップロードします。
    const result = await agentBay.oss.upload('my-bucket', 'my-object', '/path/to/local/file');
    console.log('File uploaded successfully:', result);
  } catch (error) {
    console.error('Error uploading file:', error);
  }
}

uploadFile();

Golang

// ローカルファイルまたはフォルダを指定された URL に匿名でアップロードします。
func (o *Oss) UploadAnonymous(url, path string) (*UploadResult, error)

パラメーター:

• url: HTTP または HTTPS の URL。

• path: ローカルファイルまたはフォルダのパス。

戻り値:

• *UploadResult: アップロード URL とリクエスト ID を含むオブジェクト。

• error: 操作が失敗した場合のエラーメッセージ。

例:

package main

import (
	"fmt"
	"os"

	"github.com/aliyun/wuying-agentbay-sdk/golang/pkg/agentbay"
)

func main() {
	// SDK を初期化します。
	client, err := agentbay.NewAgentBay("your_api_key", nil)
	if err != nil {
		fmt.Printf("Error initializing AgentBay client: %v\n", err)
		os.Exit(1)
	}

	// ステップ 1: OSS 環境を初期化します。
	_, err = client.Oss.EnvInit(
		"your_access_key_id",
		"your_access_key_secret",
		"your_security_token",
		"oss-cn-hangzhou.aliyuncs.com",
		"cn-hangzhou",
	)
	if err != nil {
		fmt.Printf("Error initializing OSS environment: %v\n", err)
		os.Exit(1)
	}

	// ステップ 2: ファイルを匿名でアップロードします。
	result, err := client.Oss.UploadAnonymous("https://example.com/upload", "/path/to/local/file")
	if err != nil {
		fmt.Printf("Error uploading file anonymously: %v\n", err)
		os.Exit(1)
	}

	fmt.Printf("File uploaded anonymously successfully, URL: %s, request ID: %s\n", result.URL, result.RequestID)
}

Python

def upload_anonymous(self, url: str, path: str) -> OSSUploadResult

パラメーター:

• url: HTTP または HTTPS の URL。

• path: ローカルファイルまたはフォルダのパス。

戻り値:

• OSSUploadResult: アップロード結果、リクエスト ID、成功ステータス、およびエラーメッセージを含む結果オブジェクト。

例:

from agentbay import AgentBay

# SDK を初期化します。
agent_bay = AgentBay(api_key="your_api_key")

# ファイルを匿名でアップロードします。
result = agent_bay.oss.upload_anonymous("https://example.com/upload", "/path/to/local/file")

if result.success:
    print(f"File uploaded anonymously successfully, content: {result.content}")
    print(f"Request ID: {result.request_id}")
else:
    print(f"Failed to upload file anonymously: {result.error_message}")

TypeScript

async uploadAnonymous(url: string, path: string): Promise<string>

パラメーター:

• url: HTTP または HTTPS の URL。

• path: ローカルファイルまたはフォルダのパス。

戻り値:

• Promise<string>: アップロード操作の結果。

例外:

• APIError: アップロードが失敗した場合にスローされます。

例:

import { AgentBay } from 'wuying-agentbay-sdk';

// SDK を初期化します。
const agentBay = new AgentBay({ apiKey: 'your_api_key' });

async function uploadFileAnonymously() {
  try {
    // ステップ 1: OSS 環境を初期化します。
    await agentBay.oss.envInit(
      'your_access_key_id',
      'your_access_key_secret',
      'your_security_token',
      'oss-cn-hangzhou.aliyuncs.com',
      'cn-hangzhou'
    );
    // ステップ 2: ファイルを匿名でアップロードします。
    const result = await agentBay.oss.uploadAnonymous('https://example.com/upload', '/path/to/local/file');
    console.log('File uploaded anonymously successfully:', result);
  } catch (error) {
    console.error('Error uploading file anonymously:', error);
  }
}

uploadFileAnonymously();

Golang

// OSS からオブジェクトをローカルファイルにダウンロードします。
func (o *Oss) Download(bucket, object, path string) (*DownloadResult, error)

パラメーター:

• bucket: OSS バケットの名前。

• object: OSS のオブジェクトキー。

• path: ファイルが保存されるローカルパス。

戻り値:

• *DownloadResult: ローカルファイルパスとリクエスト ID を含むオブジェクト。

• error: 操作が失敗した場合のエラーメッセージ。

DownloadResult 構造体:

type DownloadResult struct {
    RequestID string // デバッグ用の一意のリクエスト識別子。
    LocalPath string // ファイルがダウンロードされるローカルパス。
}

例:

package main

import (
	"fmt"
	"os"

	"github.com/aliyun/wuying-agentbay-sdk/golang/pkg/agentbay"
)

func main() {
	// SDK を初期化します。
	client, err := agentbay.NewAgentBay("your_api_key", nil)
	if err != nil {
		fmt.Printf("Error initializing AgentBay client: %v\n", err)
		os.Exit(1)
	}

	// ステップ 1: OSS 環境を初期化します。
	_, err = client.Oss.EnvInit(
		"your_access_key_id",
		"your_access_key_secret",
		"your_security_token",
		"oss-cn-hangzhou.aliyuncs.com",
		"cn-hangzhou",
	)
	if err != nil {
		fmt.Printf("Error initializing OSS environment: %v\n", err)
		os.Exit(1)
	}

	// ステップ 2: OSS からファイルをダウンロードします。
	result, err := client.Oss.Download("my-bucket", "my-object", "/path/to/local/file")
	if err != nil {
		fmt.Printf("Error downloading file: %v\n", err)
		os.Exit(1)
	}

	fmt.Printf("File downloaded successfully to: %s, request ID: %s\n", result.LocalPath, result.RequestID)
}

Python

def download(self, bucket: str, object: str, path: str) -> OSSDownloadResult

パラメーター:

• bucket: OSS バケットの名前。

• object: OSS のオブジェクトキー。

• path: ファイルが保存されるローカルパス。

戻り値:

• OSSDownloadResult: ダウンロード結果、リクエスト ID、成功ステータス、およびエラーメッセージを含む結果オブジェクト。

OSSDownloadResult 構造体:

class OSSDownloadResult(ApiResponse):
    def __init__(self, request_id: str = "", success: bool = False,
                 content: str = "", error_message: str = "")

例:

from wuying_agentbay_sdk import AgentBay

# SDK を初期化します。
agent_bay = AgentBay(api_key="your_api_key")

# ステップ 1: OSS 環境を初期化します。
agent_bay.oss.env_init(
    access_key_id="your_access_key_id",
    access_key_secret="your_access_key_secret",
    security_token="your_security_token",
    endpoint="oss-cn-hangzhou.aliyuncs.com",
    region="cn-hangzhou"
)

# ステップ 2: ファイルをダウンロードします。
result = agent_bay.oss.download("my-bucket", "my-object", "/path/to/local/file")
print("File downloaded successfully:", result)

TypeScript

async download(bucket: string, object: string, path: string): Promise<string>

パラメーター:

• bucket: OSS バケットの名前。

• object: OSS のオブジェクトキー。

• path: ファイルが保存されるローカルパス。

戻り値:

• Promise<string>: ダウンロード操作の結果。

例外:

• APIError: ダウンロードが失敗した場合にスローされます。

例:

import { AgentBay } from 'wuying-agentbay-sdk';

// SDK を初期化します。
const agentBay = new AgentBay({ apiKey: 'your_api_key' });

async function downloadFile() {
  try {
    // ステップ 1: OSS 環境を初期化します。
    await agentBay.oss.envInit(
      'your_access_key_id',
      'your_access_key_secret',
      'your_security_token',
      'oss-cn-hangzhou.aliyuncs.com',
      'cn-hangzhou'
    );
    // ステップ 2: OSS からファイルをダウンロードします。
    const result = await agentBay.oss.download('my-bucket', 'my-object', '/path/to/local/file');
    console.log('File downloaded successfully:', result);
  } catch (error) {
    console.error('Error downloading file:', error);
  }
}

downloadFile();

Golang

// 指定された URL からファイルをローカルパスに匿名でダウンロードします。
func (o *Oss) DownloadAnonymous(url, path string) (*DownloadResult, error)

パラメーター:

• url: HTTP または HTTPS の URL。

• path: ファイルが保存される完全なローカルパス。

戻り値:

• *DownloadResult: ローカルファイルパスとリクエスト ID を含むオブジェクト。

• error: 操作が失敗した場合のエラーメッセージ。

例:

package main

import (
	"fmt"
	"os"

	"github.com/aliyun/wuying-agentbay-sdk/golang/pkg/agentbay"
)

func main() {
	// SDK を初期化します。
	client, err := agentbay.NewAgentBay("your_api_key", nil)
	if err != nil {
		fmt.Printf("Error initializing AgentBay client: %v\n", err)
		os.Exit(1)
	}

	// ステップ 1: OSS 環境を初期化します。
	_, err = client.Oss.EnvInit(
		"your_access_key_id",
		"your_access_key_secret",
		"your_security_token",
		"oss-cn-hangzhou.aliyuncs.com",
		"cn-hangzhou",
	)
	if err != nil {
		fmt.Printf("Error initializing OSS environment: %v\n", err)
		os.Exit(1)
	}

	// ステップ 2: ファイルを匿名でダウンロードします。
	result, err := client.Oss.DownloadAnonymous("https://example.com/file.txt", "/path/to/local/file.txt")
	if err != nil {
		fmt.Printf("Error downloading file anonymously: %v\n", err)
		os.Exit(1)
	}

	fmt.Printf("File downloaded anonymously successfully to: %s, request ID: %s\n", result.LocalPath, result.RequestID)
}

Python

def download_anonymous(self, url: str, path: str) -> OSSDownloadResult

パラメーター:

• url: HTTP または HTTPS の URL。

• path: ファイルまたはフォルダが保存されるローカルパス。

戻り値:

• OSSDownloadResult: ダウンロードされたコンテンツ、リクエスト ID、成功ステータス、およびエラーメッセージを含む結果オブジェクト。

例:

from agentbay import AgentBay

# SDK を初期化します。
agent_bay = AgentBay(api_key="your_api_key")

# ファイルを匿名でダウンロードします。
result = agent_bay.oss.download_anonymous("https://example.com/file.txt", "/path/to/local/file.txt")

if result.success:
    print(f"File downloaded anonymously successfully, content: {result.content}")
    print(f"Request ID: {result.request_id}")
else:
    print(f"Failed to download file anonymously: {result.error_message}")

TypeScript

async downloadAnonymous(url: string, path: string): Promise<string>

パラメーター:

• url: HTTP または HTTPS の URL。

• path: ファイルが保存される完全なローカルパス。

戻り値:

• Promise<string>: ダウンロード操作の結果。

例外:

• APIError: ダウンロードが失敗した場合にスローされます。

例:

import { AgentBay } from 'wuying-agentbay-sdk';

// SDK を初期化します。
const agentBay = new AgentBay({ apiKey: 'your_api_key' });

async function downloadFileAnonymously() {
  try {
    // ステップ 1: OSS 環境を初期化します。
    await agentBay.oss.envInit(
      'your_access_key_id',
      'your_access_key_secret',
      'your_security_token',
      'oss-cn-hangzhou.aliyuncs.com',
      'cn-hangzhou'
    );
    // ステップ 2: ファイルを匿名でダウンロードします。
    const result = await agentBay.oss.downloadAnonymous('https://example.com/file.txt', '/path/to/local/file.txt');
    console.log('File downloaded anonymously successfully:', result);
  } catch (error) {
    console.error('Error downloading file anonymously:', error);
  }
}

downloadFileAnonymously();