设置桶清单

功能说明

桶清单功能可以定期生成桶内对象的元数据信息，通过查看这些信息，可以帮助您更好地了解桶内对象的状态。桶拥有者或拥有设置桶清单的用户，可以通过本接口为桶配置清单规则，每个桶最多配置10条清单规则。有关更多桶清单的介绍和使用限制，请参见桶清单。

要使用此操作，需确保执行者有PutBucketInventoryConfiguration操作的权限 。桶拥有者默认具有此权限，并且可以将此权限授予其他人。

融合桶场景，主桶支持配置桶清单，备桶不支持配置桶清单。

接口约束

授权信息

您必须是桶拥有者或拥有设置桶清单的权限，才能调用本接口，建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。

• 如果使用IAM授权，那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中选择一种，并配置相应权限：
  • 如果使用角色与策略授权（旧版IAM，即IAM v3接口），需具备obs:bucket:PutBucketInventoryConfiguration权限，授权操作请参见创建IAM自定义策略。
  • 如果使用身份策略授权（新版IAM，即IAM v5接口），如下表所示，需具备obs:bucket:putBucketInventoryConfiguration权限，授权操作请参见创建IAM自定义身份策略。

    授权项 Action	访问级别 Access Level	资源类型（*为必须） Resource Type (*: required)	条件键 Condition Key	别名别名 Alias	依赖的授权项 Dependencies
    obs:bucket:putBucketInventoryConfiguration	Write	bucket *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	-	-
    		-	obs:EpochTime obs:SourceIp obs:TlsVersion obs:CustomDomain

• 如果使用桶策略进行授权，需具备obs:bucket:PutBucketInventoryConfiguration权限，具体操作请参见自定义创建桶策略。

方法定义

func (obsClient ObsClient) SetBucketInventory(input *SetBucketInventoryInput, extensions ...extensionOptions) (output *BaseModel, err error)

请求参数说明

表2 InventoryDestination参数说明

表3 InventorySchedule参数说明

表4 InventoryFilter参数说明

表5 InventoryOptionalFields参数说明

代码示例

本示例用于为桶examplebucket创建桶清单配置，ID为inventory-rule-1。

package main

import (
	"fmt"
	"log"
        obs "github.com/huaweicloud/huaweicloud-sdk-go-obs/obs"
)

func main() {
    //推荐通过环境变量获取AKSK，这里也可以使用其他外部引入方式传入，如果使用硬编码可能会存在泄露风险。
    //您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html。
        ak := os.Getenv("AccessKeyID")
        sk := os.Getenv("SecretAccessKey")
    // 【可选】如果使用临时AK/SK和SecurityToken访问OBS，同样建议您尽量避免使用硬编码，以降低信息泄露风险。您可以通过环境变量获取访问密钥AK/SK，也可以使用其他外部引入方式传入。
    securityToken := os.Getenv("SecurityToken")
    // endpoint填写Bucket对应的Endpoint，这里以华北-北京四为例，其他地区请按实际情况填写。     endPoint := "https://obs.cn-north-4.myhuaweicloud.com"
	// 创建客户端
    obsClient, err := obs.New(ak, sk, endPoint, obs.WithSecurityToken(securityToken))
    if err != nil {
        fmt.Printf("Create obsClient error, errMsg: %s", err.Error())
    }

	// 设置清单配置
	input := &obs.SetBucketInventoryInput{
		Bucket: "my-bucket",
		InventoryConfiguration: obs.InventoryConfiguration{
			Id:        "inventory-rule-1",
			IsEnabled: true,
			Destination: obs.InventoryDestination{
				Format: "CSV",
				Bucket: "report-bucket",
				Prefix: "inventory-reports/",
			},
			Schedule: obs.InventorySchedule{
				Frequency: "Daily", // 每日生成
			},
			IncludedObjectVersions: "All", // 包含所有版本
			OptionalFields: &obs.InventoryOptionalFields{
				Fields: []string{
					"Size",
					"LastModifiedDate",
					"StorageClass",
					"ETag",
					"IsMultipartUploaded",
				},
			},
		},
	}

	output, err := client.SetBucketInventory(input)
	if err != nil {
		log.Fatalf("Failed to set bucket inventory: %v", err)
	}

	fmt.Printf("Request ID: %s\n", output.RequestId)
	fmt.Println("Inventory configuration set successfully")
}

相关链接

• 更多关于桶清单的示例代码，请参见Github示例。
• 桶清单接口返回的错误码含义、问题原因及处理措施可参考OBS错误码。