获取Bucket的访问日志配置
更新时间:2021-12-29
接口说明
本接口用来获取某个Bucket的访问日志配置情况。
注意事项
如果请求的源Bucket不存在,返回404错误,错误码为NoSuchBucket。 请求者只有是源Bucket的owner且拥有FULL_CONTROL权限才允许查看,否则返回403错误,错误码为AccessDenied。
请求URI
GET /v1/{bucketName}/?logging
参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 | 参数位置 |
---|---|---|---|---|---|
bucketName | String | 是 | bucket名称 | "bucketName_example" | Path |
请求体参数
请求体字段数据结构说明
响应体参数
响应体字段数据结构说明
参数名称 | 参数类型 | 描述 | 示例值 |
---|---|---|---|
status | String | Bucket的访问日志功能的开启状态,取值为enabled和disabled。enabled代表已开启,disabled代表未开启。 | enabled |
targetBucket | String | 指定存放访问日志的Bucket,如果未开启Logging功能,响应中无该字段。 | dscbucket |
targetPrefix | String | 指定最终被保存的访问日志文件前缀,如果未开启Logging功能,响应中无该字段。 | mylog- |
请求示例
GET /v1/bucketName_example/?logging
<公共请求头>
{ }
响应示例
HTTP/1.1 200 OK
<公共响应头>
{
"targetPrefix" : "mylog-",
"targetBucket" : "dscbucket",
"status" : "enabled"
}
错误码
请参考通用错误码