对象存储经典版I型 > 天翼云对象存储（经典版）I型API参考-PUT Bucket Logging

天翼云对象存储（经典版）I型API参考-PUT Bucket Logging

产品推荐：

1、安全稳定的云服务器租用，2核/2G/5M仅37元，点击抢购>>>；

2、高防物理服务器20核/16G/50M/500G防御仅350元，点击抢购>>>

3、百度智能建站（五合一网站）仅880元/年，点击抢购>>> 模板建站（PC+手机站）仅480元/年，点击抢购>>>

4、阿里云服务器2核2G3M仅99元/年、2核4G5M仅199元/年，新老同享，点击抢购>>>

5、腾讯云服务器2核2G4M仅99元/年、新老同享，点击抢购>>>

点击这里注册天翼云特邀VIP帐号，立即体验天翼云对象存储>>>

天翼云对象存储（经典版）I型API参考-PUT Bucket Logging

此操作用来添加/修改/删除logging的操作。如果Bucket已经存在了logging，此操作会替换原有logging。只有根用户和拥有PUT Bucket Logging权限的子用户才能执行此操作，否则会返回403 AccessDenied错误。

请求语法

PUT /?logging HTTP/1.1

Host: BucketName.oos-cn.ctyunapi.cn

Date: date

Authorization: signatureValue

Request elements vary depending on what you're setting.

请求参数

名称	描述	是否必须
BucketLoggingStatus	请求的容器。类型：容器子节点：LoggingEnabled	是
LoggingEnabled	日志信息的容器，当启动日志时，需要包含这个元素。类型：容器。父节点：BucketLoggingStatus 子节点：TargetBucket、TargetPrefix	否
TargetBucket	指定要保存log的Bucket，OOS会向此Bucket存储日志。可以设置任意一个你拥有的bucket作为TargetBucket，包括启动日志的bucket本身。你也可以设置将多个Bucket的日志存放到一个TargetBucket中，在这种情况下，你需要为每个源bucket设置不同的TargetPrefix，以便不同Bucket的log可以被区分出来。类型：字符串父节点：LoggingEnabled	否
TargetPrefix	生成的log文件将以此为前缀命名。类型：字符串父节点：LoggingEnabled	否

请求示例1

启动日志

PUT /?logging HTTP/1.1
Host: doc.oos-cn.ctyunapi.cn
Content-Type: application/xml; charset=utf-8
Date: Mon, 03Sep 2012 12:00:00 GMT
Authorization: AWS 7799e793ce4624ee7e5a:xQE0diMbLRepdf3YB+FIEXAMPLE=
 
<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns="http://doc.s3.amazonaws.com/2006-03-01">
  <LoggingEnabled>
    <TargetBucket>mybucketlogs</TargetBucket>
    <TargetPrefix>mybucket-access_log-/</TargetPrefix>
  </LoggingEnabled>
</BucketLoggingStatus>

响应示例1

HTTP/1.1 200OK
x-amz-request-id: 32FE2CEB32F5EE25
Date: Mon, 03Sep 2012 12:00:00 GMT
Server: CTYUN

请求示例2

以下是取消日志的示例：

PUT /?logging HTTP/1.1
Host: doc.oos-cn.ctyunapi.cn
Date: Mon, 03Sep 2012 12:00:00 GMT
Authorization: AWS 7799e793ce4624ee7e5a:xQE0diMbLRepdf3YB+FIEXAMPLE=
 
<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns=http://doc.s3.amazonaws.com/2006-03-01/> </BucketLoggingStatus>

响应示例2

HTTP/1.1 200OK
x-amz-request-id: 32FE2CEB32F5EE25
Date: Mon, 03Sep 2012 12:00:00 GMT
Server: CTYUN

日志名称

TargetPrefix<RegionName>/UTCYYYY-MM-DD-hh-mm-ss-唯一字符串

其中YYYY，MM，DD，hh，mm，ss分别代表日志发送时的年，月，日，小时，分钟，秒。TargetPrefix是用户在启动Bucket日志时配置的。唯一字符串部分没有实际含义，可以被忽略。

系统不会删除旧的日志文件。用户可以自己删除以前的日志文件，可以在List Object时指定prefix参数，挑选出旧的日志文件，然后删除。

当客户端的请求到达后，日志记录不会被立刻推送到TargetBucket中，会延迟一段时间。

日志格式

字段名称	示例	备注
BucketOwner	mailaddress@email.com	源Bucket的Owner。
Bucket名称	mybucket	请求的bucket，如果OOS收到一个错误的bucket名称，那么这个请求不会出现在任何log中。
Time	dd/MM/yyyy HH:mm:ss zz	请求到达的时间。
Remote IP	72.21.206.5	请求者的IP地址。中间的代理和防火墙可能会隐藏实际发出请求的机器的地址。
Requester	根用户邮箱：mailaddress@email.com 子用户：arn:ctyun:iam::10rc2arpn6306:user/test_user 匿名用户：Anonymous	如果是根用户，显示根用户的邮箱，如：mailaddress@email.com。如果子用户，显示子用户的ARN，如：arn:ctyun:iam::10rc2arpn6306:user/test_user。如果是匿名访问，显示“Anonymous”。
Request ID	e4dd82b2f0994896	Request ID是OOS生成的一个字符串，用于唯一标示每个请求。
Operation	REST.PUT.OBJECT	REST.HTTP_method. resource_type。
Key	/photos/2012/08/puppy.jpg	请求的“Key”部分，URL编码。如果请求中没有指定对象，显示“-”。
Request-URI	"GET /mybucket/photos/2012/08/puppy.jpg HTTP/1.1"	HTTP请求中的Request-URI部分。
HTTP status	200	响应的HTTP状态码。
Error Code	NoSuchBucket	OOS错误码，如果没有错误，显示“-”。
Bytes Sent	2662992	写请求或读响应发送的字节数，不包括HTTP协议的头。如果是0，显示“-”。
Object Size	3462992	Object的总大小。
Time	70	从收到请求到发出响应的时间，单位是ms。
Referer	"http://oos.ctyun.cn"	HTTP Referer请求头的值。
User-Agent	"curl/7.15.1"	HTTP User-Agent请求头的值。
Version Id	3HL4kqtJvjVBH40Nrjfkd	请求中的versionId参数，如果没有，显示“-”。
Turn-Around Time	1024	OOS处理请求的时间，单位毫秒。即OOS接到客户端请求最后一个字节的时间，至OOS向客户端发送第一个响应字节的时间。说明：响应码为200和206的GET Object请求显示处理请求时间，其他操作显示“-”。

天翼云文档

百度智能云文档

腾讯云文档

阿里云文档

华为云文档

帐号服务

云计算

云安全

企业服务

备案服务

请求语法

请求参数

请求示例1

响应示例1

请求示例2

响应示例2

日志名称

日志格式

TOP云产品

解决方案

帮助与支持

其他链接

快速通道

关于 TOP云