Object Storage Service:範囲のダウンロード (Go SDK V2)

使用上の注意

• このトピックのサンプルコードでは、中国 (杭州) リージョン ID の cn-hangzhou を使用します。デフォルトでは、パブリックエンドポイントが使用されます。同じリージョン内の他の Alibaba Cloud プロダクトから OSS にアクセスする場合は、内部エンドポイントを使用します。OSS がサポートするリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。

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

権限

デフォルトでは、Alibaba Cloud アカウントは完全な権限を持っています。Alibaba Cloud アカウント下の RAM ユーザーまたは RAM ロールは、デフォルトでは何の権限も持っていません。Alibaba Cloud アカウントまたはアカウント管理者は、RAM ポリシーまたはバケットポリシーを通じて操作権限を付与する必要があります。

メソッドの定義

func (c *Client) GetObject(ctx context.Context, request *GetObjectRequest, optFns ...func(*Options)) (*GetObjectResult, error)

リクエストパラメーター

戻り値

サンプルコード

次のサンプルコードは、RangeBehavior:standard リクエストヘッダーを追加して、標準のダウンロード動作を使用してファイルの指定された範囲からデータをダウンロードする方法を示しています。

package main

import (
	"context"
	"flag"
	"io"
	"log"

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

// グローバル変数を定義します。
var (
	region     string // リージョン。
	bucketName string // バケット名。
	objectName string // オブジェクト名。
)

// init 関数は、コマンドラインパラメーターを初期化するために使用されます。
func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucketName, "bucket", "", "The name of the bucket.")
	flag.StringVar(&objectName, "object", "", "The name of the object.")
}

func main() {
	// コマンドラインパラメーターを解析します。
	flag.Parse()

	// バケット名が空かどうかを確認します。
	if len(bucketName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}

	// リージョンが空かどうかを確認します。
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}

	// オブジェクト名が空かどうかを確認します。
	if len(objectName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, object name required")
	}

	// デフォルトの構成をロードし、資格情報プロバイダーとリージョンを設定します。
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region)

	// OSS クライアントを作成します。
	client := oss.NewClient(cfg)

	// オブジェクトを取得するリクエストを作成します。
	request := &oss.GetObjectRequest{
		Bucket:        oss.Ptr(bucketName),     // バケット名。
		Key:           oss.Ptr(objectName),     // オブジェクト名。
		Range:         oss.Ptr("bytes=15-35"), // ダウンロード範囲を指定します。
		RangeBehavior: oss.Ptr("standard"),     // 標準の範囲ダウンロード動作を指定します。
	}

	// オブジェクトを取得する操作を実行し、結果を処理します。
	result, err := client.GetObject(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to get object %v", err)
	}
	defer result.Body.Close() // 関数が終了するときにレスポンス本文が閉じられるようにします。

	log.Printf("get object result:%#v\n", result)

	// オブジェクトのコンテンツを読み取ります。
	data, _ := io.ReadAll(result.Body)
	log.Printf("body:%s\n", data)
}

関連ドキュメント

• 範囲のダウンロードの完全なサンプルコードについては、「GitHub の例」をご参照ください。

• 範囲のダウンロードの API 操作の詳細については、「GetObject」をご参照ください。