Last updated: 2018-05-17 18:11:55PDF
The XML APIs of Tencent Cloud Object Storage (COS) service are a kind of lightweight interfaces without connection state. You can call these APIs to send requests and receive responses directly via http/https, in order to interact with the backend of Tencent Cloud Object Storage. The contents of both requests and responses for these APIs are in XML format.
Currently, the available Regions of COS have different values for XML APIs and JSON APIs, and the corresponding region fields are required when using different APIs and their SDKs. For more information, see the document Available Regions.
In order to use the XML APIs of Tencent Cloud Object Storage service more efficiently, please read Request Signature carefully before reviewing other API documents.
Some main concepts and terms appear in the text:
|APPID||A unique resource ID in user dimension owned by a developer when accessing COS services, which is used to indicate resources|
|SecretId||The project identity ID owned by a developer, which is used for identity authentication|
|SecretKey||The project identity key owned by a developer|
|Bucket||The container used to store data in COS|
|Object||The specific file stored in COS, which is the basic entity that is stored|
|Region||The region information in domain name. For enumerated values, please see the document Available Regions, such as: ap-beijing, ap-hongkong, eu-frankfurt, etc.|
|ACL||Access Control List, which refers to the access control information list of specified Buckets or Objects|
|CORS||Cross-Origin Resource Sharing,
which refers to the HTTP request for resources from a different domain
|Multipart Uploads||Refers to a multipart upload mode provided by Tencent Cloud COS service for uploading files|
To use the Tencent Cloud object storage APIs, you need to follow these steps first:
- Purchase the Tencent Cloud Object Storage (COS) service
- Create a Bucket in Tencent Cloud Object Storage Console
- Obtain APPID, SecretId, and SecretKey on the console Personal API Key page
- Write an algorithm program for requesting signature (or use any of server-side SDKs)
- Calculate the signature and call API to perform operation
APIs of Other Versions
JSON API is the API provided by Tencent Cloud COS service for users to access COS before launching the XML API, and the upload domain name is [Region].file.myqcloud.com. JSON APIs and standard XML APIs have the same underlying infrastructure, and thus data interoperability is possible and they can be cross-used. However, they're not compatible with each other and have different domains.
After the XML API service of Tencent Cloud COS is launched, it is recommended that you use the XML API interface. JSON APIs will be kept in a state of maintenance, and they will be available for use but no new features will be added.