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

:オブジェクトをファイルとしてダウンロード

最終更新日:Dec 19, 2023

このトピックでは、バケットからコンピュータにオブジェクトをダウンロードする方法について説明します。

使用上の注意

  • このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。 OSSと同じリージョンにある他のAlibaba Cloudサービスを使用してOSSにアクセスする場合は、内部エンドポイントを使用します。 OSSでサポートされているリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。

  • このトピックでは、アクセス資格情報は環境変数から取得します。 アクセス資格情報の設定方法の詳細については、「アクセス資格情報の設定」をご参照ください。

  • このトピックでは、OSSエンドポイントを使用してOSSClientインスタンスを作成します。 カスタムドメイン名またはSTS (Security Token Service) を使用してOSSClientインスタンスを作成する場合は、「初期化」をご参照ください。

  • オブジェクトをローカルファイルとしてダウンロードするには、oss:GetObject権限が必要です。 詳細については、「RAMポリシーの一般的な例」をご参照ください。

サンプルコード

次のコードは、examplebucketのexampledirディレクトリからD:\localpathパスにexampleobject.txtをダウンロードする方法の例を示しています。 オブジェクトがダウンロードされると、ローカルファイルの名前はexamplefile.txtになります。

パッケージメイン

import (import (import)
"fmt"
"os"

「github.com/aliyun/aliyun-oss-go-sdk/oss」
)

func main() {
// 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// OSSClientインスタンスを作成します。 
	// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 実際のエンドポイントを指定します。 
	client, err := oss.New("yourEndpoint", ", " ", ", oss.SetCredentialsProvider(&provider))
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}

// バケットの名前を指定します。 例: examplebucket. 
	bucket, err := client.Bucket("examplebucket")
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}

// 指定されたローカルパスにオブジェクトをダウンロードします。 同じ名前のファイルが既に存在する場合、ダウンロードされたオブジェクトはファイルを上書きします。 それ以外の場合、ダウンロードされたオブジェクトはパスに保存されます。 
	// ダウンロードしたオブジェクトのパスを指定しない場合、ダウンロードしたオブジェクトはサンプルプログラムが属するプロジェクトのパスに保存されます。 
	// バケットからダウンロードするオブジェクトのフルパスを指定します。 例: exampledir/exampleobject.txt。 次に、オブジェクトをダウンロードする完全なローカルパスを指定します。 例: D :\\ localpath\\examplefile.txt。 バケット名をフルパスに含めないでください。 
	err = bucket.GetObjectToFile("exampledir/exampleobject.txt", "D :\\ localpath\\examplefile.txt")
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
}

参考資料

  • オブジェクトをローカルファイルとしてダウンロードするために使用される完全なサンプルコードについては、GitHubをご参照ください。

  • オブジェクトをローカルファイルとしてダウンロードするために呼び出すAPI操作の詳細については、「GetObject」をご参照ください。