tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
文档

添加图库图片

最后更新时间：2024-01-20 09:22:44

    功能描述

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

    请求

    请求示例

    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****
    
    Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
    隐私条款服务条款缓存条款