Amazon Simple Storage Service (S3) is one of the earliest cloud services provided by AWS. Through many years of development, the S3 protocol has become a standard in the object storage industry. Tencent Cloud Object Storage (COS) provides implementation methods compatible with S3; therefore, you can directly use COS in most of S3 applications. This document describes how to configure such applications with COS.

Preparations

Confirming whether an application can use COS

• An application with S3 Compatible in its description can use COS in most cases. If you find that some of its features cannot work properly, please submit a ticket for assistance where you should indicate that you followed the steps in this document and provide information such as the application name and screenshots.
• If an application only claims that it supports Amazon S3, it can use the S3 service, but whether it supports COS needs to be further confirmed in relevant configuration. Application support for COS will be described in detail in the "Basic configurations" section in this document.

Preparing the COS service

Step 1. Sign up for a Tencent Cloud account

(If you already have a Tencent Cloud account, you can ignore this step.)

Step 2. Verify your identity

(If you have already completed identity verification, you can ignore this step.)

For more information on how to verify your identity, please see Identify Verification Overview.

Step 3. Activate COS

Step 4. Prepare the APPID and access key

On the API Key Management page in the CAM Console, get and record the APPID, SecretId, and SecretKey.

Step 5. Create a bucket

Some applications have an in-built bucket creation procedure. If you want your application to create a bucket, you can ignore this step.

1. Log in to the COS Console and click Bucket List on the left sidebar to enter the bucket management page.
2. Click Create Bucket and enter the bucket information.
   • Name: bucket name, such as examplebucket.
   • Region: region where the bucket resides. Please select the region closest to you. For example, if you are in Shenzhen, you can select the Guangzhou region.
   • Access Permission: bucket access permission. For example, you can select "Private Read/Write".
     
3. Click OK.

Configuring COS in Application

Basic configurations

Most applications have similar configuration items when they are configured with a storage service. Common names and descriptions of these configuration items are as follows:

If you have any question during the configuration, please submit a ticket for assistance where you should indicate that you followed the steps in this document and provide information such as the application name and screenshots.

Other configuration items and advanced configurations

Some applications have more configuration items such as advanced configurations in addition to the aforementioned ones. Some COS features are further described below for you to better use COS in your application.

• Service port and protocol
  COS supports HTTP and HTTPS protocols, which use ports 80 and 443 by default, respectively. For the sake of security, you are recommended to use HTTPS for COS.
• Path-style and virtual hosted-style
  COS supports both styles.
• AWS V2 signature and AWS V4 signature
  COS supports both signature formats.

Note

COS does not guarantee full compatibility with S3. If you have any question when using COS in your application, please submit a ticket for assistance where you should indicate that you followed the steps in this document and provide information such as the application name and screenshots.