バケットのバージョン管理設定は、バケット内のすべてのオブジェクトに適用されます。 バケットのバージョン管理を有効にすると、誤ってオブジェクトを上書きまたは削除したときに、バケット内のオブジェクトの以前のバージョンを復元できます。
使用上の注意
このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。 OSSと同じリージョンにある他のAlibaba Cloudサービスを使用してOSSにアクセスする場合は、内部エンドポイントを使用します。 OSSでサポートされているリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
このトピックでは、アクセス資格情報は環境変数から取得します。 アクセス資格情報の設定方法の詳細については、「アクセス資格情報の設定」をご参照ください。
このトピックでは、OSSエンドポイントを使用してOSSClientインスタンスを作成します。 カスタムドメイン名またはSTS (Security Token Service) を使用してOSSClientインスタンスを作成する場合は、「初期化」をご参照ください。
バケットのバージョン管理を構成するには、
oss:PutBucketVersioning
権限が必要です。 バケットのバージョン管理状態を照会するには、oss:GetBucketVersioning
権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。
バケットのバージョン管理の構成
次のコードは、バケットを作成するときにバージョン管理を有効にする方法の例を示しています。
パッケージメイン
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)
}
// Create an OSSClient instance.
// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 実際のエンドポイントを指定します。
client, err := oss.New("yourEndpoint", ", " ", ", oss.SetCredentialsProvider(&provider))
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// バケットを作成します。
// バケットの名前を指定します。
err = client.CreateBucket("yourBucketName")
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// バケットのバージョン管理ステータスを [有効] に設定します。
config := oss.VersioningConfig{Status: "Enabled"}
err = client.SetBucketVersioning("yourBucketName", config)
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
}
バケットのバージョン管理ステータスの照会
次のコードは、バケットのバージョン管理ステータスを照会する方法の例を示しています。
パッケージメイン
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)
}
// Create an OSSClient instance.
// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 実際のエンドポイントを指定します。
client, err := oss.New("yourEndpoint", ", " ", ", oss.SetCredentialsProvider(&provider))
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// バケットのバージョン管理ステータスを照会します。
// バケットの名前を指定します。
ret, err := client.GetBucketVersioning("yourBucketName")
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// バケットのバージョン管理ステータスを表示します。
fmt.Println("The bucket Versioning status:", ret.Status)
}
バケット内の全オブジェクトのバージョン一覧表示
次のコードでは、指定したバケット内の削除マーカーを含むすべてのオブジェクトのバージョンを一覧表示する方法の例を示します。
パッケージメイン
import (import (import)
"fmt"
"net/http"
"os"
"strings"
「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)
}
// Create an OSSClient instance.
// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 実際のエンドポイントを指定します。
client, err := oss.New("yourEndpoint", ", " ", ", oss.SetCredentialsProvider(&provider))
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// バケットの名前を指定します。
bucket, err := client.Bucket("yourBucketName")
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 指定されたプレフィックスを名前に含むオブジェクトを一覧表示します。
ret, err := bucket.ListObjectVersions(oss.Prefix("yourObjectPrefix"))
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// オブジェクトに関する情報を表示します。
for _, object := range ret.ObjectVersions {
fmt.Println("Object:", object)
}
// 削除マーカーに関する情報を表示します。
for _, marker := range ret.ObjectDeleteMarkers {
fmt.Println("Delete Markers:", marker)
}
}
参考資料
バケットのバージョン管理を構成するために呼び出すことができるAPI操作の詳細については、「PutBucketVersioning」をご参照ください。
バケットのバージョン管理ステータスを照会するために呼び出すことができるAPI操作の詳細については、「GetBucketVersioning」をご参照ください。
バケット内のすべてのオブジェクトのバージョンを一覧表示するために呼び出すAPI操作の詳細については、「ListObjectVersions (GetBucketVersions) 」をご参照ください。