Feature Overview
If you enable Original Image Protection and want to obtain the original image in some scenarios, you can use this interface to obtain it. Note:
This request operation does not support anonymous requests and must carry a signature.
Authorization Guide
When used with a sub-account, the cos:GetObject permission must be granted. For details, please refer to COS action. For other CI permissions, please refer to Cloud Infinite. Service Activation
Using this feature requires no service activation or role authorization and can be used directly. After use, it will automatically activate the Cloud Infinite service and bind your bucket.
Use Limits
Fee Description
This API is a paid service. The incurred fees will be collected by CI. For detailed billing instructions, see Image Processing Fees. If processing during download is adopted and the download is performed via the public network, the API call will incur Traffic Fees. Request
Request Sample
GET /<ObjectKey>?ci-process=originImage HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Request Parameters
|
ObjectKey | Object filename, for example folder/sample.png. | String | Yes |
ci-process | Cloud Infinite general parameter, when you need to get the original image, this parameter is fixed as: originImage | String | Yes |
Request Header.
This API has no special request headers.
Request Body.
This API has no request body.
Response
Response Header
This API has no special response headers.
Response Body
The response body of this API is the content of a file object.
Practical Example
Access an image in a bucket with Original Image Protection enabled, carrying the original image retrieval parameter:
http://example-1250000000.cos.ap-chengdu.myqcloud.com/?ci-process=originImage&q-sign-algorithm=sha1&q-ak=xxx&q-sign-time=1682323014;1682326614&q-key-time=1682323014;1682326614&q-header-list=&q-url-param-list=ci-process&q-signature=xxxxx
Note:
<signature> is the signature part. To obtain it, please refer to Request Signature documentation.