jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的对象存储绑定源站域名

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) >
[管理存储空间](https://developer.qiniu.com/kodo/development_guidelines/8599/management-
of-storage-space) > 绑定源站域名

#  绑定源站域名

最近更新时间: 2023-11-29 11:13:30

Bucket 创建后，用户可以绑定自定义域名为其源站域名，然后使用自定义域名直接访问存储空间内的文件。

### **按照中华人民共和国《互联网管理条例》的要求，所有需要绑定自定义域名的用户，必须提前将域名在工信部备案。**

  

# **应用场景**

例如，用户 A 拥有一个域名为 `img.abc.org.cn` 的网站，网站的一个图片链接为
`http://img.abc.org.cn/logo.png` 。为方便后续管理，用户 A 想要访问网站中图片的请求转到七牛云对象存储
Kodo，并且不想修改任何网页的代码，也就是对外链接不变。绑定自定义域名可以满足这个需求。流程如下：

  1. 在私有云存储上创建一个名为 abc-img 的 Bucket (华东)，并将其网站上的图片上传至 Bucket。
  2. 通过控制台，将 `img.abc.org.cn` 这个自定义的域名与空间 abc-img 绑定。 绑定成功之后，七牛云对象存储 Kodo 会将 `img.abc.org.cn` 做一个映射到空间 abc-img。
  3. 在用户自己的域名服务器上，添加一条 CNAME 规则，将 `img.abc.org.cn` 映射成七牛云对象存储 Kodo 对应区域（华东-浙江）的下载服务地址：`iovip.qiniuio.com`。
  4. 当 `http://img.abc.org.cn/logo.png` 的请求到达七牛云对象存储 Kodo 后，通过 `img.abc.org.cn` 和 abc-img 的映射关系，将访问转到 abc-img 这个 Bucket。也就是说，对 `http://img.abc.org.cn/logo.png` 的访问，实际上访问的是七牛云对象存储 abc-img 空间里的 logo.png 文件。  
  

# **具体说明**

### **注：当创建空间后，系统已自动为该新空间配备测试域名，有效期 30
天，仅限用于业务对接测试。为了您的业务进展一切顺利，您需要先给空间绑定域名以提供正式的生产环境。**

  

通过自定义域名访问存储空间，需要给该域名添加 CNAME 记录指向存储空间所在区域对应的 CNAME 域名。

  * 各区域对应的 CNAME 域名 
    * 华东-浙江 `iovip.qiniuio.com`
    * 华东-浙江2 `iovip-cn-east-2.qiniuio.com`
    * 华北-河北 `iovip-z1.qiniuio.com`
    * 华南-广东 `iovip-z2.qiniuio.com`
    * 北美-洛杉矶 `iovip-na0.qiniuio.com`
    * 亚太-新加坡（原东南亚） `iovip-as0.qiniuio.com`
    * 亚太-河内 `iovip-ap-southeast-2.qiniuio.com`

  

# **操作方式**

Kodo 支持通过控制台方式设置源站域名，或通过 API 方式进行域名相关操作。

