Object Storage Service:Unduhan rentang (Go SDK V1)

Misalnya, Anda memiliki objek berukuran 1.000 byte. Rentang unduhan yang valid adalah dari byte 0 hingga byte 999. Jika Anda menentukan rentang di luar interval tersebut, parameter Range tidak berpengaruh. Tanggapan akan mengembalikan kode status 200 dan menyertakan seluruh objek. Contoh berikut menunjukkan permintaan tidak valid beserta tanggapannya:

• Jika Anda menentukan Range: bytes=500~2000, akhir rentang berada di luar interval yang valid. Seluruh file dikembalikan dengan kode status HTTP 200.

• Jika Anda menentukan Range: bytes=1000~2000, awal rentang berada di luar interval yang valid. Seluruh file dikembalikan dengan kode status HTTP 200.

Unduhan rentang dengan perilaku standar menambahkan header permintaan x-oss-range-behavior:standard untuk mengubah perilaku unduhan OSS ketika rentang yang ditentukan tidak valid. Misalnya, Anda memiliki objek berukuran 1.000 byte:

• Jika Anda menentukan Range: bytes=500~2000, akhir rentang berada di luar interval yang valid. Konten dari byte 500 hingga byte 999 dikembalikan dengan kode status HTTP 206.

• Jika Anda menentukan Range: bytes=1000~2000, awal rentang berada di luar interval yang valid. Kode status HTTP 416 dikembalikan bersama kode kesalahan InvalidRange.

Kode berikut menunjukkan cara melakukan unduhan rentang dengan perilaku standar.

package main

import (
	"io"
	"log"
	"strings"

	"github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func main() {
	// Peroleh kredensial akses dari variabel lingkungan. Sebelum menjalankan kode contoh ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah disetel.
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		log.Fatalf("Error: %v", err)
	}

	// Buat instans OSSClient.
	// Setel yourEndpoint ke Endpoint bucket. Misalnya, untuk bucket di wilayah China (Hangzhou), setel Endpoint ke https://oss-cn-hangzhou.aliyuncs.com. Untuk wilayah lain, gunakan Endpoint yang sesuai.
	// Setel yourRegion ke wilayah tempat bucket berada. Misalnya, untuk bucket di wilayah China (Hangzhou), setel wilayah ke cn-hangzhou. Untuk wilayah lain, gunakan wilayah yang sesuai.
	clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
	clientOptions = append(clientOptions, oss.Region("yourRegion"))
	// Setel versi signature.
	clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
	client, err := oss.New("yourEndpoint", "", "", clientOptions...)
	if err != nil {
		log.Fatalf("Error: %v", err)
	}

	// Tentukan nama bucket.
	bucketName := "yourBucketName"
	bucket, err := client.Bucket(bucketName)
	if err != nil {
		log.Fatalf("Error: %v", err)
	}

	// Unggah konten sebesar 1.000 byte.
	strContent := ""
	for i := 0; i < 100; i++ {
		strContent += "abcdefghij"
	}
	log.Printf("content len: %d\n", len(strContent))

	// Unggah string tersebut.
	objectName := "yourObjectName"
	err = bucket.PutObject(objectName, strings.NewReader(strContent))
	if err != nil {
		log.Fatalf("Error: %v", err)
	}

	// Jika Anda menentukan Range: bytes=500~2000, akhir rentang berada di luar interval yang valid. Konten dari byte 500 hingga byte 999 dikembalikan, dan kode status HTTP-nya adalah 206.
	// Jika Anda menentukan Range: bytes=1000~2000, awal rentang berada di luar interval yang valid. Kode status HTTP 416 dikembalikan bersama kode kesalahan InvalidRange.
	rangeStart := int64(1000)
	rangeEnd := int64(2000)
	body, err := bucket.GetObject(objectName, oss.Range(rangeStart, rangeEnd), oss.RangeBehavior("standard"))
	if err != nil {
		log.Fatalf("Error: %v", err)
	}
	defer body.Close()

	// Baca data ke dalam memori.
	data, err := io.ReadAll(body)
	if err != nil {
		log.Fatalf("Error: %v", err)
	}

	if len(data) != 500 {
		log.Fatalf("read data error, len: %d", len(data))
	}
	log.Printf("data: %s", string(data))
}