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/8625/dev-data-
security) > 对象锁定

#  对象锁定

最近更新时间: 2023-12-25 11:40:29

对象存储 Kodo 支持设置空间（Bucket）级别的对象锁定功能。开启对象锁定后，您可以使用一次写入，多次读取 (write once read
many, WORM) 模式存储对象（Object）。您可以使用它在固定的时间段内或无限期地阻止删除或覆盖对象，符合合规监管需求。

针对需要长期存储且不允许修改或删除的重要数据，如医疗档案、合同等，您可以将它们存放在开启对象锁定、设置了保留策略的存储空间内，以便于保护。  
  

# **具体说明**

空间的对象锁定状态有：「关闭」、「开启」  
**注：一旦将空间的对象锁定状态设置为「开启」，它将无法返回到「关闭」状态。**

### **开启对象锁定**

  * Kodo 支持在空间级别设置开启对象锁定功能，用户可针对存储空间设置基于时间的合规保留规则。
  * 当规则设定后，用户可以在空间中上传和读取文件 Object。
  * 在开启对象锁定时，受保护文件不可被任何用户删除或覆盖，包括修改文件类型信息、修改自定义元数据、修改文件名。Object 的保留时间到期后，才可以进行相关操作。

### **对象锁定**

  * 我们提供在空间上设置默认保留模式，当前仅支持合规保留模式，会在设置保护时间段内保护数据。
  * 开启对象锁定，启动合规保留模式，不可关闭，将永久允许锁定此存储空间中的对象。 
    * 保留周期设置后，只可延长、不可缩短。
    * 允许针对指定空间添加一条基于时间的合规保留策略，保护周期为 1天 到 70年。
    * 当前设置的保留周期仅作用在设置完成后空间内新上传的文件上。

