このトピックでは、バケットのインベントリを作成する方法と、バケットに設定されたインベントリを照会、一覧表示、および削除する方法について説明します。
使用上の注意
このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。 OSSと同じリージョンにある他のAlibaba Cloudサービスを使用してOSSにアクセスする場合は、内部エンドポイントを使用します。 OSSでサポートされているリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
このトピックでは、アクセス資格情報は環境変数から取得します。 アクセス資格情報の設定方法の詳細については、「アクセス資格情報の設定」をご参照ください。
このトピックでは、OSSエンドポイントを使用してOSSClientインスタンスを作成します。 カスタムドメイン名またはSTS (Security Token Service) を使用してOSSClientインスタンスを作成する場合は、「初期化」をご参照ください。
バケットのインベントリを作成、表示、一覧表示、および削除する権限があることを確認します。 デフォルトでは、バケット所有者に上記の操作を実行する権限があります。 上記の操作を実行する権限がない場合は、バケットの所有者に権限を付与するよう依頼してください。
バケットには最大1,000のインベントリを設定できます。
インベントリを構成するソースバケットは、インベントリリストが保存されているターゲットバケットと同じリージョンにデプロイする必要があります。
バケットのインベントリを作成する
次のコードは、バケットのインベントリを作成する方法の例を示しています。
パッケージメイン
import (import (import)
"fmt"
「github.com/aliyun/aliyun-oss-go-sdk/oss」
"os"
)
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)
}
IsEnabled := true
// 次のコードは、Key Management Service (KMS) が管理する顧客マスターキー (CMK) を使用してインベントリリストを暗号化する方法の例を示しています。
// var invEncryption oss.InvEncryption
// var invSseOss oss.InvSseOss
// var invSseKms oss.InvSseKms
// invSseKms.KmsId = "<yourKmsId>" // KMSが管理するCMKのIDを指定します。
// invEncryption.SseOss = &invSseOss // OSS管理キー (SSE-OSS) を使用して、インベントリリストを暗号化します。
// invEncryption.SseKms = &invSseKms // KMS (SSE-KMS) が管理するCMKを使用して、インベントリリストを暗号化します。
invConfig := oss.InventoryConfiguration {
// インベントリの名前を指定します。 名前は、現在のバケット内でグローバルに一意である必要があります。
Id: "yourInventoryId2" 、// インベントリを有効にします。
IsEnabled: &IsEnabled、// インベントリに含まれるオブジェクトのフィルタリングに使用されるルールを指定します。 次のコードは、プレフィックスでオブジェクトをフィルタリングする方法の例を示しています。
プレフィックス: "yourFilterPrefix" 、OSSBucketDestination: oss.OSSBucketDestination {
// エクスポートされたインベントリリストの形式を指定します。
フォーマット: "CSV" 、// 操作を実行するためにバケット所有者によって権限が付与されたアカウントのIDを指定します。 例: 109885487000 **** 。
AccountId: "yourGrantAccountId" 、// バケット所有者が操作を実行する権限を付与したRAMロールの名前を指定します。 例: acs:ram::109885487000 ****:role/ram-test。
RoleArn: "yourRoleArn" 、// 生成されたインベントリリストを保存するバケットの名前を指定します。
バケット: "acs:oss :::" + "yourDestBucketName" 、// 生成されたインベントリリストを格納するパスのプレフィックスを指定します。
プレフィックス: "yourDestPrefix" 、// 次のサンプルコードは、インベントリリストを暗号化する方法の例を示しています。
// 暗号化: &invEncryption、},
// インベントリリストがエクスポートされる頻度を指定します。
頻度: 「デイリー」、// インベントリリストにすべてのバージョンのオブジェクトを含めるか、現在のバージョンのオブジェクトのみを含めるかを指定します。
含まれるObjectVersions: "すべて" 、OptionalFields: oss.OptionalFields {
// インベントリリストに含まれるフィールドを指定します。
フィールド: []string {
"Size" 、"LastModifiedDate" 、"ETag" 、"StorageClass" 、"IsMultipartaded" 、"EncryptionStatus" 、},
},
}
// インベントリを設定するバケットの名前を指定します。
err = client.SetBucketInventory("yourBucketName", invConfig)
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
}
バケットのインベントリの照会
次のコードは、バケットに設定されたインベントリを照会する方法の例を示しています。
パッケージメイン
import (import (import)
"encoding/xml"
"fmt"
「github.com/aliyun/aliyun-oss-go-sdk/oss」
"os"
)
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)
}
// バケットの名前を指定する
// インベントリの名前を指定します。
result, err := client.GetBucketInventory("yourBucketName", "yourInventoryId")
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// インベントリを表示します。
bs, err := xml.MarshalIndent(result, "", "")
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
fmt.Println(string(bs))
}
一度に複数の在庫をリストする
1回のリクエストで最大100のインベントリを照会できます。 100を超えるインベントリをクエリするには、複数のリクエストを送信し、各リクエストに対して返されたトークンを次のリクエストのパラメーターとして使用する必要があります。
次のコードは、バケットに設定されたインベントリを一覧表示する方法の例です。
パッケージメイン
import (import (import)
"encoding/xml"
"fmt"
「github.com/aliyun/aliyun-oss-go-sdk/oss」
"os"
)
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)
}
var sumResult oss.ListInventoryConfigurationsResult
vmarker := ""
for {
// バケットの名前を指定する
listResult, err := client.ListBucketInventory("yourBucketName" 、vmarker)
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
sumResult.InventoryConfiguration = append(sumResult.InventoryConfiguration, listResult.InventoryConfiguration...)
if listResult.IsTruncated! =nil && * listResult。IsTruncated {
vmarker = listResult.NextContinuationToken
} else {
休憩
}
}
// バケットのインベントリを表示します。
bs, err := xml.MarshalIndent(sumResult, "", "")
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
fmt.Println(string(bs))
}
バケットのインベントリを削除する
次のコードは、バケットに設定されたインベントリを削除する方法の例を示しています。
パッケージメイン
import (import (import)
"fmt"
「github.com/aliyun/aliyun-oss-go-sdk/oss」
"os"
)
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)
}
// インベントリを削除します。
// バケットの名前を指定する
// インベントリの名前を指定します。
err = client.DeleteBucketInventory("yourBucketName", "yourInventoryId")
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
}
参考資料
バケットインベントリを管理するための完全なサンプルコードについては、『GitHub』をご参照ください。
バケットのインベントリを作成するためのAPI操作の詳細については、「PutBucketInventory」をご参照ください。
バケットに設定されたインベントリを照会するためのAPI操作の詳細については、「GetBucketInventory」をご参照ください。
バケットに設定されたインベントリを一覧表示するAPI操作の詳細については、「ListBucketInventory」をご参照ください。
バケットに設定されたインベントリを削除するAPI操作の詳細については、「DeleteBucketInventory」をご参照ください。