Last updated: 2020-09-21 18:10:40

    COS uses XML APIs, which are lightweight, connectionless, and stateless. By calling XML APIs, you can send requests and accept responses directly through HTTP/HTTPS to interact with the COS backend.

    Since COS APIs and TencentCloud APIs use different data transfer frameworks, APIs and SDKs provided by COS are independent of TencentCloud APIs and SDKs. You can find more information in Operation List or download SDKs in SDK Overview as needed. The guides for TencentCloud APIs and corresponding SDKs do not cover the operational features of COS.


    API Overview

    For the APIs supported by COS, please see Operation List.


    When using the APIs, you may see some key concepts and terms as detailed below:

    Name Description
    APPID APPID of your Tencent Cloud account, which is a unique user-level resource identifier used to access COS and can be obtained on the API Key Management page in the console.
    SecretId Your project ID, which is used for authentication and can be obtained on the API Key Management page in the console.
    SecretKey Your project key, which can be obtained on the API Key Management page in the console.
    Bucket A bucket is a container used to store data in COS. For more information, please see Bucket Overview.
    Object An object is a specific file stored in COS, which is the basic entity of storage.
    ObjectKey An object key is the unique ID of an object in a bucket. For more information on object and object key, please see Object Overview.
    Region Region information such as ap-beijing, ap-hongkong, and eu-frankfurt. For enumerated values, please see Regions and Access Endpoints.
    ACL An access control list (ACL) is a list of access control information for a specified bucket or object.
    CORS Cross-origin resource sharing (CORS) refers to HTTP requests where the origin of the resource
    that initiates the request is different from the origin of the destination resource.
    Multipart Uploads Multipart upload mode provided by COS for uploading files in multiple parts

    Getting Started

    Take the following steps to start using COS APIs:

    1. Activate the COS service in the COS Console.
    2. Create a bucket in the COS Console.
    3. Get the APPID and create SecretId and SecretKey on the API Key Management page in the CAM Console.
    4. Write a request signature algorithm program or use a server SDK. For more information, please see Request Signature.
    5. Calculate the signature and call an API to perform an operation.

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback