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.
- By using Tencent Cloud COS APIs, you acknowledge that you have read and agree to the General Service Level Agreements and Service Level Agreement.
- For more information on the regions where COS is available, please see Regions and Access Endpoints.
- Before you use the APIs or SDKs to initiate requests, we recommend you read the Creating Request Overview document to learn more about access endpoints, authentication, and how to determine whether an access request is over the private or public network.
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:
|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|
Take the following steps to start using COS APIs:
SecretKeyon the API Key Management page in the CAM Console.