jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的对象存储资源复制

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > [Object
接口](https://developer.qiniu.com/kodo/api/1274/rs) > 资源复制

#  资源复制

最近更新时间: 2023-03-02 18:58:09

# **描述**

本接口用于将指定文件复制为新命名文件。  
  

# **请求**

### **请求语法**

    
    
    POST /copy/<EncodedEntryURISrc>/<EncodedEntryURIDest>/force/<true|false> 
    HTTP/1.1
    Host:           rs.qiniuapi.com
    Content-Type:   application/x-www-form-urlencoded
    X-Qiniu-Date: 20060102T150405Z
    Authorization:  Qiniu <AccessToken>
    

使用说明：

  * 源空间和目标空间必须属于相同账号，跨账号复制文件不支持。
  * 文件不支持跨存储区域复制。
  * 归档/深度归档存储文件，只有解冻状态时可以复制。copy 获得的目标文件为冻结状态。  
  

### **请求参数**

参数名称 | 必填 | 说明  
---|---|---  
EncodedEntryURISrc | 是 | 源文件，需要经过 Base64 编码，具体请参考[EncodedEntryURI](https://developer.qiniu.com/kodo/api/1276/data-format)  
EncodedEntryURIDest | 是 | 目标文件，需要经过 Base64 编码，具体请参考[EncodedEntryURI](https://developer.qiniu.com/kodo/api/1276/data-format)  
force | 否 | bool 类型，默认 false。如果目标文件名已被占用，则返回错误码 614，且不做任何覆盖操作；如果指定为 true，会强制覆盖目标文件  
  
  

### **请求头**

头部名称 | 必填 | 说明  
---|---|---  
`Authorization` | 是 | 该参数应严格按照[管理凭证](https://developer.qiniu.com/kodo/manual/1201/access-token)格式进行填充，否则会返回 401 错误码一个合法的 Authorization 值应类似于：`Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7...`  
其他 |  | 该请求操作的实现使用了所有操作的公共请求头。详情请查阅[公共请求头](https://developer.qiniu.com/kodo/api/3924/common-request-headers)  
  
  

### **请求内容**

该请求操作的请求体为空。  
  

# **响应**

### **响应语法**

    
    
    HTTP/1.1 200 OK
    Content-Type: application/json
    Cache-Control: no-store
    

### **响应头**

头部名称 | 必填 | 说明  
---|---|---  
Content-Type | 是 | 正常情况下该值将被设为 `application/json`，表示返回 JSON 格式的文本信息。  
其他 |  | 该请求操作的实现使用了所有操作的公共响应头。详情请查阅[公共响应头](https://developer.qiniu.com/kodo/api/3924/common-request-headers)。  
  
  

### **响应内容**

如果请求成功，不返回任何内容。  
如果请求失败，返回包含如下内容的 JSON 字符串（已格式化，便于阅读）：

    
    
    {
        "error":   "<errMsg    string>",
    }
    

字段名称 | 必填 | 说明  
---|---|---  
error | 是 | 与 HTTP 状态码对应的消息文本  
  
  

### **响应状态码**

HTTP状态码 | 含义  
---|---  
200 | 复制成功  
400 | 请求报文格式错误  
401 | 管理凭证无效  
403 | 禁止操作  
当归档存储文件未解冻完成时调用接口会返回`403 ArchiveUnrestored {"error":"archive unrestored"}`  
当深度归档存储文件未解冻完成时调用接口会返回`403 DeepArchiveUnrestored {"error":"deep archive
unrestored"}`  
599 | 服务端操作失败  
612 | 待复制文件不存在  
614 | 目标文件已存在  
其他错误码 | 请查阅[错误响应](https://developer.qiniu.com/kodo/api/3928/error-responses)  
  
如遇599错误，请将完整错误信息（包括所有HTTP响应头部）[提交工单
__](https://support.qiniu.com/tickets/category)给我们。

  

# **示例**

### **请求示例**

    
    
    POST /copy/bmV3ZG9jczpmaW5kX21hbi50eHQ=/bmV3ZG9jczpmaW5kLm1hbi50eHQ= HTTP/1.1
    User-Agent: curl/7.30.0
    Host: rs.qinuapi.com
    Accept: */*
    X-Qiniu-Date: 20060102T150405Z
    Authorization: Qiniu u8WqmQu1jH21kxpIQmo2LqntzugM1VoHE9_pozCU:2LJIG...(过长已省略)
    

_注: 要在`Authorization`头部的`<AccessToken>`前添加`Qiniu`和半角空格。_  
  

### **响应示例**

    
    
    HTTP/1.1 200 OK
    Server: nginx/1.0.8
    Date: Mon, 02 Jan 2006 15:04:05 GMT
    Content-Type: application/json
    Connection: keep-alive
    Content-Length: 0
    X-Reqid: wxIAAD3btw-v3TwT
    

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

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > [Object
接口](https://developer.qiniu.com/kodo/api/1274/rs) > 资源删除

#  资源删除

最近更新时间: 2023-03-02 18:58:19

# **描述**

本接口用于删除指定文件。  
  

# **请求**

### **请求语法**

    
    
    POST /delete/<EncodedEntryURI> HTTP/1.1
    Host:           rs.qiniuapi.com
    Content-Type:   application/x-www-form-urlencoded
    X-Qiniu-Date: 20060102T150405Z
    Authorization:  Qiniu <AccessToken>
    

  

### **请求参数**

参数名称 | 必填 | 说明  
---|---|---  
EncodedEntryURI | 是 | 指定文件信息，详情请参考[EncodedEntryURI](https://developer.qiniu.com/kodo/api/1276/data-format)  
  
  

### **请求头**

头部名称 | 必填 | 说明  
---|---|---  
`Authorization` | 是 | 该参数应严格按照[管理凭证](https://developer.qiniu.com/kodo/manual/1201/access-token)格式进行填充，否则会返回401错误码一个合法的Authorization值应类似于：`Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7...`  
其他 |  | 该请求操作的实现使用了所有操作的公共请求头。详情请查阅[公共请求头](https://developer.qiniu.com/kodo/api/3924/common-request-headers)  
  
  

# 响应

## 响应语法

    
    
    HTTP/1.1 200 OK
    Content-Type: application/json
    Cache-Control: no-store
    

### **响应头**

头部名称 | 必填 | 说明  
---|---|---  
Content-Type | 是 | 正常情况下该值将被设为 `application/json`，表示返回 JSON 格式的文本信息。  
其他 |  | 其它可能返回的头部信息，请参考[公共响应头](https://developer.qiniu.com/kodo/api/3924/common-request-headers)。  
  
  

### **响应内容**

如果请求成功，不返回任何内容。  
如果请求失败，返回包含如下内容的 JSON 字符串（已格式化，便于阅读）：

    
    
    {
        "error":   "<errMsg    string>",
    }
    

字段名称 | 必填 | 说明  
---|---|---  
error | 是 | 与 HTTP 状态码对应的消息文本  
  
  

### **响应状态码**

HTTP状态码 | 含义  
---|---  
200 | 删除成功  
400 | 请求报文格式错误  
401 | 管理凭证无效  
599 | 服务端操作失败  
612 | 待删除文件不存在  
其他错误码 | 请查阅[错误响应](https://developer.qiniu.com/kodo/api/3928/error-responses)  
  
如遇599错误，请将完整错误信息（包括所有HTTP响应头部）[提交工单
__](https://support.qiniu.com/tickets/category)给我们。  
  

# **示例**

## 请求示例

    
    
    POST /delete/bmV3ZG9jczpmaW5kX21hbi50eHQ= HTTP/1.1
    User-Agent: curl/7.30.0
    Host: rs.qiniuapi.com
    Accept: */*
    X-Qiniu-Date: 20060102T150405Z
    Authorization: Qiniu u8WqmQu1jH21kxpIQmo2LqntzugM1VoHE9_pozCU:2LJIG...(过长已省略)
    

_注：要在`Authorization`头部的`<AccessToken>`前添加`Qiniu`和半角空格。_  
  

### **响应示例**

    
    
    HTTP/1.1 200 OK
    Server: nginx/1.0.8
    Date: Mon, 02 Jan 2006 15:04:05 GMT
    Content-Type: application/json
    Connection: keep-alive
    Content-Length: 0
    X-Reqid: wxIAAD3btw-v3TwT
    

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储修改文件状态

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > [Object
接口](https://developer.qiniu.com/kodo/api/1274/rs) > 修改文件状态

#  修改文件状态

最近更新时间: 2023-03-02 18:59:11

# **描述**

本接口用于修改文件的存储状态，即禁用和启用状态间的的互相转换。  
处于禁用状态的文件将只能通过签发 Token 的方式访问
[下载凭证](https://developer.qiniu.com/kodo/manual/1202/download-token)。  
  

# **请求**

### **请求语法**

    
    
    POST /chstatus/<EncodedEntryURI>/status/<status> HTTP/1.1
    Host:           rs.qiniuapi.com
    Content-Type:   application/x-www-form-urlencoded
    X-Qiniu-Date: 20060102T150405Z
    Authorization:  Qiniu <AccessToken>
    

  

### **请求参数**

参数名称 | 必填 | 说明  
---|---|---  
EncodedEntryURI | 是 | 指定文件信息，详情请参考[EncodedEntryURI](https://developer.qiniu.com/kodo/api/1276/data-format)  
status | 是 | 值为数字，0表示启用，1表示禁用  
  
  

### **请求头**

头部名称 | 必填 | 说明  
---|---|---  
Authorization | 是 | 该参数应严格按照[管理凭证](https://developer.qiniu.com/kodo/manual/1201/access-token)格式进行填充，否则会返回 401 错误码一个合法的 Authorization 值应类似于：`Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7...`  
其他 |  | 请查阅[公共请求头](https://developer.qiniu.com/kodo/api/3924/common-request-headers)  
  
  

### **请求内容**

该请求操作的请求体为空。  
  

# **响应**

### **响应语法**

    
    
    HTTP/1.1 200 OK
    Content-Type: application/json
    Cache-Control: no-store
    

### **响应头**

头部名称 | 必填 | 说明  
---|---|---  
Content-Type | 是 | 正常情况下该值将被设为 `application/json`，表示返回 JSON 格式的文本信息。  
其他 |  | 其它可能返回的头部信息，请参考[公共响应头](https://developer.qiniu.com/kodo/api/3924/common-request-headers)。  
  
  

### **响应内容**

如果请求成功，不返回任何内容。  
如果请求失败，返回包含如下内容的 JSON 字符串（已格式化，便于阅读）：

    
    
    {
        "error":   "<errMsg    string>",
    }
    

字段名称 | 必填 | 说明  
---|---|---  
error | 是 | 与 HTTP 状态码对应的消息文本  
  
  

### **响应状态码**

HTTP状态码 | 含义  
---|---  
200 | 更改成功  
400 | 请求报文格式错误  
当`<EncodedEntryURI>`解析失败，返回 `400 Bad Request {"error":"invalid argument"}`  
当`<EncodedEntryURI>`不符合 UTF-8 编码，返回 `400 Bad Request {"error":"key must be
utf8 encoding"}`  
当文件当前状态和设置的状态已经一致，返回 `{"error":"already enabled"}` 或 `{"error":"already
disabled"}`  
401 | 管理凭证无效  
612 | 目标文件不存在  
599 | 服务端操作失败  
其他错误码 | 请查阅[错误响应](https://developer.qiniu.com/kodo/api/3928/error-responses)  
  
如遇 599 错误，请将完整错误信息（包括所有 HTTP 响应头部）[提交工单
__](https://support.qiniu.com/tickets/category)给我们。  
  

# **示例**

### **请求示例**

    
    
    POST /chstatus/aXRpc2F0ZXN0OmdvZ29waGVyLmpwZw==/status/1 HTTP/1.1
    User-Agent: curl/7.30.0
    Host: rs.qiniuapi.com
    X-Qiniu-Date: 20060102T150405Z
    Authorization: Qiniu bt500PzCG9tV0bccCOdnrmCHPXCPLieGSDEprB7M:4wG...(过长已省略)
    

_注：要在`Authorization`头部的`<AccessToken>`前添加`Qiniu`和半角空格。_  
  

### **响应示例**

    
    
    HTTP/1.1 200 OK
    Server: nginx/1.4.4
    Date: Mon, 02 Jan 2006 15:04:05 GMT
    Content-Type: application/json
    Content-Length: 0
    Connection: keep-alive
    X-Reqid: vDEAAG2lN7zSqpQT
    

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储解冻归档/深度归档存储文件

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > [Object
接口](https://developer.qiniu.com/kodo/api/1274/rs) > 解冻归档/深度归档存储文件

#  解冻归档/深度归档存储文件

最近更新时间: 2023-03-02 18:59:42

# **描述**

本接口用于解冻归档/深度归档存储类型的文件，可设置解冻有效期1～7天。  
归档存储文件完成解冻通常需要1～5分钟，深度归档存储文件完成解冻需要5～12小时。  
  

# **请求**

### **请求语法**

    
    
    POST /restoreAr/<EncodedEntryURI>/freezeAfterDays/<FreezeAfterDays> HTTP/1.1
    Host:           rs.qiniuapi.com
    Content-Type:   application/x-www-form-urlencoded
    X-Qiniu-Date: 20060102T150405Z
    Authorization:  Qiniu <AccessToken>
    

  

### **请求参数**

参数名称 | 必填 | 说明  
---|---|---  
EncodedEntryURI | 是 | 指定文件信息，详情请参考 [EncodedEntryURI](https://developer.qiniu.com/kodo/api/1276/data-format)  
FreezeAfterDays | 是 | 解冻有效时长，取值范围 1～7  
  
  

### **请求头**

头部名称 | 必填 | 说明  
---|---|---  
Authorization | 是 | 该参数应严格按照[管理凭证](https://developer.qiniu.com/kodo/manual/1201/access-token)格式进行填充，否则会返回 401 错误码一个合法的 Authorization 值应类似于：`Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7...`  
其他 |  | 请查阅[公共请求头](https://developer.qiniu.com/kodo/api/3924/common-request-headers)  
  
  

### **请求内容**

该请求操作的请求体为空。  
  

# **响应**

### **响应头**

头部名称 | 必填 | 说明  
---|---|---  
Content-Type | 是 | 正常情况下该值将被设为 `application/json`，表示返回 JSON 格式的文本信息。  
其他 |  | 其它可能返回的头部信息，请参考[公共响应头](https://developer.qiniu.com/kodo/api/3924/common-request-headers)。  
  
  

### **响应内容**

如果请求成功，不返回任何内容。  
如果请求失败，返回包含如下内容的 JSON 字符串（已格式化，便于阅读）：

    
    
    {
        "error":   "<errMsg    string>",
    }
    

字段名称 | 必填 | 说明  
---|---|---  
error | 是 | 与 HTTP 状态码对应的消息文本  
  
  

### **响应状态码**

HTTP状态码 | 含义  
---|---  
200 | 更改成功  
400 | 请求报文格式错误  
当 `Bucket` 为空时，返回 `400 Bad Request {"error":"invalid argument"}`  
当 `Object` 不符合 UTF-8 编码，返回 `400 Bad Request {"error":"key must be utf8
encoding"}`  
当 `Object` 已经处于解冻状态时，返回 `400 Bad Request {"error":"archive already restored"}`  
当 `<FreezeAfterDays>` 不符合要求时，返回 `400 Bad Request {"error":"invalid freeze
after days"}`  
401 | 管理凭证无效  
403 | 禁止操作  
当非归档/深度归档存储类型 Object 调用此接口时，返回 `403 Fobbiden {"error": "operation only allowed
for archive or deep archive"}`  
612 | 目标资源不存在  
599 | 服务端操作失败  
其他错误码 | 请查阅[错误响应](https://developer.qiniu.com/kodo/api/3928/error-responses)  
  
如遇 599 错误，请将完整错误信息（包括所有 HTTP 响应头部）[提交工单
__](https://support.qiniu.com/tickets/category)给我们。  
  

# **示例**

### **请求示例**

    
    
    POST /restoreAr/YnVja2V0LW1rdDNqbGNtemsyc2V2N3Rlb2ZjOktPRE8tS0VZLVRFU1QtYXJjaGl2ZS1UYmNZUEN0c3Ay/freezeAfterDays/1  HTTP/1.1
    Host: rs.qiniuapi.com
    User-Agent: Go-http-client/1.1
    X-Qiniu-Date: 20060102T150405Z
    Authorization: Qiniu HwFOxpYCQU6oXoZXFOTh1mq5ZZig6Yyocgk3BTZZ:dkV6wjnPOasNG-WPDvbttUlYWaw=
    Content-Type:   application/x-www-form-urlencoded
    

_注：要在`Authorization` 头部的 `<AccessToken>` 前添加 `Qiniu` 和半角空格。_

  

### **响应示例**

    
    
    HTTP/1.1 200 OK
    Date: Mon, 02 Jan 2006 15:04:05 GMT
    Content-Type: application/json
    Connection: keep-alive
    X-Reqid: ZhUAACe10_2tVfYV
    

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储修改文件过期删除时间

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > [Object
接口](https://developer.qiniu.com/kodo/api/1274/rs) > 修改文件过期删除时间

#  修改文件过期删除时间

最近更新时间: 2023-03-02 18:59:52

# **描述**

本接口用于修改指定资源的过期删除时间。  
修改指定资源生命周期其他时间，比如转低频存储时间和转归档存储时间，请参考
[修改文件生命周期](https://developer.qiniu.com/kodo/api/8062/modify-object-life-
cycle)。后续可以通过 [资源元信息查询](https://developer.qiniu.com/kodo/1308/stat)
查看修改生命周期相关时间。  
  

# **请求**

### **请求语法**

    
    
    POST /deleteAfterDays/<EncodedEntryURI>/<deleteAfterDays> HTTP/1.1
    Host:           rs.qiniuapi.com
    Content-Type:   application/x-www-form-urlencoded
    X-Qiniu-Date: 20060102T150405Z
    Authorization:  Qiniu <AccessToken>
    

使用说明：

  * 文件在设置的 `<deleteAfterDays>` 天之后被删除， **删除后不可恢复**

  

### **请求参数**

参数名称 | 必填 | 说明  
---|---|---  
EncodedEntryURI | 是 | 指定文件信息，详情请参考[EncodedEntryURI](https://developer.qiniu.com/kodo/api/1276/data-format)  
deleteAfterDays | 是 | 值为数字，设置为 0 表示取消过期删除设置  
  
  

### **请求头**

头部名称 | 必填 | 说明  
---|---|---  
Authorization | 是 | 该参数应严格按照[管理凭证](https://developer.qiniu.com/kodo/manual/1201/access-token)格式进行填充，否则会返回 401 错误码一个合法的 Authorization 值应类似于：`Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7...`  
其他 |  | 请查阅[公共请求头](https://developer.qiniu.com/kodo/api/3924/common-request-headers)  
  
  

### **请求内容**

该请求操作的请求体为空。  
  

# **响应**

### **响应语法**

    
    
    HTTP/1.1 200 OK
    Content-Type: application/json
    Cache-Control: no-store
    

  

### **响应头**

头部名称 | 必填 | 说明  
---|---|---  
Content-Type | 是 | 正常情况下该值将被设为 `application/json`，表示返回 JSON 格式的文本信息。  
其他 |  | 其它可能返回的头部信息，请参考[公共响应头](https://developer.qiniu.com/kodo/api/3924/common-request-headers)。  
  
  

### **响应内容**

如果请求成功，不返回任何内容。  
如果请求失败，返回包含如下内容的 JSON 字符串（已格式化，便于阅读）：

    
    
    {
        "error":   "<errMsg    string>",
    }
    

字段名称 | 必填 | 说明  
---|---|---  
error | 是 | 与 HTTP 状态码对应的消息文本  
  
  

### **响应状态码**

HTTP状态码 | 含义  
---|---  
200 | 更新成功  
400 | 请求报文格式错误  
401 | 管理凭证无效  
599 | 服务端操作失败  
612 | 待设置生命周期的资源不存在  
其他错误码 | 请查阅[错误响应](https://developer.qiniu.com/kodo/api/3928/error-responses)  
  
如遇 599 错误，请将完整错误信息（包括所有 HTTP 响应头部）[提交工单
__](https://support.qiniu.com/tickets/category)给我们。

  

# **示例**

### **请求示例**

    
    
    POST /deleteAfterDays/bmV3ZG9jczpmaW5kX21hbi50eHQ=/1 HTTP/1.1
    User-Agent: curl/7.30.0
    Host: rs.qiniuapi.com
    X-Qiniu-Date: 20060102T150405Z
    Accept: */*
    Authorization: Qiniu u8WqmQu1jH21kxpIQmo2LqntzugM1VoHE9_pozCU:2LJIG...(过长已省略)
    

_注：要在`Authorization` 头部的 `<AccessToken>` 前添加 `Qiniu` 和半角空格。_  
  

### **响应示例**

    
    
    HTTP/1.1 200 OK
    Server: nginx/1.0.8
    Date: Mon, 02 Jan 2006 15:04:05 GMT
    Content-Type: application/json
    Connection: keep-alive
    Content-Length: 0
    X-Reqid: wxIAAD3btw-v3TwT
    

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储镜像资源更新

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > [Object
接口](https://developer.qiniu.com/kodo/api/1274/rs) > 镜像资源更新

#  镜像资源更新

最近更新时间: 2023-03-02 19:00:13

# **描述**

对设置了镜像存储的空间，使用本接口将镜像源站抓取指定名称的文件并存储到该空间中。  
如果该空间中已存在该名称的文件，则会将镜像源站的文件覆盖空间中相同名称的文件。  
  

# **请求**

### **请求语法**

    
    
    POST /prefetch/<EncodedEntryURI>
    Host:           iovip-<Region>.qiniuio.com
    Content-Type:   application/x-www-form-urlencoded
    X-Qiniu-Date: 20060102T150405Z
    Authorization:  Qiniu <AccessToken>
    

  

### **请求参数**

参数名称 | 必填 | 说明  
---|---|---  
EncodedEntryURI | 是 | 指定文件信息，详情请参考[EncodedEntryURI](https://developer.qiniu.com/kodo/api/1276/data-format)  
  
  

### **请求头**

头部名称 | 必填 | 说明  
---|---|---  
Host | 是 | `iovip-<Region>.qiniuio.com` 中的 `<Region>` 为七牛各区域 ID，请参考七牛支持的 [区域列表](https://developer.qiniu.com/kodo/1671/region-endpoint-fq)查看具体域名。  
Authorization | 是 | 该参数应严格按照[管理凭证](https://developer.qiniu.com/kodo/manual/1201/access-token)格式进行填充，否则会返回 401 错误码一个合法的 Authorization 值应类似于：`Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7...`  
其他 |  | 请查阅[公共请求头](https://developer.qiniu.com/kodo/api/3924/common-request-headers)  
  
  

### **请求内容**

该请求操作的请求体为空。  
  

# **响应**

### **响应语法**

    
    
    HTTP/1.1 200 OK
    Content-Type: application/json
    Cache-Control: no-store
    

  

### **响应头**

头部名称 | 必填 | 说明  
---|---|---  
Content-Type | 是 | 正常情况下该值将被设为 `application/json`，表示返回 JSON 格式的文本信息。  
其他 |  | 其它可能返回的头部信息，请参考[公共响应头](https://developer.qiniu.com/kodo/api/3924/common-request-headers)。  
  
  

### **响应内容**

如果请求成功，不返回任何内容。  
如果请求失败，返回包含如下内容的 JSON 字符串（已格式化，便于阅读）：

    
    
    {
        "error":   "<errMsg    string>",
    }
    

字段名称 | 必填 | 说明  
---|---|---  
error | 是 | 与 HTTP 状态码对应的消息文本  
  
  

### **响应状态码**

HTTP状态码 | 含义  
---|---  
200 | 抓取成功  
400 | 请求报文格式错误  
401 | 管理凭证无效  
404 | 抓取资源不存在  
478 | 源站返回404外，所有非200的response都返回478。  
599 | 服务端操作失败  
其他错误码 | 请查阅[错误响应](https://developer.qiniu.com/kodo/api/3928/error-responses)  
  
如遇 599 错误，请将完整错误信息（包括所有 HTTP 响应头部）[提交工单
__](https://support.qiniu.com/tickets/category)给我们。

  

# **示例**

### **请求示例**

    
    
    POST /prefetch/bmV3ZG9jczpmaW5kLm1hbi50eHQ= HTTP/1.1
    User-Agent: curl/7.30.0
    Host: iovip.qiniuio.com
    Accept: */*
    X-Qiniu-Date: 20060102T150405Z
    Authorization: Qiniu u8WqmQu1jH21kxpIQmo2LqntzugM1VoHE9_pozCU:2LJIG...(过长已省略)
    

_注：要在`Authorization` 头部的 `<AccessToken>` 前添加 `Qiniu` 和半角空格。_  
  

### **响应示例**

    
    
    HTTP/1.1 200 OK
    Server: nginx/1.0.8
    Date: Mon, 02 Jan 2006 15:04:05 GMT
    Content-Type: application/json
    Connection: keep-alive
    Content-Length: 0
    X-Log: RS.in;RS.mo;qtbl.mv:3;MQ;MC/404;RS.mcd:1;RS:5
    X-Reqid: wxIAAD3btw-v3TwT
    

_注：本接口在执行同步操作时，如果抓取的资源过大或者源站响应过慢，可能会导致超时。_

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储数据统计接口

gpt: [对象存储](https://developer.qiniu.com/kodo) > API 文档 > 数据统计接口

#  数据统计接口

最近更新时间: 2024-08-12 15:23:48

数据统计相关的接口：

接口 | 说明  
---|---  
[space](https://developer.qiniu.com/kodo/api/3908/statistic-space) | 获取标准存储的存储量统计  
[count](https://developer.qiniu.com/kodo/3914/count) | 获取标准存储的文件数量统计  
[space_line](https://developer.qiniu.com/kodo/api/3910/space-line) | 获取低频存储的存储量统计  
[count_line](https://developer.qiniu.com/kodo/api/3915/count-line) | 获取低频存储的文件数量统计  
[space_intelligent_tiering](https://developer.qiniu.com/kodo/api/12755/space-intelligent-tiering) | 获取智能分层存储的存储量统计  
[count_intelligent_tiering](https://developer.qiniu.com/kodo/api/12756/count-intelligent-tiering) | 获取智能分层存储的文件数量统计  
[count_intelligent_tiering_monitor](https://developer.qiniu.com/kodo/api/12757/count-intelligent-tiering-monitor) | 获取智能分层存储的监控文件数  
[space_archive_ir](https://developer.qiniu.com/kodo/api/12613/space-archive-ir) | 获取归档直读存储的存储量统计  
[count_archive_ir](https://developer.qiniu.com/kodo/api/12614/count-archive-ir) | 获取归档直读存储的文件数量统计  
[space_archive](https://developer.qiniu.com/kodo/api/6462/space-archive) | 获取归档存储的存储量统计  
[count_archive](https://developer.qiniu.com/kodo/api/6463/count-archive) | 获取归档存储的文件数量统计  
[space_deep_archive](https://developer.qiniu.com/kodo/api/11180/space-deep-archive) | 获取深度归档存储的存储量统计  
[count_deep_archive](https://developer.qiniu.com/kodo/api/11181/count-deep-archive) | 获取深度归档存储的文件数量统计  
[blob_transfer](https://developer.qiniu.com/kodo/api/3911/blob-transfer) | 获取跨区域同步流量统计  
[rs_chtype](https://developer.qiniu.com/kodo/api/3913/rs-chtype) | 获取存储类型请求次数统计  
[blob_io](https://developer.qiniu.com/kodo/api/3820/blob-io) | 获取外网流出流量统计，CDN回源流出流量统计，数据读取统计， GET请求次数统计  
[rs_put](https://developer.qiniu.com/kodo/api/3912/rs-put) | 获取 PUT 请求次数统计  
  
注：接口提供 2018-01-01 号及之后的数据查询，历史数据默认不提供，如有需要请工单联系我们。

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

gpt: [对象存储](https://developer.qiniu.com/kodo) > 实用工具 > 检测工具 >上传测试页面

#  上传测试页面

最近更新时间: 2023-05-12 14:50:15

# 上传速度检测

  

在遇到上传慢或上传不了问题时，需要用户通过[提交工单
__](https://support.qiniu.com/question)提供有效地信息，发给我们来帮助排查。为了方便用户操作，七牛云提供了简单的
web 端检测工具。

  

# 使用方法

  

打开 [测速页面 __](https://kodo-utils.qiniu.com/upload-test)，选择您指定的区域点击**开始测试**
查看该区域的测速结果。

  * 测试方式：使用指定测速区域七牛云对象存储 Kodo 标准域名向该区域所在空间中，上传大小为 100MB 的文件来进行网络测速。
  * 查看当前七牛云对象存储 Kodo 所支持的[存储区域](https://developer.qiniu.com/kodo/product_introduction/1671/region-endpoint-fq)。

![image.png](https://dn-odum9helk.qbox.me/FmlJh9OpCKQZ2fe8qHvW_7hUfYCw)

  

# 测试结果

![image.png](https://dn-odum9helk.qbox.me/FmO5viBseKeAecz4RLmyfeFdIbPp)

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储网络检测工具 Qwebtest

gpt: [对象存储](https://developer.qiniu.com/kodo) > 实用工具 > 检测工具 >网络检测工具 Qwebtest

#  网络检测工具 Qwebtest

最近更新时间: 2024-01-15 15:07:20

# qwebtest

Qwebtest 是七牛云存储提供的一款检测工具，应用于如下场景：

>
> 遇到了一个奇怪的资源下载或上传问题，您第一时间将现象简单反馈给我们的技术支持，但有时候由于各种不可控的原因（比如提供的信息有限，或者问题重现困难等），问题变得难以排查。

通过在实际环境中模拟上传下载行为，Qwebtest
自动检测、收集与当前网络相关的各种信息，并形成可读的报告。借由这份报告，我们可以更快更准确地排查出问题所在和根本原因，节省用户在客户端花费的排查时间，同时降低在服务端寻找线索的困难度。

# 下载

  * [Windows 32位 __](http://devtools.qiniu.com/windows/386/qwebtest.exe)
  * [Windows 64位 __](http://devtools.qiniu.com/windows/amd64/qwebtest.exe)
  * [Linux 32位 __](http://devtools.qiniu.com/linux/386/qwebtest)
  * [Linux 64位 __](http://devtools.qiniu.com/linux/amd64/qwebtest)
  * [Mac OS __](http://devtools.qiniu.com/darwin/amd64/qwebtest)

# Windows视频教程

[Windows 版视频教程 __](http://7xvilo.com1.z0.glb.clouddn.com/video/official-
tool/qwebtest_video_for_win_web_low.mp4)

# 使用方法

**注意：**Windows 版本的用法与 Linux／Mac 版本略有不同，请查阅平台使用差异。

## 检测下载问题

    
    
    qwebtest -download -s <problem_url> [-H headers][-o output][-timeout mins][-src][-from addr]
        -s          指定下载地址URL
        -H          添加请求的自定义Header，格式: -H "Referer: http://bar.foo.com"
        -o          指定文件输出路径，若不指定，下载的文件内容则被丢弃
        -src        穿透CDN，直接从源站下载
        -from       从指定的源站服务器直接下载
        -timeout    设置程序运行的最长时间（单位：分钟）
    

其中 problem_url 为用户下载出问题的 URL 地址。

常用实例：

方式 | 命令  
---|---  
从 CDN 下载 | `qwebtest -download -s "http://bar.qiniudn.com/foo.jpg"`  
从 CDN 下载并保存 | `qwebtest -download -s "http://bar.qiniudn.com/foo.jpg" -o local.jpg`  
从源站下载 | `qwebtest -download -s "http://bar.qiniudn.com/foo.jpg" -src`  
从源站下载并保存 | `qwebtest -download -s "http://bar.qiniudn.com/foo.jpg" -o local.jpg -src`  
  
## 检测上传问题

    
    
    qwebtest -upload [-f inputfile][-r][-to addr][-ak access_key][-sk secret_key][-bucket bucket][-timeout mins]
        -f          指定文件上传，若不指定则默认随机生成内容上传
        -r          使用断点续上传模式，若不指定则默认使用普通上传
        -ak         指定Access Key
        -sk         指定Secret Key
        -bucket     指定Bucket
        -to         上传到指定的服务器
        -timeout    设置程序运行的最长时间（单位：分钟）
    

常用实例：

方式 | 命令  
---|---  
生成随机内容上传 | `qwebtest -upload`  
生成随机内容断点续上传 | `qwebtest -upload -r`  
指定本地文件上传 | `qwebtest -upload -f /path/to/local.jpg`  
指定本地文件断点续上传 | `qwebtest -upload -f /path/to/local.jpg -r`  
指定上传到某个空间 foo | `qwebtest -upload -f /path/to/local.jpg -ak x6789..djh68 -sk 78d78a..67fa -bucket foo`  
  
## 查看检测报告

命令运行结束时，会在当前目录下生成一个名为 qwebtest.result..txt 的报告文件，用户可以自行查看，也可以将该 ID
告诉我们的工作人员，我们会根据这个 ID 找到对应的报告文件。

报告 ID 可以从程序运行之后的输出中获得，例如：

    
    
    $ ./qwebtest -download -s "http://xoxo.qiniudn.com/1.jpg"
    Get base info ..
    Testing network condition ..
    Testing download ..
    Send back report to qiniu...Done.
    Report ID: 4vGY4BTComyongl3
    

其中的 4vGY4BTComyongl3 就是报告 ID。

Windows 下获取报告 ID 的方式如下：

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

## 平台使用差异

**Windows**

按下 Win + R 调出运行对话框，输入命令 cmd
并按回车执行。在弹出的命令行终端界面中，输入该工具所在的路径或者简单地用鼠标将工具拖拽至命令行终端中，然后填入相关检测参数后即可执行。例如：

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

**Linux／Mac**

直接在终端界面中调出命令行工具，输入检测参数后即可执行。

以上内容是否对您有帮助？
human: 如何处理七牛云的对象存储数据安全最佳实践

gpt: [对象存储](https://developer.qiniu.com/kodo) > 最佳实践 > 数据安全最佳实践

#  数据安全最佳实践

最近更新时间: 2022-07-12 14:38:09

数据上云，数据安全问题成为用户关心的头等要事。而数据安全又涵盖了方方面面，如云存储服务安全的上传、下载、传输，云上资源的稳定性、可访性等。  
七牛云存储 Kodo 具备了保障数据安全的各项功能以及完善的安全访问体系，为您有效规避风险、提供数据安全的最佳实践。

  * [保障安全上传、下载、管理数据](https://developer.qiniu.com/kodo/best_practices/12019/security-upload-download-manage-data)
  * [降低因账号密码泄露带来的未授权访问风险](https://developer.qiniu.com/kodo/best_practices/12020/reduce-because-of-the-account-password-reveal-that-brings-the-risk-of-unauthorized-access)
  * [降低被恶意篡改数据的风险](https://developer.qiniu.com/kodo/best_practices/12021/reducing-the-risk-of-malicious-tampering-with-data)
  * [防止恶意文件上传](https://developer.qiniu.com/kodo/best_practices/6323/prevent-malicious-file-upload-best-practices)
  * [降低被恶意访问、盗量的风险](https://developer.qiniu.com/kodo/best_practices/12022/reduce-the-risk-of-be-malicious-access-stolen)
  * [降低或因误操作导致的数据丢失的风险](https://developer.qiniu.com/kodo/best_practices/12023/to-reduce-or-the-risk-of-data-loss-as-a-result-of-wrong-operation)
  * [跟踪、追溯对数据的关键操作](https://developer.qiniu.com/kodo/best_practices/12024/the-key-to-tracking-traceability-of-data-operation)
  * [敏感数据安全防护](https://developer.qiniu.com/kodo/best_practices/12025/sensitive-data-security-protection)

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