:Penanganan error (Go SDK V1)

Kesalahan di sisi klien

Jika panggilan yang dilakukan oleh Go SDK gagal, SDK tersebut mengembalikan antarmuka error yang didefinisikan sebagai berikut:

type error interface {
    Error() string
}

Error lainnya mewarisi antarmuka ini. Sebagai contoh, error yang dikembalikan ketika permintaan HTTP gagal didefinisikan sebagai berikut:

//net.Error 
type Error interface {
    error
    Timeout() bool   // Apakah kesalahan merupakan timeout
    Temporary() bool // Apakah kesalahan bersifat sementara
}

Kesalahan di sisi server

Jika permintaan yang dilakukan oleh OSS Go SDK gagal, sebuah error dikembalikan. Untuk masalah seperti error permintaan HTTP atau I/O, error kustom Go dikembalikan. Jika terjadi error pada server OSS, error berikut dikembalikan dan mengimplementasikan antarmuka Error:

type ServiceError struct {
    Code       string    // Kode error yang dikembalikan oleh OSS.
    Message    string    // Pesan error detail dari OSS.
    RequestId  string    // Pengidentifikasi unik universal (UUID) yang secara unik mengidentifikasi permintaan.
    HostId     string    // ID kluster OSS yang diakses.
    StatusCode int       // Kode status HTTP.
}

Jika kode status HTTP yang dikembalikan oleh OSS tidak sesuai dengan yang diharapkan, kesalahan berikut dikembalikan. Kesalahan ini juga mengimplementasikan antarmuka Error.

type UnexpectedStatusCodeError struct {
    allowed []int    // Kode status HTTP yang diharapkan dari OSS.
    got     int      // Kode status HTTP aktual yang dikembalikan oleh OSS.
}

Contoh penanganan kesalahan

Berikut adalah kode yang menunjukkan cara menangani kesalahan:

package main

import (
	"fmt"
	"os"
	"strings"

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

// Fungsi penanganan error.
func HandleError(err error) {
	fmt.Println("Error:", err)
	os.Exit(-1)
}
func main() {
	/// Dapatkan 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 {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}

	// Buat instans OSSClient.
	// Setel yourEndpoint ke titik akhir bucket. Misalnya, untuk wilayah China (Hangzhou), gunakan https://oss-cn-hangzhou.aliyuncs.com. Untuk wilayah lain, gunakan titik akhir yang sebenarnya.
	// Setel yourRegion ke wilayah tempat bucket berada. Misalnya, untuk wilayah China (Hangzhou), gunakan cn-hangzhou. Untuk wilayah lain, gunakan ID wilayah yang sebenarnya.
	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 {
		HandleError(err)
	}
	// Tentukan nama bucket, misalnya examplebucket.
	bucketName := "examplebucket"
	// Tentukan nama objek, misalnya exampleobject.txt.
	objectName := "exampleobject.txt"

	bucket, err := client.Bucket(bucketName)
	if err != nil {
		HandleError(err)
	}
	// Unggah string.
	err = bucket.PutObject(objectName, strings.NewReader("Hello OSS"))
	if err != nil {
		HandleError(err)
	}
}

Kode kesalahan OSS

Tabel berikut mencantumkan kode kesalahan OSS.