### **对象锁定与其他空间设置功能**

  * 与[生命周期管理](https://developer.qiniu.com/kodo/development_guidelines/8609/dev-life-cycle-management)
    * 不可在生命周期保护周期内删除，超过保护期再删除。
    * 同时设置生命周期删除策略和对象锁定保护时，将自动判断取锁定保护时间及删除策略定义时间的最大值作为删除时间。
    * 其他生命周期管理配置（转低频、转归档直读、转归档、转深度归档）将继续正常应用于受对象锁定保护的对象。
  * 与[删除空间](https://developer.qiniu.com/kodo/development_guidelines/8601/dev-delete-the-space)
    * 若带有对象锁定策略的空间内未存储文件，可以直接删除该空间。
    * 若带有对象锁定策略的空间内已存储文件，且所有文件均已过了保护期，支持先删除该空间内所有文件，再删除空间。
    * 若带有对象锁定策略的空间内已存储文件，且还有文件处于保护期内，无法删除该空间。  
  

# **操作方式**

Kodo 支持通过控制台方式设置对象锁定。

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

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

#  数据处理

最近更新时间: 2024-03-27 11:51:14

对象存储 Kodo 支持您的多样化数据处理需求：

快速链接 | 摘要  
---|---  
[视频处理](https://developer.qiniu.com/kodo/development_guidelines/12654/video-process) | 针对视频类文件提供的实时转码处理服务  
[图片处理](https://developer.qiniu.com/kodo/development_guidelines/8623/dev-the-picture-style) | 针对图片类文件提供图片处理服务  
[转码样式](https://developer.qiniu.com/kodo/development_guidelines/8624/dev-transcoding-style) | 针对控制台上传文件提供的一键式转码模板  
[原始资源保护](https://developer.qiniu.com/kodo/development_guidelines/8616/dev-the-original-image-to-protect) | 针对媒体类源文件的保护措施，使空间内的文件无法直接通过url进行访问  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储CDN 热点视频瘦身

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) >
[数据处理](https://developer.qiniu.com/kodo/development_guidelines/8615/dev-the-
data-processing) > CDN 热点视频瘦身

#  CDN 热点视频瘦身

最近更新时间: 2024-08-21 16:33:58

七牛云支持 CDN 热点视频瘦身功能，节省视频分发成本的同时、保证视频播放体验。

开启 CDN 热点视频瘦身后，系统会依据文件在 **七牛 CDN** 上的访问统计次数自动识别热点视频、触发视频瘦身处理、并在瘦身成功后刷新对应的 CDN
缓存，将瘦身后的文件快速应用于分发访问。

经瘦身处理的视频文件，肉眼画质基本不变（局部增强）、文件体积一般减小 30%～40%。

瘦身支持两种触发类型

  * 访问次数阈值：统计周期内访问次数>阈值的视频触发处理
  * 访问次数TopN：统计周期内访问次数排名前 N 的视频触发处理

![](https://dn-odum9helk.qbox.me/FlH0ft0suvDybsdRUSWhV5Ry9A3y)

## 功能优势

  1. 降低视频的 CDN 分发成本

  * 瘦身后的视频文件，肉眼画质基本不变（局部增强）、文件体积一般减小 30%～40%

  2. 按需处理、优化转码成本

  * 仅热点视频触发瘦身、有效减少转码量

  3. 自动触发、效率优化

  * 自动触发、自动分发、用户业务 0 管理代码，无需用户统计热点视频、规划管理瘦身任务

## 应用案例

  1. app 使用 CDN 域名 app.example.com 分发 mp4 和 m3u8 的视频文件，`https://app.example.com/test.mp4` 视频每次完整播放需要流量 1.2 GB
  2. 为域名 app.example.com 开启热点视频瘦身功能，配置

  * 仅对 .mp4、.m3u8 后缀的文件识别热点
  * 当文件在 60 分钟内的访问次数超过 100 次时触发瘦身处理

  3. 之后系统每间隔约 5 分钟，就统计出过去 60 分钟内访问次数超过 100 次的文件、后台执行视频瘦身处理，其中 `https://app.example.com/test.mp4` 被访问了 200 次
  4. 当 `test.mp4` 瘦身处理完成后，文件大小变成了 0.7GB，系统会刷新掉 `https://app.example.com/test.mp4` 的 CDN 缓存
  5. 之后终端再次访问 `https://app.example.com/test.mp4` 时会获取到瘦身后的视频文件，每次完整播放 `test.mp4` 视频只需要 0.7GB 流量

## 功能开启

CDN 热点视频瘦身功能，暂时不支持自助开启、需后台配置，如有需求请您联系您的商务，或是[提交工单
__](https://support.qiniu.com/tickets/new)申请。

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储图片处理

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) >
[数据处理](https://developer.qiniu.com/kodo/development_guidelines/8615/dev-the-
data-processing) > 图片处理

#  图片处理

最近更新时间: 2024-03-27 11:39:37

对象存储 Kodo 对空间中的图片提供多种处理功能：

  * 对图片进行缩略操作
  * 图片缩放、裁剪、旋转
  * 获取图片格式、大小、色彩模型信息
  * 提供数码相机照片的可交换图像文件格式
  * 图片添加图片、文字、图文混合水印等

您可以通过两种方式使用图片处理功能

  * 通过给图片 URL 添加参数：您可以通过在图片的访问链接（URL）后添加相应参数来对图片进行相应的处理。
  * **使用图片样式** ：推荐您通过创建样式的方式将不同的处理效果保存下来，然后使用样式对图片进行统一的处理。图片样式是图片下载时实时处理参数组合的一个模板。

# **图片样式**

图片样式访问链接格式：`图片访问链接 + 分隔符 + 样式名称`

  * 图片样式，是图片实时处理参数组合的模板。
  * 样式分隔符，是用于连接资源链接和图片样式的特殊符号
  * 存储服务处理访问请求时，会优先定位到链接中的分隔符、并尝试以分隔符之后的内容去匹配图片样式、触发图片处理

### **样式分隔符**

  * 为防止访问出错，样式名称中不可出现已设置启用的分隔符。
  * 修改分隔符会导致样式访问链接生效，并且须 24 小时后才会在 cdn 上生效，需谨慎操作。

### **使用案例**

  1. 若期望对图片进行[缩略处理 __](https://developer.qiniu.com/dora/1279/basic-processing-images-imageview2)，如指定长短边缩略剪裁方式为：缩至指定长短边区域内（长边最多为 48px，短边最多为 48px），将生成如下指令代码作为图片样式的具体样式内容：`imageView2/0/w/48/h/48`。
  2. 将该图片样式命名为 `imageFop`，并指定样式分隔符为 `-`。  
图片样式预览效果如下：  
![image.png](https://dn-odum9helk.qbox.me/FgZ8U6D95FVHqx6PNofT4DdMYWdM)

  3. 原始图片链接 `http://dn-odum9helk.qbox.me/qiniu-picture1.jpg`。
  4. 将原图链接使用样式分隔符 `-` 拼接图片样式名 `imageFop`，即访问 `http://dn-odum9helk.qbox.me/qiniu-picture1.jpg-imageFop` 便可直接获得缩放效果图。

# **处理功能**

图片处理 | 参数 | 简介  
---|---|---  
[图片瘦身](https://developer.qiniu.com/dora/api/1271/image-thin-body-imageslim) | imageslim | 将存储在七牛的JPEG、PNG格式的图片实时压缩而尽可能不影响画质。  
[图片基本处理](https://developer.qiniu.com/dora/api/1279/basic-processing-images-imageview2) | imageView2 | 可对图片进行缩略操作，生成各种缩略图。imageView2 接口可支持处理的原图片格式有 psd、jpeg、png、gif、webp、tiff、bmp。  
[图片高级处理- 缩放](https://developer.qiniu.com/dora/api/8255/the-zoom) | thumbnail | 将图片缩放至指定大小。  
[图片高级处理- 裁剪](https://developer.qiniu.com/dora/api/8256/tailoring) | crop | 普通裁剪、缩放裁剪  
[图片高级处理- 旋转](https://developer.qiniu.com/dora/api/8257/rotating) | auto-orient   
rotate | 自适应旋转、普通旋转。  
[图片高级处理- 格式转换](https://developer.qiniu.com/dora/api/8258/format-conversion) | format  
colors | 格式转换、GIF 颜色控制。  
[图片高级处理- 渐进显示](https://developer.qiniu.com/dora/api/8260/progressive-shows) | interlace | 将图片调整为渐进显示。  
[图片高级处理- 背景色填充](https://developer.qiniu.com/dora/api/8351/the-background-color-fill) | background | 对图片填充背景颜色  
[图片高级处理- 质量变换](https://developer.qiniu.com/dora/api/8259/the-quality-of-transformation) | q | 对图片质量进行调节  
[图片高级处理- 高斯模糊](https://developer.qiniu.com/dora/api/8261/gaussian-blur) | blur | 对图片进行模糊处理  
[图片基本信息](https://developer.qiniu.com/dora/api/pictures-basic-information-imageinfo) | imageInfo | 可以获取图片格式、大小、色彩模型信息。  
[图片水印处理](https://developer.qiniu.com/dora/api/image-watermarking-processing-watermark) | watermark | 提供四种水印接口：图片水印、文字水印，文字平铺水印、混合水印。  
  
更多图片处理功能，请参考七牛云智能多媒体服务的[图片处理 __](https://developer.qiniu.com/dora/3683/img-
directions-for-use)。

# **操作方式**

Kodo 支持使用命令行辅助工具或通过控制台设置。

支持的操作方式 | 参考文档  
---|---  
控制台 | [设置图片样式](https://developer.qiniu.com/kodo/development_guidelines/8558/set-the-picture-style)  
命令行辅助工具 | [qrsctl 数据处理](https://developer.qiniu.com/kodo/tools/1300/qrsctl#8)  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储原始资源保护

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) >
[数据处理](https://developer.qiniu.com/kodo/development_guidelines/8615/dev-the-
data-processing) > 原始资源保护

#  原始资源保护

最近更新时间: 2024-03-27 11:35:38

原始资源保护是七牛存储针对媒体类原始文件的保护措施。

对整个存储空间内所有的资源生效，开启后，空间内的文件无法直接通过 URL 进行访问，需要配合样式分隔符和样式才能访问。

  * [图片样式](https://developer.qiniu.com/kodo/development_guidelines/8623/dev-the-picture-style)
  * [视频样式](https://developer.qiniu.com/kodo/development_guidelines/12654/video-process)  
  

# **应用场景**

用于控制客户只能访问处理后的资源，如：

  * 对于存储在七牛上的图片和视频资源，只希望客户访问携带水印的图片和视频
  * 对于存储在七牛上的图片资源，进行统一的规格化处理

**特别需要注意的是，原始资源保护是一种空间属性，对整个空间的资源都会生效，因此强烈建议对于开启原始资源保护的空间只存储需要保护的原始图片和视频文件，其他文件使用其他空间存放。**  
  

# **访问方式**

开启原始资源保护后，不能通过如下方式访问:

  * `http://绑定域名/文件key或相对路径`
  * `http://绑定域名/文件key或相对路径?操作符/操作符参数`

可以通过如下方式进行公开访问（其中加号“+”忽略）：

  * `http://绑定域名/文件key或相对路径 + 已设定的样式分隔符 + 已设定的图片样式`

如配置分隔符为 “-”,图片样式名称为 “watermarked.jpg”，则以下形式的链接可以访问

  * `http://(Domain)/(Key)-watermarked.jpg`

如果希望对原始文件进行访问，可以通过[私有链接签名](https://developer.qiniu.com/kodo/development_guidelines/1656/download-
private)的方式，携带鉴权参数访问，但不建议这样使用。  
  

# **操作方式**

Kodo 支持通过控制台或使用命令行辅助工具设置原始资源保护。

支持的操作方式 | 参考文档  
---|---  
控制台 | [设置原始资源保护](https://developer.qiniu.com/kodo/development_guidelines/8560/set-the-original-protection)  
命令行辅助工具 | [qrsctl](https://developer.qiniu.com/kodo/tools/1300/qrsctl) protected 命令  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储传输加速

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) > 传输加速

#  传输加速

最近更新时间: 2024-06-25 10:25:47

如果您希望实现远距离数据传输加速，例如从非中国内地向中国内地的空间请求上传或下载文件，您可以开启传输加速。传输加速利用全球分布的云机房，将全球各地用户对您存储空间的访问，经过智能路由解析至就近的接入点，使用优化后的网络及协议，为云存储互联网的上传、下载提供端到端的加速方案。

# **具体说明**

  * 当前七牛云存储传输加速，仅支持上传链路加速。您可以开启传输加速，使用七牛云提供的传输加速域名做上传，可以为互联网的上传提供端到端的加速效果。通过传输加速域名上传数据时，会产生加速上传流量。更多信息，请参见 [计量项与计费项](https://developer.qiniu.com/kodo/buying_guide/6379/metering-and-billing)。

  * 访问域名。开启传输加速后，您可以通过两种域名访问您空间的文件：

    * **默认源站上传域名** ，格式如 `up-*.qiniup.com` ，详情见 [存储区域](https://developer.qiniu.com/kodo/product_introduction/1671/region-endpoint-fq)，可以指定 HTTP / HTTPS 传输协议。通过该域名上传对象时，您的请求会被直接转发至七牛云对应区域存储机房，如果外网链路长，可能存在传输不稳定的情况；通过该域名上传对象时，不需要收取上传流量费用。
    * **空间级别传输加速域名** ，格式如 `*.kodo-accelerate.*.qiniucs.com`，可以指定 HTTP / HTTPS 传输协议。通过该域名上传对象时，会根据网络状况为您智能解析并就近接入，使用优化后的网络及协议，实现加速的效果。通过该域名上传对象时，会产生加速上传流量。

  

# **使用案例**

  * 跨境数据传输需求  
您的业务场景要求是将文件上传至国内华东-浙江区域，终端对传输成功率要求极高，海量全球分布终端用户每天需要从世界各地，比如新加坡和美国，上传数据到华东-浙江；

  * 大文件传输加速需求  
您的业务场景要求是将音视频文件、高清图片、压缩包等快速高效的上传，需要从办公室每天上传 GB 级别大小的文件上至国内华东-浙江区域

  

# **操作方式**

Kodo 支持使用通过控制台开启 / 关闭传输加速。

支持的操作方式 | 参考文档  
---|---  
控制台 | [设置传输加速](https://developer.qiniu.com/kodo/development_guidelines/12659/set-transfer-acceleration)  
  
  

# **使用方式**

Kodo 支持通过 SDK 、命令行工具、图形化管理工具等使用加速域名。

支持的使用入口 | 具体使用方式 | 详细参考文档  
---|---|---  
控制台 | 上传时指定使用传输加速域名 | 开启传输加速后，即可通过控制台在上传文件时按需选择加速域名上传，参考[上传文件](https://developer.qiniu.com/kodo/development_guidelines/8562/upload-a-file)  
SDK | 指定传输加速域名 | 各 SDK 使用文档，[比如 GO SDK ](https://developer.qiniu.com/kodo/sdk/1238/go) 可以在上传可选配置 `putExtra.UpHost` ，指定上传域名为传输加速域名  
命令行工具 | 配置文件指定传输加速域名或者上传命令指定传输加速域名 | [Qshell 使用文档](https://developer.qiniu.com/kodo/tools/1302/qshell)，比如`fput`的上传命令指定参数 `--up-host`，指定上传域名为传输加速域名  
图形化管理工具 | 配置文件指定传输加速域名 | 能力迭代中  
  
  

# **测试传输加速效果**

  * 您可以通过 [上传测速工具](https://developer.qiniu.com/kodo/tools/2528/upload-webtest) 测试对比您本地访问七牛存储全球各地数据中心时，开启传输加速与未开启传输加速的访问速度；
  * 通过在 Qshell 命令对比测试使用默认源站上传域名和传输加速域名上传文件所需时间以及访问速度；  
![1.png](https://dn-odum9helk.qbox.me/Fu2AhAGWi3YG4SHLP7aLmMZFAJNZ)

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储AWS S3 兼容

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) > AWS S3 兼容

#  AWS S3 兼容

最近更新时间: 2020-12-28 20:15:29

为了使众多基于AWS S3接口协议开发的各类应用及服务能够轻便的接入七牛对象存储，七牛对象存储兼容了AWS
S3常用接口。接口的具体兼容情况，在下文中做了详细叙述。

七牛云存储兼容S3协议接口，是为了尽可能的方便基于 AWS S3
而开发的应用接入到七牛对象存储。如果您刚刚开始着手开发新的应用，为了更好的使用七牛对象存储丰富的产品功能，更推荐使用原生接口进行开发。

  * [存储类型](https://developer.qiniu.com/kodo/manual/5906/storage-type)
  * [服务域名](https://developer.qiniu.com/kodo/manual/4088/s3-access-domainname)
  * [签名认证](https://developer.qiniu.com/kodo/manual/4093/s3-authentication)
  * [临时安全凭证](https://developer.qiniu.com/kodo/manual/5914/s3-compatible-sts)
  * [兼容公共头](https://developer.qiniu.com/kodo/manual/4091/s3-compatible-header)
  * [兼容API](https://developer.qiniu.com/kodo/manual/4087/compatible-s3-api)
  * [兼容工具示例](https://developer.qiniu.com/kodo/manual/4096/s3-compatible-sdk)

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储存储类型

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) > [AWS S3
兼容](https://developer.qiniu.com/kodo/development_guidelines/4086/aws-s3-compatible)
> 存储类型

#  存储类型

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

七牛对象存储支持标准（STANDARD）、低频访问（LINE）、归档直读（GLACIER_IR）、归档（GLACIER）、深度归档（DEEP_ARCHIVE）五种存储类型。

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储服务域名

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) > [AWS S3
兼容](https://developer.qiniu.com/kodo/development_guidelines/4086/aws-s3-compatible)
> 服务域名

#  服务域名

最近更新时间: 2024-08-20 14:49:38

# 服务域名

您可使用如下服务域名通过 AWS S3 协议访问七牛云对象存储：

存储区域 | 区域简称 Region ID | 访问 Endpoint | 协议  
---|---|---|---  
华东-浙江 | cn-east-1 | s3.cn-east-1.qiniucs.com | HTTP，HTTPS  
华东-浙江2 | cn-east-2 | s3.cn-east-2.qiniucs.com | HTTP，HTTPS  
华北-河北 | cn-north-1 | s3.cn-north-1.qiniucs.com | HTTP，HTTPS  
华南-广东 | cn-south-1 | s3.cn-south-1.qiniucs.com | HTTP，HTTPS  
北美-洛杉矶 | us-north-1 | s3.us-north-1.qiniucs.com | HTTP，HTTPS  
亚太-新加坡（原东南亚） | ap-southeast-1 | s3.ap-southeast-1.qiniucs.com | HTTP，HTTPS  
亚太-河内 | ap-southeast-2 | s3.ap-southeast-2.qiniucs.com | HTTP，HTTPS  
亚太-胡志明 | ap-southeast-3 | s3.ap-southeast-3.qiniucs.com | HTTP，HTTPS  
  
_注意：暂不支持通过以上服务域名匿名访问七牛云存储，必须携带**[AWS
Signature](https://developer.qiniu.com/kodo/manual/4093/s3-authentication.md)**
。_  
  

# 访问方式

七牛对象存储兼容 AWS S3 的 path-style 和 bucket virtual hosting 两种访问方式，以 GetObject 为例

风格 | 示例  
---|---  
Path Style | `http://s3.cn-east-1.qiniucs.com/<S3 空间名>/objectname`  
Virtual-host Style | `http://<S3 空间名>.s3.cn-east-1.qiniucs.com/objectname`  
  
其中 S3 空间名的获取，需参考下述说明。  
  

# 获取七牛 S3 空间名

S3 空间名：全局唯一（遵循 S3 协议的要求）

  * 空间名称全局唯一时，S3 空间名=空间名称；空间名称全局不唯一时，系统会为空间自动生成一个 S3 空间名
  * 七牛对象存储空间的 S3 空间名，可以通过 [Get Service](https://developer.qiniu.com/kodo/manual/4087/compatible-s3-api#service-operation) 接口获取，也可在 [产品服务-对象存储-空间管理-空间概览 __](https://portal.qiniu.com/kodo/bucket)中查看

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储签名认证

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) > [AWS S3
兼容](https://developer.qiniu.com/kodo/development_guidelines/4086/aws-s3-compatible)
> 签名认证

#  签名认证

最近更新时间: 2020-12-28 20:14:51

同时兼容AWS Signature Version 2 和 AWS Signature Version 4，均实现了请求头签名和参数签名方式。AWS
Signature V2 签名方法请查阅  
[Signing and Authenticating REST Requests
__](https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html)，
AWS Signature V4 签名方法请查阅[Authenticating Requests (AWS Signature Version
4)__](https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-
requests.html)。

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储临时安全凭证

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) > [AWS S3
兼容](https://developer.qiniu.com/kodo/development_guidelines/4086/aws-s3-compatible)
> 临时安全凭证

#  临时安全凭证

最近更新时间: 2020-12-28 20:14:39

兼容 AWS Security Token Service (STS) 的联合身份临时安全凭证 (federation token) ，更多详细信息请查阅
[AWS 临时安全凭证
__](https://docs.aws.amazon.com/zh_cn/IAM/latest/UserGuide/id_credentials_temp_request.html#api_getfederationtoken)。

# **兼容API**

STS API | 请求兼容描述 | 响应兼容描述  
---|---|---  
GetFederationToken | 未支持请求参数 PolicyArns.member.N | 未支持响应参数 PackedPolicySize  
  
请求参数中的 Policy 结构与 S3 一致，对于策略中的 Action 元素，目前已经兼容的包括：

  * s3:CreateBucket
  * s3:ListBucket
  * s3:DeleteBucket
  * s3:GetBucketLocation
  * s3:ListAllMyBuckets
  * s3:DeleteObject
  * s3:PutObject
  * s3:GetObject
  * s3:AbortMultipartUpload
  * s3:ListMulitpartUploadParts

您也可以使用通配符 “*” 或 “S3:*” 表示任意操作。关于 Policy 更多内容请查阅[会话策略
__](https://docs.aws.amazon.com/zh_cn/IAM/latest/UserGuide/access_policies.html#policies_session)。

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储兼容公共头

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) > [AWS S3
兼容](https://developer.qiniu.com/kodo/development_guidelines/4086/aws-s3-compatible)
> 兼容公共头

#  兼容公共头

最近更新时间: 2020-12-28 20:14:30

# **公共请求头**

AWS S3 请求头 | 说明  
---|---  
Authorization | 兼容  
Content-Length | 兼容  
Content-Type | 兼容  
Content-MD5 | 兼容  
Date | 兼容  
Expect | 兼容  
Host | 兼容  
x-amz-content-sha256 | 兼容  
x-amz-date | 兼容  
x-amz-security-token | 不兼容  
  
# **公共响应头**

AWS S3 请求头 | 说明  
---|---  
Content-Length | 兼容  
Content-Type | 兼容  
Connection | 兼容  
Date | 兼容  
ETag | 兼容  
Server | 兼容  
x-amz-delete-marker | 暂不支持  
x-amz-request-id | 兼容  
x-amz-id-2 | 不兼容  
x-amz-version-id | 暂不支持  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储兼容 SDK 示例

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) > [AWS S3
兼容](https://developer.qiniu.com/kodo/development_guidelines/4086/aws-s3-compatible)
> 兼容 SDK 示例

#  兼容 SDK 示例

最近更新时间: 2023-12-28 18:27:25

对大多数基于 AWS S3 的 SDK 开发工具包，进行如下改动即可访问七牛云对象存储 Kodo：

  * 获取七牛云账号的 AccessKey 和 SecretKey，在您使用的 SDK 中配置七牛云的 AccessKey 和 SecretKey
  * 设置 SDK 连接的 Region 及 Endpoint 分别为七牛云对象存储的 S3 Region ID 和 访问 Endpoint，可以参考[服务域名 __](https://developer.qiniu.com/kodo/4088/s3-access-domainname)

只要涉及的接口实现了兼容，即可在 SDK 中使用对应的功能、对接七牛云对象存储。  
  

AWS S3 各语言 SDK 对接七牛云对象存储的方式，参考：

使用说明  
---  
[AWS SDK for
C++](https://developer.qiniu.com/kodo/development_guidelines/12554/aws-sdk-
cpp-examples)  
[AWS SDK for .NET
(C#)](https://developer.qiniu.com/kodo/development_guidelines/12555/aws-sdk-
csharp-examples)  
[AWS SDK for
Go](https://developer.qiniu.com/kodo/development_guidelines/12556/aws-sdk-go-
examples)  
[AWS SDK for
Java](https://developer.qiniu.com/kodo/development_guidelines/12557/aws-sdk-
java-examples)  
[AWS SDK for
JavaScript](https://developer.qiniu.com/kodo/development_guidelines/12558/aws-
sdk-javascript-examples)  
[AWS SDK for
Kotlin](https://developer.qiniu.com/kodo/development_guidelines/12559/aws-sdk-
kotlin-examples)  
[AWS SDK for
PHP](https://developer.qiniu.com/kodo/development_guidelines/12562/aws-sdk-
php-examples)  
[AWS SDK for
Python](https://developer.qiniu.com/kodo/development_guidelines/12563/aws-sdk-
python-examples)  
[AWS SDK for
Ruby](https://developer.qiniu.com/kodo/development_guidelines/12571/aws-sdk-
ruby-examples)  
[AWS SDK for
Rust](https://developer.qiniu.com/kodo/development_guidelines/12572/aws-sdk-
rust-examples)  
[AWS SDK for
Swift](https://developer.qiniu.com/kodo/development_guidelines/12573/aws-sdk-
swift-examples)  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储兼容工具示例

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) > [AWS S3
兼容](https://developer.qiniu.com/kodo/development_guidelines/4086/aws-s3-compatible)
> 兼容工具示例

#  兼容工具示例

最近更新时间: 2023-12-28 18:27:49

对大多数基于 AWS S3 的工具，进行如下改动即可访问七牛云对象存储 Kodo：

  * 获取七牛云账号的 AccessKey 和 SecretKey，在您使用的工具中配置七牛云的 AccessKey 和 SecretKey
  * 设置工具连接的 Region 及 Endpoint 分别为七牛云对象存储的 S3 Region ID 和 访问 Endpoint，可以参考[服务域名 __](https://developer.qiniu.com/kodo/4088/s3-access-domainname)

只要涉及的接口实现了兼容，即可在工具中使用对应的功能、对接七牛对象存储。  
  

各工具对接七牛云对象存储的方式，参考：

使用说明  
---  
[AWS CLI](https://developer.qiniu.com/kodo/development_guidelines/12574/aws-
cli-examples)  
[CloudBerry
Explorer](https://developer.qiniu.com/kodo/development_guidelines/12576/cloud-
berry-explorer-examples)  
[S3
Browser](https://developer.qiniu.com/kodo/development_guidelines/12577/s3-browser-
examples)  
[S3FS](https://developer.qiniu.com/kodo/development_guidelines/12578/s3fs-
examples)  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储AWS CLI

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) > [AWS S3
兼容](https://developer.qiniu.com/kodo/development_guidelines/4086/aws-s3-compatible)
>
[兼容工具示例](https://developer.qiniu.com/kodo/development_guidelines/4096/s3-compatible-
sdk) > AWS CLI

#  AWS CLI

最近更新时间: 2023-12-28 18:02:33

AWS Command Line Interface (AWS CLI) 是一种开源工具，让您能够在命令行 Shell 中使用命令与 AWS
服务进行交互。通过配置，您可以使用 AWS CLI 管理您在七牛云对象存储的资源。

参考官方介绍：[AWS CLI
__](https://docs.aws.amazon.com/zh_cn/cli/latest/userguide/cli-chap-
welcome.html)

# 安装 AWS CLI

确保 Python v3.8 或更新版本已经安装。

安装 AWS CLI，以 Linux amd64 为例

    
    
    curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
    unzip awscliv2.zip
    sudo ./aws/install
    

然后安装插件便于设置 AWS CLI 使用七牛 S3 域名

    
    
    sudo pip3 install awscli-plugin-endpoint
    

配置 AWS CLI

编写 `~/.aws/credentials`

    
    
    [default]
    aws_access_key_id = <QiniuAccessKey>
    aws_secret_access_key = <QiniuSecretKey>
    

编写 `~/.aws/config`

    
    
    [default]
    region = cn-east-1
    s3 =
        endpoint_url = https://s3.cn-east-1.qiniucs.com
    [plugins]
    endpoint = awscli_plugin_endpoint
    

需要注意，这里的 `region` 和 `endpoint_url` 都可以按照实际使用需求来调整区域 ID 和区域终端 URL。

# 使用 AWS CLI 案例

## 列举 BUCKETS

    
    
    aws s3 ls
    

## 创建 BUCKET

    
    
    aws s3 mb "s3://<NewBucketName>"
    

## 列举 OBJECTS

    
    
    aws s3 ls "<Bucket>/"
    aws s3 ls "<Bucket>/<Prefix>/"
    

## 签发 URL

    
    
    aws s3 presign "s3://<Bucket>/<Prefix>/<FileName>"
    

## 上传文件

    
    
    aws s3 cp "<LocalPath>" "s3://<Bucket>/<DestPrefix>/"
    aws s3 sync "<LocalPath>" "s3://<Bucket>/<DestPrefix>/"
    

## 下载文件

    
    
    aws s3 cp "s3://<Bucket>/<SrcPrefix>/<FileName>" "<LocalDestPath>"
    aws s3 sync "s3://<Bucket>/<SrcPrefix>/<FileName>" "<LocalDestPath>"
    

## 复制文件

    
    
    aws s3 cp "s3://<SrcBucket>/<SrcPrefix>/<SrcFileName>" "s3://<DestBucket>/<DestPrefix>/<DestFileName>"
    

## 复制目录

    
    
    aws s3 cp --recursive "s3://<SrcBucket>/<SrcPrefix>/" "s3://<DestBucket>/<DestPrefix>/"
    aws s3 sync "s3://<SrcBucket>/<SrcPrefix>/" "s3://<DestBucket>/<DestPrefix>/"
    

## 移动文件

    
    
    aws s3 mv "s3://<SrcBucket>/<SrcPrefix>/<SrcFileName>" "s3://<DestBucket>/<DestPrefix>/<DestFileName>"
    

## 移动目录

    
    
    aws s3 mv --recursive "s3://<SrcBucket>/<SrcPrefix>/" "s3://<DestBucket>/<DestPrefix>/"
    

## 删除文件

    
    
    aws s3 rm "s3://<Bucket>/<Prefix>/<FileName>"
    

## 删除目录

    
    
    aws s3 rm --recursive "s3://<Bucket>/<Prefix>/"
    

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储CloudBerry Explorer

gpt: [对象存储](https://developer.qiniu.com/kodo) > 使用指南 >
[开发指南](https://developer.qiniu.com/kodo/development_guidelines/8596/development-
guidelines) > [AWS S3
兼容](https://developer.qiniu.com/kodo/development_guidelines/4086/aws-s3-compatible)
>
[兼容工具示例](https://developer.qiniu.com/kodo/development_guidelines/4096/s3-compatible-
sdk) > CloudBerry Explorer

#  CloudBerry Explorer

最近更新时间: 2023-12-28 18:02:46

CloudBerry Explorer 是一个图形化数据管理工具，支持您在跨本地存储和您选择的云存储之间进行访问、移动和管理文件。通过配置，您可以使用
CloudBerry Explorer 管理您在七牛云对象存储的资源。此工具支持在 Windows 和 MacOS 系统使用。

参考官方介绍：[CloudBerry Explorer __](https://www.msp360.com/explorer/)

# 安装 CloudBerry Explorer

下载并安装 [CloudBerry Explorer __](https://www.msp360.com/explorer/windows/)

# 配置 CloudBerry Explorer

打开 CloudBerry Explorer

![1.png](https://dn-odum9helk.qbox.me/Fi2UnuLmSR2XKoFkML91SLffnCji)

选择标题栏中的 File，选择 Add New Account

![2.png](https://dn-odum9helk.qbox.me/FiD2l1m4CIPCP96sZWZ_5kkBsa3c)

双击 S3 Compatible

![3.png](https://dn-odum9helk.qbox.me/FnD-QvvyDjTcrACV7pht_JVlyKFQ)

打开 S3 Compatible 账户配置对话框，添加新的 S3 Compatible 的账号。

![4.png](https://dn-odum9helk.qbox.me/FnycRv_lU6xAHQ7uGscYWqX9QMaG)

其中，Display name 可以自定义填写，如 Qiniu。Service point 填写为七牛云对象存储的 S3 服务地址，参考 [服务域名
__](https://developer.qiniu.com/kodo/4088/s3-access-domainname)。Access Key 和
Secret Key 填写七牛云账户的 AK/SK，Signature version 选 4。点击 “Test Connection”，显示
“Connection Success!” 表示连接成功。

![5.png](https://dn-odum9helk.qbox.me/FkOg-VTW4cArlV054mTBEe4h9VoK)

关闭账户配置对话框后，可以在 Source 内选择刚刚配置的账户，与本机或其他账户之间传输文件。  
支持选择指定文件或文件夹 Copy 或 Move 到目标位置。  
![6.png](https://dn-odum9helk.qbox.me/FhVR-W2NfdFpadiSGOxxbmasYb8O)

![7.png](https://dn-odum9helk.qbox.me/FqzRR1Vwngd-8DHVOupaVfwgrWSr)

注：CloudBerry Explorer for Amazon S3 对 S3 Compatible 和 Amazon S3
两种配置的云存储支持的功能本身就有区别，如生命周期、加密等均不支持。

以上内容是否对您有帮助？