QingCloud 文档 – 外部镜像（External Mirror） - kaiyun官方网站下载手机网页

Storage: Delete Bucket External Mirror

Thu, 26 Nov 2020 10:08:56 +0900

该接口用于删除 Bucket 的外部镜像源站（External Mirror Source Site）相关设置，只有 Bucket 的所有者才能调用该 API。

请求语法

DELETE /?mirror HTTP/1.1
Host: <bucket-name>.<zone-id>.qingstor.com
Date: <date>
Authorization: <authorization-string>

请求参数

无。

请求头

此接口仅包含公共请求头。关于公共请求头的更多信息，请参见公共请求头。

请求消息体

无。

响应头

此接口仅包含公共响应头。关于公共响应头的更多信息，请参见公共响应头。

错误码

错误码	错误描述	HTTP 状态码
OK	成功删除外部镜像相关设置	204

其他错误码可参考错误码列表。

示例

请求示例

DELETE /?mirror HTTP/1.1
Host: mybucket.pek3a.qingstor.com
Date: Sun, 16 Aug 2015 09:05:00 GMT
Authorization: authorization string

响应示例

HTTP/1.1 204 NoContent
Server: QingStor
Date: Sun, 16 Aug 2015 09:05:00 GMT
Content-Length: 0
Connection: close
x-qs-request-id: aa08cf7a43f611e5886952542e6ce14b

SDK

此接口所对应的各语言 SDK 可参考 SDK 文档。

Storage: Get Bucket External Mirror

Thu, 26 Nov 2020 10:08:56 +0900

该接口用于获取 Bucket 的外部镜像源站（External Mirror Source Site），只有 Bucket 的所有者才能调用该 API。

请求语法

GET /?mirror HTTP/1.1
Host: <bucket-name>.<zone-id>.qingstor.com
Date: <date>
Authorization: <authorization-string>

请求参数

无。

请求头

此接口仅包含公共请求头。关于公共请求头的更多信息，请参见公共请求头。

请求体

无。

响应头

此接口仅包含公共响应头。关于公共响应头的更多信息，请参见公共响应头。

响应体

成功调用该 API 后，服务端通过如下字段返回携带有外部镜像回源的源站信息的 Json 消息体：

名称	类型	说明	是否必须
source_site	String	外部镜像回源的源站。	是

说明

源站填写格式为 <protocol>://<host>[:port]/[path]。详细说明可参考设置外部镜像中的相关说明。

错误码

错误码	错误描述	HTTP 状态码
OK	成功获取外部镜像相关设置	200

其他错误码可参考错误码列表。

示例

请求示例

GET /?mirror HTTP/1.1
Host: mybucket.pek3a.qingstor.com
Date: Sun, 14 Aug 2016 09:05:00 GMT
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Server: QingStor
Date: Sun, 14 Aug 2016 09:05:01 GMT
Content-Length: 0
Connection: close
x-qs-request-id: aa08cf7a43f611e5886952542e6ce14b

{
    "source_site": "http://example.com/image/"
}

SDK

此接口所对应的各语言 SDK 可参考 SDK 文档。

Storage: Put Bucket External Mirror

Thu, 26 Nov 2020 10:08:56 +0900

该接口用于设置 Bucket 的外部镜像源站（External Mirror Source Site），只有 Bucket 的所有者才能调用该 API。

对于设置了外部镜像源站的 Bucket，当请求的对象在 Bucket 中不存在时，QingStor 服务端会把对象名称（Object Key）拼接在外部镜像源站末尾后作为抓取的源链接，再从源站抓取，并将抓取到的结果写入至 QingStor 对象存储 Bucket 中。

从源站抓取数据，称之为回源。在回源的过程中，请求该对象的客户端，可能会下载到源站文件，也可能收到重定向到源站相应路径的 302 请求。在回源完成后，客户端就能够直接从 QingStor 对象存储的 Bucket 中获取该对象。

注意:

在 QingStor 对象存储完成回源后，源站的相应文件内容发生变化时，QingStor 对象存储并不会自动更新该对象。
QingStor 对象存储的 Put Object 接口需要输入文件大小，故，源站在提供下载文件时需返回 Content-Length 头，否则回源将失败。

请求语法

PUT /?mirror HTTP/1.1
Host: <bucket-name>.<zone-id>.qingstor.com
Date: <date>
Authorization: <authorization-string>

{
    "source_site": "<protocol>://<host>[:port]/[path]"
}

请求参数

无。

请求头

此接口仅包含公共请求头。关于公共请求头的更多信息，请参见公共请求头。

请求体

调用该 API 需携带如请求语法中的 Json 消息体。该消息体各字段说明如下：

名称	类型	说明	是否必须
source_site	String	外部镜像回源的源站。	是

源站的填写格式为 <protocol>://<host>[:port]/[path]。各参数说明如下：

protocol 的值为 http 或 https，默认值为 http。
port 默认为 protocol 对应的端口。
path 可为空。
若同一 QingStor 对象存储的 Bucket 多次设置不同的源站，则该 Bucket 的源站采用最后一次设置的值。

响应头

此接口仅包含公共响应头。关于公共响应头的更多信息，请参见公共响应头。

错误码

错误码	错误描述	HTTP 状态码
OK	成功设置外部镜像	200

其他错误码可参考错误码列表。

示例

请求示例

PUT /?mirror HTTP/1.1
Host: mybucket.pek3a.qingstor.com
Date: Sun, 14 Aug 2016 09:05:00 GMT
Authorization: authorization string
{
    "source_site": "http://example.com:80/image/"
}

响应示例

HTTP/1.1 200 OK
Server: QingStor
Date: Sun, 14 Aug 2016 09:05:01 GMT
Content-Length: 0
Connection: close
x-qs-request-id: aa08cf7a43f611e5886952542e6ce14b

SDK

此接口所对应的各语言 SDK 可参考 SDK 文档。