喜讯：国内、香港、海外云服务器租用特惠活动，2核/4G/10M仅需31元每月，点击抢购>>>
点击这里注册天翼云特邀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 |
如果是根用户，显示根用户的邮箱，如：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错误码，如果没有错误，显示“-”。 |
推荐：TOP云智能建站优惠活动，仅880元即可搭建一个后台管理五端合一的智能网站（PC网站、手机网站、百度智能小程序、微信小程序、支付宝小程序），独享百度搜索SEO优势资源，让你的网站不仅有颜值有排面，更有排名，可以实实在在为您带来效益，请点击进入TOP云智能建站>>>，或咨询在线客服了解详情。 相关阅读
猜您喜欢
Copyright ? 2021-2025 尊托云数科技 All Rights Reserved. |
湘公网安备43019002001857号
备案号：
客服1 