控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

诚邀爱技术、爱分享的你,成为文档内容共建者> HOT

功能描述

该接口用于添加图库图片。

请求

请求示例

POST /<ObjectKey>?ci-process=ImageSearch&action=AddImage HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
Content-Type: application/xml

<body>

说明:

Authorization: Auth String (详情请参见 请求签名 文档)。

请求参数

此接口无请求参数。

请求头

此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

请求体

该请求操作的实现需要有如下请求体。

<Request>
    <EntityId>apple</EntityId>
    <CustomContent>myapple</CustomContent>
    <Tags>{"key1":"val1","key2":"val2"}</Tags>
</Request>

具体数据描述如下:

节点名称(关键字) 父节点 描述 类型 是否必选
Request 保存请求的容器 Container

Request节点的具体数据描述如下:

节点名称(关键字) 父节点 描述 类型 是否必选
EntityId Request 物品 ID,最多支持64个字符。若 EntityId 已存在,则对其追加图片 String
CustomContent Request 用户自定义的内容,最多支持4096个字符,查询时原样带回 String
Tags Request 图片自定义标签,最多不超过10个,json 字符串,格式为 key:value 对 String

响应

响应头

此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

响应体

该响应无响应体。

错误码

此接口遵循统一的错误响应和错误码,详情请参见 错误码 文档。

实际案例

请求

POST /<ObjectKey>?ci-process=ImageSearch&action=AddImage HTTP/1.1
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1558699190;1558706390&q-key-time=1558699190;1558706390&q-header-list=date;host&q-url-param-list=&q-signature=89fa1f6a56c34e460f3db4d65f928eaf034a****
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Content-Length: 100
Content-Type: application/xml

<Request>
    <EntityId>apple</EntityId>
    <CustomContent>myapple</CustomContent>
    <Tags>{"key1":"val1","key2":"val2"}</Tags>
</Request>

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 0
Connection: keep-alive
Date: Thu, 15 Jun 2017 12:37:29 GMT
Server: tencent-ci
x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****

目录