Adding a Style

Last updated: 2021-06-24 15:43:35

    Overview

    This API is used to add a style to a bucket. This style will be added to images newly uploaded to this bucket.

    Note:

    Currently, the QPS for bucket writes is limited to 1, and bucket reads to 10.

    API Explorer is recommended.
    Debug
    API Explorer makes it easy to make online API calls, verify signatures, generate SDK code, search for APIs, etc. You can also use it to query the content of each request as well as its response.

    Request

    Sample request

    PUT /?style HTTP/1.1
    Host: <BucketName-APPID>.pic.<Region>.myqcloud.com 
    Date: GMT Date
    Authorization: Auth String
    <XML File>
    
    Note:

    Authorization: Auth String (For more information, please see Request Signature.)

    Request headers

    This API uses only common request headers. For more information, please see Common Request Headers.

    Request body

    <?xml version="1.0" encoding="UTF-8" ?>
    <AddStyle>
    <StyleName>string</StyleName>
    <StyleBody>string</StyleBody>
    </AddStyle>
    

    Nodes are described as follows:

    Node Name (Keyword) Parent Node Description Type Required
    AddStyle None The style to be added Container Yes

    Content of AddStyle:

    Node Name (Keyword) Parent Node Description Type Required
    StyleName AddStyle Style name string Yes
    StyleBody AddStyle Style details string Yes

    Response

    Response headers

    This API uses only common response headers. For more information, please see Common Response Headers.

    Response body

    The response body returned is empty.

    Error codes

    This API does not have any special error codes. For more information about all error codes, please see Error Codes.

    Example

    Request

    PUT /?style HTTP/1.1
    Host: examplebucket-1250000000.pic.ap-chengdu.myqcloud.com
    Date: Tue, 03 Apr 2019 09:06:15 GMT
    Authorization:XXXXXXXXXXXX
    <?xml version="1.0" encoding="UTF-8" ?>
    <AddStyle>
     <StyleName>style_name</StyleName>
     <StyleBody>imageMogr2/thumbnail/!50px</StyleBody>
    </AddStyle>
    

    Response

    HTTP/1.1 200 OK
    Content-Type: application/xml
    Content-Length: 0
    Date: Tue, 03 Apr 2019 09:06:16 GMT
    x-cos-request-id: xxxxxxxxxxxxxxxxxx