支持的操作方式 | 参考文档  
---|---  
控制台 | [设置自定义源站域名](https://developer.qiniu.com/kodo/development_guidelines/8556/set-the-custom-source-domain-name)  
API | [获取空间域名](https://developer.qiniu.com/kodo/api/3949/get-the-bucket-space-domain)  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储访问控制

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) >
[管理存储空间](https://developer.qiniu.com/kodo/development_guidelines/8599/management-
of-storage-space) > 访问控制

#  访问控制

最近更新时间: 2022-02-21 12:17:23

创建空间时，可设置为公开空间或私有空间。

  * 公开空间，可通过文件对象的 URL 直接访问。如果要使用七牛云存储的镜像存储功能，请设置空间的属性为公有。
  * 私有空间，文件对象的访问则必须获得拥有者的授权才能访问。下载私有资源 ，需要带有[下载凭证](https://developer.qiniu.com/kodo/development_guidelines/1656/download-private)。

公开和私有仅对空间的读文件生效，修改、删除、写入等对空间的操作均需要拥有者的授权才能进行操作。  
  

# **操作方式**

Kodo支持通过控制台、API、命令行辅助工具方式设置访问控制。

支持的操作方式 | 参考文档  
---|---  
控制台 | [设置访问控制](https://developer.qiniu.com/kodo/development_guidelines/8502/set-access-control)  
API | [private 设置Bucket访问权限](https://developer.qiniu.com/kodo/api/3946/set-bucket-private)  
命令行辅助工具 | [qrsctl](https://developer.qiniu.com/kodo/tools/1300/qrsctl)  
  
  

# **常见问题**

注意以下几点：

  1. **测试域名不能用于私有空间。**  
测试域名的缓存时间不能更改，只能是默认的 1 个月。因此，即使签出的私有链接过期时间短于 1 个月，也有可能在链接第一次访问过了 1 个月后才会过期。

  2. **自定义域名必须开启回源鉴权。**  
私有空间的自定义域名必须开启
回源鉴权(私有空间的域名，开启回源鉴权将自动填充成私有空间的规则，无需手动输入)。这是因为，自定义域名的缓存过期时间也有可能和私有链接的过期时间有矛盾，且默认的缓存策略是带问号参数缓存。  
如果不开启，可能会带来以下问题：

     * CDN 缓存时间长于私有链接过期时间，导致私有签名过期后仍可访问。
     * 访问时如果每次访问签出的链接不同，由于默认的缓存策略是带问号参数缓存，于是每次访问都回源，不会命中缓存，严重影响访问性能。
  3. **播放 hls 文件需要使用 pm3u8 服务。**  
播放 hls 文件时，需要用 pm3u8 服务，对 m3u8 文件列表里的 ts 链接做签名。

  4. **改变访问控制可能使当前正在运行的程序和该空间的域名无法正常使用。切换空间属性后需 10 分钟生效。**

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储静态页面管理

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) >
[管理存储空间](https://developer.qiniu.com/kodo/development_guidelines/8599/management-
of-storage-space) > 静态页面管理

#  静态页面管理

最近更新时间: 2022-11-08 11:50:46

静态网站是指网页都由静态内容构成，也涵盖客户端执行的脚本，如 JavaScript、Flash 等。  
您可以通过设置静态页面来将您的静态网站托管到对象存储Kodo的存储空间（Bucket），并使用空间的访问域名来访问这个网站。  
  

# **具体说明**

Kodo 当前支持配置如默认首页、404页面的静态网站：

### **默认首页**

  * 当通过浏览器访问静态网站域名时，Kodo返 回给用户的网站首页（即网站的 `index.html`）。
  * 开启该功能后，当前空间根目录及子目录中的 `index.html`（或 `index.htm`）文件将会作为默认首页进行展示。

### **默认404页**

  * 当通过浏览器访问空间内文件出现 404 错误时，Kodo 返回给用户的错误页面。
  * 设置的页面须保存在当前空间内，即若您选择上传文件作为自定义页面，该文件将默认名为 `errno-404` 并上传保存至当前空间内。

**注：请确保您已为当前空间绑定了自定义域名，以成功通过自定义域名进行静态网页的预览访问。关于绑定自定义域名步骤，请参考[域名管理](https://developer.qiniu.com/kodo/development_guidelines/8527/kodo-
domain-name-management)。**

  

# **使用案例**

当您已为当前空间绑定了自定义域名 `https://example.com` 并为该空间开启默认首页、配置404页面设置，即将名称为
`index.html` 的默认首页文件和名称为 `errno-404` 的默认404页面文件上传至当前空间根目录下时，则

  * 当您访问 `https://example.com` 时，将返回 `https://example.com/index.html`。
  * 当您访问 `https://example.com/Object` 时，如 Object 存在即返回该文件内容，若 Object 不存在即返回 `errno-404` 的文件内容。
  * 如您还将名称为 `index.html` 的默认首页文件上传至当前空间的子目录 `xyz/` 下时，则当您访问 `https://example.com/xyz` 时，将返回 `https://example.com/xyz/index.html`。

  

# **操作方式**

Kodo支持通过控制台方式进行相关静态网页的设置。

支持的操作方式 | 参考文档  
---|---  
控制台 | [设置静态页面](https://developer.qiniu.com/kodo/development_guidelines/12269/set-a-static-page)  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储空间备注

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) >
[管理存储空间](https://developer.qiniu.com/kodo/development_guidelines/8599/management-
of-storage-space) > 空间备注

#  空间备注

最近更新时间: 2022-07-28 16:49:21

您可以通过存储空间（Bucket）的空间备注功能，为空间添加描述说明，以便于您在拥有大量空间时有效区分每个空间的用途。

  * 支持您使用中文、大小写英文、数字等设置备注
  * 不指定空间备注内容则不启用该功能
  * 支持最多 100 个字符

  

# **操作方式**

Kodo支持通过控制台方式设置空间备注。

支持的操作方式 | 参考文档  
---|---  
控制台 | [设置空间备注](https://developer.qiniu.com/kodo/development_guidelines/12157/set-the-space-note)  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储文件客户端缓存

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) >
[管理存储空间](https://developer.qiniu.com/kodo/development_guidelines/8599/management-
of-storage-space) > 文件客户端缓存

#  文件客户端缓存

最近更新时间: 2022-02-21 15:58:05

使用空间属性 maxAge 实现对文件客户端缓存的控制, 达到配置 HTTP header 中 Cache-Control:max-age 的目的。  
  

# **具体说明**

  * **Cache-Control 的概念**
    * Cache-Control 通用消息头被用于在 http 请求和响应中通过指定指令来实现缓存机制, 是一种缓存控制的方法。 HTTP header 中，服务器可以通过对 Cache-Control 的设置来指定在文档过期之前将其缓存多长时间。
    * 例如，七牛控制台可以通过配置 Cache-Control: max-age 的时间表示从服务器传来文档之时起，认为此文档处于新鲜状态的秒数。  
  

  * **maxAge 值和 CDN 缓存时间的区别**  
访问资源链接时，缓存通常分为浏览器缓存和 CDN 节点缓存。  
用户在浏览器中输入资源链接访问时，优先使用浏览器缓存，缓存失效或禁用本地缓存后，会向 CDN 节点请求资源，当 CDN
缓存时间超时后，会向源站发起资源请求。

    * Cache-Control:max-age: 设置缓存存储的最大周期，超过这个时间缓存被认为过期(单位秒)，控制用户浏览器端的缓存。
    * CDN 缓存：当 CDN 缓存超时后，节点认为缓存失效，会向源站重新请求资源。  
  

  * **查看 Cache-Control 的 maxAge 值**
    * 以 chrome 控制台为例，打开开发者工具或检查，在 network 标签页下查看。  
![FmFP1Yf577R9H32p6lDhG-4-apiy.png](https://dn-
odum9helk.qbox.me/FmFP1Yf577R9H32p6lDhG-4-apiy)  
  

# **操作方式**

Kodo 支持通过控制台设置文件客户端缓存 maxAge。

支持的操作方式 | 参考文档  
---|---  
控制台 | [设置文件客户端缓存](https://developer.qiniu.com/kodo/development_guidelines/8535/settings-file-the-client-cache)  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储重定向

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) >
[管理存储空间](https://developer.qiniu.com/kodo/development_guidelines/8599/management-
of-storage-space) > 重定向

#  重定向

最近更新时间: 2022-11-07 12:18:32

七牛对象存储 Kodo
提供重定向功能帮助访问请求者在指定的条件下，实现按自定义的重定向规则进行自动跳转访问。用户可以利用此重定向功能实现对文件访问的跳转以及在此基础上实现其他业务需求。

  

# **使用场景**

常见的使用该功能的场景，如：

  * 访问空间发生指定错误后重定向，如发生 4xx 错误，支持配置规则以跳转至指定地址
  * 访问链接匹配到指定文件名后重定向，如您不希望某些前缀开头的文件被访问，配置规则后该访问请求将跳转至指定链接。
  * 文件在空间中不存在，或发生 404 错误后重定向，支持在请求者访问报错时，统一展现您配置的预设页面。

  

# **功能说明**

重定向功能根据您设置的访问条件进行匹配，并结合您设置的跳转规则，最终向请求者返回一个 3xx 跳转。具体流程可参考下图：  
![image.png](https://dn-odum9helk.qbox.me/FsBBLeU9XzYeWZFVV-RTINvIHiiP)

  

# **功能限制**

  * 重定向规则的匹配条件 HTTP 状态码仅支持设置为 4xx。
  * 重定向规则最多配置 20 条。
  * 按规则先后顺序依次匹配。如果命中当前规则，则后续规则不再匹配。规则未命中表示没有匹配重定向条件。

  

# **操作方式**

Kodo支持通过控制台方式设置重定向。

支持的操作方式 | 参考文档  
---|---  
控制台 | [设置重定向](https://developer.qiniu.com/kodo/development_guidelines/12262/set-the-redirect)  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储空间标签

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) >
[管理存储空间](https://developer.qiniu.com/kodo/development_guidelines/8599/management-
of-storage-space) > 空间标签

#  空间标签

最近更新时间: 2022-02-21 14:48:33

您可以通过存储空间（Bucket）的标签功能， 对 Bucket 进行分类管理，比如列举带有指定标签的 Bucket。

Bucket 标签使用一组键值对（Key-Value）标记存储空间。

  * 只有 Bucket 的拥有者能为 Bucket 设置标签。
  * 每个 Bucket 最多可设置 10对 Bucket 标签（Key-Value 对），超出限制时服务端会返回 `400: tag num exceed limit`。
  * 同一个 Bucket 下，Key 必须是唯一的, 且一个 Key 只能有 1个 Value，Key 设置重复时服务端会返回 `400: tag contain duplicate key`。
  * Key 最大长度为 64Byte，不能为空且大小写敏感，不能以 kodo 为前缀(预留), 不支持中文字符，可使用的字符有：字母，数字，空格，+ - = . _ : / @。
  * Value 最大长度为 128Byte，不能为空且大小写敏感，不支持中文字符，可使用的字符有：字母，数字，空格，+ - = . _ : / @。  
  

# **操作方式**

Kodo 支持通过控制台、API 方式设置空间标签。

支持的操作方式 | 参考文档  
---|---  
控制台 | [设置空间标签](https://developer.qiniu.com/kodo/development_guidelines/8536/set-up-the-label-management)  
空间标签 API | [设置空间标签](https://developer.qiniu.com/kodo/api/6314/put-bucket-tagging)   
[查询空间标签](https://developer.qiniu.com/kodo/api/6315/get-bucket-tagging)  
[删除空间标签](https://developer.qiniu.com/kodo/api/6316/delete-bucket-tagging)  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储空间授权

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) >
[管理存储空间](https://developer.qiniu.com/kodo/development_guidelines/8599/management-
of-storage-space) > 空间授权

#  空间授权

最近更新时间: 2022-02-21 16:00:07

空间授权是指存储空间所有者通过空间授权功能将存储空间授予给七牛用户，存储空间授权用户可以对授权空间进行读写或只读操作。授权时，需要为被授权者指定一个全局唯一的空间别名。  
  

# **应用场景**

  * 用户根据业务需要，授权其他用户访问自己存储空间的资源。
  * 用户根据业务需要，授权其他用户管理存储空间资源。  
  

# **具体说明**

  * **存储空间所有者：** 存储空间所有者，拥有全部读写权限。
  * **存储空间授权用户：** 被存储空间所有者授予权限的用户，按照被授予权限不同，分为只读权限或读写权限。
  * **授予权限：** 授予权限分为只读权限和读写权限。
  * **只读权限：** 被授权用户对空间的所有对象拥有访问权限。
  * **读写权限：** 对于空间内所有对象拥有增加、删除、修改和访问的权限。  
  

# **使用区域**

华东、华北、华南、北美、东南亚  
  

# **功能计费**

  * 存储空间所有者将的存储空间授权给存储空间授权用户后，存储空间授权用户在使用存储空间时产生费用（如存储费用、API 请求费用和流量费用）均计入存储空间所有者账单。
  * 存储空间授权用户在使用存储空间时产生的源站流量、CDN 流量均计入存储空间所有者账单。  
  

# **操作方式**

Kodo 支持通过控制台方式或命令行辅助工具设置空间授权。

支持的操作方式 | 参考文档  
---|---  
控制台 | [设置空间授权](https://developer.qiniu.com/kodo/development_guidelines/8537/set-the-space-authorization)  
命令行辅助工具 | [qrsctl](https://developer.qiniu.com/kodo/tools/1300/qrsctl)  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储跨域资源共享

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) >
[管理存储空间](https://developer.qiniu.com/kodo/development_guidelines/8599/management-
of-storage-space) > 跨域资源共享

#  跨域资源共享

最近更新时间: 2021-08-31 14:10:52

跨域访问，或者说 JavaScript 的跨域访问问题，是浏览器出于安全考虑而设置的一个限制，即同源策略。当来自于 A 网站的页面中的 JavaScript
代码希望访问B网站的时候，浏览器会拒绝该访问，因为 A、B 两个网站是属于不同的域。

在实际应用中，经常会有跨域访问的需求，比如用户的网站 a.website.com，后端使用了七牛云对象存储 Kodo 系统。在网页中提供了使用
JavaScript 实现的上传功能，但是在该页面中，只能向 a.website.com
发送请求，向其他网站发送的请求都会被浏览器拒绝。这样就导致用户上传的数据必须从 a.website.com
中转。如果设置了跨域访问的话，用户就可以直接上传到七牛云存储而无需从 a.website.com 中转。  
  

# **跨域资源共享的实现**

  * 跨域资源共享（Cross-Origin Resource Sharing），简称 CORS，是 HTML5 提供的标准跨域解决方案，七牛云存储系统支持 CORS 标准来实现跨域访问。具体的 CORS 规则可以参考 W3C CORS 规范。其实现如下： 
    * CORS 通过 HTTP 请求中附带 Origin 的 Header 来表明自己来源域，比如上面那个例子，Origin 的 Header 就是 a.website.com。
    * 服务器端接收到这个请求之后，会根据一定的规则判断是否允许该来源域的请求。如果允许，服务器在返回的响应中会附带上 Access-Control-Allow-Origin 这个 Header，内容为 a.website.com 来表示允许该次跨域访问。如果服务器允许所有的跨域请求，将 Access-Control-Allow-Origin 的 Header 设置为 * 即可。
    * 浏览器根据是否返回了对应的 Header 来决定该跨域请求是否成功，如果没有附加对应的 Header，浏览器将会拦截该请求。如果是非简单请求，浏览器会先发送一个 OPTIONS 请求来获取服务器的 CORS 配置，如果服务器不支持接下来的操作，浏览器也会拦截接下来的请求。
  * 对象存储 Kodo 默认允许资源的跨域访问，会返回 Access-Control-Allow-Origin : * 的 Header 内容；同时提供了存储空间级别的 CORS 规则配置，添加规则后 Kodo 会根据已设定的规则来允许或者拒绝相应的跨域请求。 
    * Kodo 系统支持创建多条跨域访问规则，当收到跨域访问请求时，会依次检查每一条规则，使用第一条匹配的规则来允许请求并返回对应的 Header。
    * 如果所有规则都匹配失败，则不附加任何 CORS 相关的 Header。
    * CORS 规则匹配成功必须满足以下三个条件： 
      * 请求的 Origin 必须匹配一个允许来源项。
      * 请求的方法（如 GET、PUT 等）或者 OPTIONS 请求的 Access-Control-Request-Method 头对应的方法必须匹配一个允许 Methods 项。
      * OPTIONS 请求的 Access-Control-Request-Headers 头包含的每个 Header 都必须匹配一个允许 Headers 项。  
  

# **具体说明**

  * CORS 相关的 Header 附加等都是浏览器自动完成的，用户不需要有任何额外的操作。CORS 操作也只在浏览器环境下有意义。
  * CORS 请求的通过与否和对象存储 Kodo 的身份验证是完全独立的，即对象存储 Kodo 的 CORS 规则仅仅是用来决定是否附加 CORS 相关的 Header 的一个规则。是否拦截该请求完全由浏览器决定。
  * 使用跨域请求的时候需要关注浏览器是否开启了 Cache 功能。当运行在同一个浏览器上分别来源于 a.website.com 和 b.website.com 的两个页面都同时请求同一个跨域资源的时候，如果 a.website.com 的请求先到达服务器，服务器将资源带上 Access-Control-Allow-Origin 的 Header 为 a.website.com 返回给用户。这个时候 b.website.com 又发起了请求，浏览器会将 Cache 的上一次请求返回给用户，此时 Header 的内容和 CORS 的要求不匹配，就会导致后面的请求失败。  
  

# **操作方式**

Kodo 支持通过控制台方式设置跨域资源共享。

支持的操作方式 | 参考文档  
---|---  
控制台 | [设置跨域资源共享](https://developer.qiniu.com/kodo/development_guidelines/8539/set-the-cross-domain-resource-sharing)  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储事件通知

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) >
[管理存储空间](https://developer.qiniu.com/kodo/development_guidelines/8599/management-
of-storage-space) > 事件通知

#  事件通知

最近更新时间: 2023-12-25 11:31:50

事件通知功能，能够对管理员所关心的存储资源操作及时进行消息通知。例如：

  * 有新数据从图片内容分享平台、音视频平台上传到七牛云对象存储 Kodo
  * 资源发生了更新
  * 重要文件被删除
  * 数据同步已经完成

  

# **具体说明**

  * 您创建事件通知规则后，若请求者对您的对象存储 Kodo 资源进行操作并触发了事件通知规则，则请求者对 Kodo 进行的相关操作将会被发送到您配置的 HTTP(s) 服务端地址上。您可以针对事件通知返回的消息进行收集分析，如重点信息特别关注、数据统计分析等。
  * 事件通知当前针对操作成功的事件进行通知。
  * 事件通知是异步进行的，不影响正常的操作。事件通知的配置包括规则和消息通知两部分。 
    * 规则：用来描述什么情况下需要进行消息通知。
    * 消息通知：支持以回调方式将消息推送到指定 URL。  
  

# **事件类型**

事件类型 | 事件说明  
---|---  
put | 创建/覆盖文件：简单上传  
copy | 创建/覆盖文件：拷贝文件  
append | 创建/覆盖文件：追加上传  
move | 移动文件  
delete | 删除文件：1 个或多个  
mkfile | 创建/覆盖文件：分片上传完成  
disable | 修改文件状态：禁用  
enable | 修改文件状态：启用  
restore:completed | 文件解冻：完成  
  
  

# **回调消息格式**

    
    
    {
       “Message”:“{
           “event”:“put”,
           “time”:1547551207786351434,
           “reqid”:“niNkZJy_3M9903AEA”,
           “source_ip”:“33.236.132.29”, 
           “user_id”:“uid:111111”,
           “access_key”:“akjFT8jsaYB8kj-90HJJkds”,
           “bucket”:“bucket_name”,
           “key”:“event1_tets.txt”,
           “fsize”:6,
           “hash”:“FhWqsP2Lk36zuwGEFpPzXct12i-v”,
           “ftype”:0,
           “mimetype”:“application/octet-stream”,
           “restore_expiration”:“2019-01-20T19:20:07+08:00”,
           “dest_bucket”:“dest_bucket_name”,
           “dest_key”:“dest_key_name”
       }”,
       “Subject”: “Qiniu KODO Notification”,
       “Timestamp”: “2019-01-15T19:20:07+08:00” //事件通知发送时间
    }
    

Message 回调消息参数 | 说明  
---|---  
event | 事件类型  
time | 事件发生时间，纳秒级时间戳  
reqid | 请求的 Request ID  
source_ip | 请求的源 IP  
user_id | 请求者 uid   
\- 普通账号 `qrn:iam::<root-uid>:root`，如：qrn:iam::1111111:root  
\- IAM 子账号 `qrn:iam::<root-uid>:user/<user-name>`，如：qrn:iam::1111111:user/iam-
test  
\- 系统账号 `qrn:<product>::<service>:admin`

  * product 为 Kodo 
  * service 支持为 replication 跨区域同步、lifecycle 生命周期、access_log 空间日志、restore 对象解冻

  
access_key | 请求者 ak，需要配合 user_id 识别  
\- 普通账号 ak  
\- IAM 子账号 ak，如：IAM-qnd-njkG89ndsxxxxxxxxx  
\- 系统账号 admin，同系统账号的 user_id 信息一致  
bucket | Bucket 名称  
key | Object 名称  
fsize | Object 大小  
hash | Object Etag 值  
ftype | Object 的存储类型   
\- 0 标准存储、1 低频存储、2 归档存储、3 深度归档存储、4 归档直读存储  
mimetype | Object 的 mimeType  
restore_expiration | Object 的解冻到期时间，仅 restore:completed 事件返回  
dest_bucket | 目标 Bucket 名称，仅 copy/move 事件返回  
dest_key | 目标 Object 名称，仅 copy/move 事件返回  
  
  

# **操作方式**

Kodo 支持通过控制台方式设置事件通知。

支持的操作方式 | 参考文档  
---|---  
控制台 | [设置事件通知](https://developer.qiniu.com/kodo/development_guidelines/8541/set-the-event-notification)  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储跨区域同步

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) >
[管理存储空间](https://developer.qiniu.com/kodo/development_guidelines/8599/management-
of-storage-space) > 跨区域同步

#  跨区域同步

最近更新时间: 2023-12-25 11:32:21

跨区域同步是不同区域的存储空间之间的数据同步，它将源存储空间对象的改动（除删除操作）同步到目标存储空间。目前支持华东-浙江、华东-浙江2、华北-河北、华南-
广东、北美-洛杉矶、亚太-
新加坡存储区域的跨区域同步，但是暂未支持归档存储和深度归档存储类型文件的跨区域同步。在进行跨区域同步之前，您可以选择是否将源存储空间的历史数据复制至目标存储空间。  
  

# **应用场景**

当你有以下需要时，设置跨区域同步管理功能可能对您有所帮助：

  * 数据同步：由于业务原因，需要将数据从一个存储区域迁移至另一个存储区域，原空间数据仍会保留。
  * 合规性要求：合规性要求所规定的数据需要跨一定距离保存一份副本。通过跨区域同步管理功能，可以在远距离的存储区域之间同步数据以满足这些合规性要求。
  * 数据备份：如果您对所有写入的数据都希望在异地存储区域维护一份副本，以备发生如海啸、地震等特大灾难导致存储区域损毁时，还能启用异地存储区域的备份数据。
  * 最大限度减少延迟：为了最大限度缩短访问对象时的延迟，可以在地理位置与用户较近的存储区域维护对象副本。  
  

# **限制说明**

  * 同步任务的目标存储空间被删除之后，新产生的文件改动，都不会再同步。  
  

# **计费方式**

  * 使用跨区域同步功能会产生存储量、流量和请求次数的费用。
  * 文件同步后会在源空间和目标空间分别产生一份存储量费用。
  * 跨区域同步流量计费价格如下：  区域 | 标准存储 | 低频存储 | 归档直读存储  
---|---|---|---  
国内 <=> 国内 | 0.29 元/GB | 0.29 元/GB | 0.29 元/GB  
国内 <=> 海外 | 0.58 元/GB | 0.58 元/GB | 0.58 元/GB  
  * 跨区域同步产生的请求次数合并计入各存储类型的 PUT／DELETE 请求 和 GET 请求次数中，共享用户请求次数的免费额度，超出免费额度的请求费用按照[七牛云官网价格 __](https://www.qiniu.com/prices/kodo)页面中的 PUT／DELETE 请求 和 GET 请求单价进行计费。  
  

# **操作方式**

Kodo支持通过控制台方式设置跨区域同步。

支持的操作方式 | 参考文档  
---|---  
控制台 | [设置跨区域同步](https://developer.qiniu.com/kodo/development_guidelines/8557/set-the-cross-regional-synchronization)  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储空间访问日志

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) >
[管理存储空间](https://developer.qiniu.com/kodo/development_guidelines/8599/management-
of-storage-space) > 空间访问日志

#  空间访问日志

最近更新时间: 2023-12-25 11:32:59

对象存储 Kodo 提供自动保存访问空间日志的功能。  
  

# **具体说明**

  * 当天的日志 2 天后可下载
  * 支持存储空间开启和关闭日志记录
  * 支持在已开启日志记录的同一存储空间中存储日志，也可以另外创建新存储空间来存储日志。
  * 当空间开启访问日志记录功能后，Kodo 自动将访问这个空间的请求日志，按照固定的命名规则，每 10 分钟生成一个文件写入您指定的目标空间。  
  

# **日志的命名规则**

存储访问空间日志的文件命名规则示例如下：

    
    
    _log/bucketname/YYYY-MM-DD-HH-mm/partN.gz
    

字段名称 | 说明  
---|---  
_log | 固定字段  
bucketname | 用户指定的存储访问空间日志的空间名  
YYYY-MM-DD-HH-mm | YYYY、MM、DD、HH 和 mm 分别是该日志文件被创建时的阿拉伯数字的年、月、日、小时、分钟  
partN.gz | 当日志文件很大时，会拆分成多个，第一个是 part0，第二个是 part1，以此类推  
  
  

# **日志文件格式**

日志文件的组成字段举例说明，帮助您更好的分析日志。以下名称从左至右，以空格分隔。

字段名称 | 举例说明  
---|---  
Remote IP | 远端 IP 地址，比如 120.194.101.86。  
Remote Logname | 远程登录名，目前统一显示为 -。  
Remote User | 远程用户名，目前统一显示为 -。  
Time | 七牛云对象存储收到请求的时间，比如 [16/May/2013:00:00:00 +0800]。  
RequestTime | 七牛对象存储 Kodo 处理本次请求的时间（ms）。  
Request-URI | 用户请求的 URI，比如 “GET /group1/M00/28/9D/CvFRWFGSBvsEAAAAAAAAAD0JyMI178.jpg?imageView/2/w/480 HTTP/1.1”。  
HTTP Status | 七牛对象存储 Kodo 返回的 HTTP 状态码，比如 200。  
SentBytes | 用户下载的流量，比如 37431。当没有字节传送时显示 -，而不是 0。  
Referer | 请求的 HTTP Referer，比如 “http://iovip.qiniuio.com”。没有时，显示 “-”。  
User-Agent | HTTP 的 User-Agent 头，比如 “Dalvik/0.0.0 (Linux; U; Android 1.6.1.16-RT-20120926.152630; W806 Build/AliyunOs-2012)”。  
Request Host | HTTP 请求的 Host，比如 “http://image.qiniu.com”。  
UID | 空间拥有者的 uid。  
Bucket | 空间拥有者的空间名。  
StorageClass | 对象存储类型，0 表示标准存储，1 表示低频存储，2 表示归档存储，3 表示深度归档存储，4 表示归档直读存储。  
Sync Request | 是否是 CDN 回源请求，若来自 CDN，则为 qiniucdn；若不是则为-。  
Version | 目前固定值为 V2。  
  
日志格式为：Remote IP - - [Time] RequestTime “Request-URI” HttpStatus SentBytes
“Referer” User-Agent “Request Host” UID Bucket StorageClass V2  
一条完整的日志记录例子如下：

    
    
    120.194.101.86 - - [16/May/2013:00:00:00 +0800] 20 "GET /group1/M00/28/9D/CvFRWFGSBvsEAAAAAAAAAD0JyMI178.
    
    jpg?imageView/2/w/480 HTTP/1.1" 200 37431 "-" "Dalvik/0.0.0 (Linux; U; Android 1.6.1.16-RT-20120926.
    
    152630; W806 Build/AliyunOs-2012)" "http://image.yourdream.cc" 10101010 Tbl 0 - V2
    

  

# **补充说明**

  * 日志中的任何一个字段，都可能出现-，用于表示未知数据或对于当前请求该字段无效。
  * 根据需求，日志格式将来会在尾部（Version 字段除外），添加一些字段，请开发者开发日志处理工具时需考虑兼容性的问题。  
  

# **操作方式**

Kodo 支持通过控制台方式设置空间访问日志。

支持的操作方式 | 参考文档  
---|---  
控制台 | [设置空间日志](https://developer.qiniu.com/kodo/development_guidelines/8546/set-the-space-log)  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储删除空间

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) >
[管理存储空间](https://developer.qiniu.com/kodo/development_guidelines/8599/management-
of-storage-space) > 删除空间

#  删除空间

最近更新时间: 2021-08-31 14:23:01

当您不再需要使用指定存储空间（Bucket）时，对象存储 Kodo 支持您删除该空间。  
您可以在对象存储 Kodo 控制台或通过 API 方式进行删除操作。  
  

# **具体说明**

  * 非空空间不可删除，您需要先删除该空间中所有的文件（Object），详情请见[删除文件](https://developer.qiniu.com/kodo/development_guidelines/8571/delete-the-file)。
  * 直播空间不可删除，详情请参考七牛直播云[直播落存储服务 __](https://developer.qiniu.com/pili/1209/live-the-core-function#4)。
  * 若空间仍绑定有自定义 CDN 域名时，不允许删除。您可参考[设置自定义 CDN 加速域名](https://developer.qiniu.com/kodo/development_guidelines/8555/set-the-custom-cdn-to-accelerate-the-domain-name)先解绑 CDN 域名，后删除空间。
  * 空间删除后，空间名称可以被重新使用。

### **空间删除后不可恢复，请谨慎操作！**

  

# **操作方式**

Kodo 支持通过控制台、API 方式设置删除存储空间。

支持的操作方式 | 参考文档  
---|---  
控制台 | [删除存储空间](https://developer.qiniu.com/kodo/development_guidelines/8548/remove-the-storage-space)  
API | [drop 删除空间](https://developer.qiniu.com/kodo/api/1601/drop-bucket)  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储数据安全

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) > 数据安全

#  数据安全

最近更新时间: 2022-06-24 11:05:52

为保障您的数据安全，对象存储 Kodo 支持多方面的安全设置:

快速链接 | 摘要  
---|---  
[Referer 防盗链](https://developer.qiniu.com/kodo/development_guidelines/8618/dev-preventing-hotlinking) | 依据用户设置访问域名参数来允许或限制访问，防止数据被盗链。  
[对象锁定](https://developer.qiniu.com/kodo/development_guidelines/8621/dev-object-locking) | 支持使用一次写入、多次读取模式存储对象，实现在固定的时间段内或无限期地阻止删除或覆盖对象。  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储Referer 防盗链

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) >
[数据安全](https://developer.qiniu.com/kodo/development_guidelines/8625/dev-data-
security) > Referer 防盗链

#  Referer 防盗链

最近更新时间: 2022-07-05 14:21:18

为了防止数据被其他人盗链，用户可以设置防盗链功能，包括以下参数：

  * Referer 白名单，仅允许指定的域名访问资源；或黑名单，指定域名禁止访问资源
  * 是否允许空 Referer。如果不允许空 Referer，则只有 HTTP 或 HTTPS header 中包含 Referer 字段的请求才能访问资源。  
例如，对于一个名为 test-example 的 Bucket，设置其 Referer 白名单为 http://www.mytest.com/。则所有
Referer 为 http://www.mytest.com/ 的请求才能访问 test-example 这个 Bucket 中的 Object。  
  

# **具体说明**

  * Referer 验证 
    * 一旦开启 Referer 防盗链，所有请求都会做防盗链验证。
  * Referer 配置 
    * 一个 Bucket 可以支持多个 Referer 参数。通过控制台设置时使用回车作为换行符分隔.
    * 无需填写 http:// ，https:// .
    * 支持域名前使用通配符「 * 」：*.example.com 可用于指代所有 example.com 下的多级子域名，比如 a.example.com 等，但是不包括 example.com，如需要请额外填写一条 example.com.
    * 支持完全通配符，即规则是一个「 * 」
  * Referer 效果 
    * Referer 白名单为空时，不会检查 Referer 字段是否为空（否则所有的请求都会被拒绝）。黑名单为空时，会检查 Referer 字段是否允许为空。
    * 如果 Referer 白名单不为空，且不允许 Referer 字段为空，则只有 Referer 属于白名单的请求被允许，其他请求（包括 Referer 为空的请求）会被拒绝。
    * 如果白名单不为空，但允许 Referer 字段为空，则 Referer 为空的请求和符合白名单的请求会被允许，其他请求都会被拒绝。

  

# **操作方式**

Kodo 支持通过控制台方式设置防盗链。

支持的操作方式 | 参考文档  
---|---  
控制台 | [设置 Referer 防盗链](https://developer.qiniu.com/kodo/development_guidelines/8538/set-the-referer-hotlinking-prevention)  
  
以上内容是否对您有帮助？