tencent cloud

Overview

This document provides an overview of APIs and SDK sample codes for cross-origin resource sharing (CORS).

For more information, see Cross-Origin Resource Sharing. When you set the CORS configuration, see Setting Cross-Origin Resource Sharing (CORS) or Setting Cross-Origin Access.

Setting CORS Configuration

Description

This API is used to set the CORS configuration of a specified bucket.

Method prototype

public void setBucketCrossOriginConfiguration(String bucketName, BucketCrossOriginConfiguration bucketCrossOriginConfiguration);

Sample request

// Enter the bucket name in the format: BucketName-APPID.
String bucketName = "examplebucket-1250000000";
| bucketCrossOriginConfiguration | The cross-domain access rules set for a bucket | BucketCrossOriginConfiguration |
List<CORSRule> corsRules = new ArrayList<CORSRule>();
CORSRule corsRule = new CORSRule();
// Rule name
corsRule.setId("set-bucket-cors-test");
// Allowed HTTP method
corsRule.setAllowedMethods(CORSRule.AllowedMethods.PUT, CORSRule.AllowedMethods.GET, CORSRule.AllowedMethods.HEAD);
corsRule.setAllowedHeaders("x-cos-grant-full-control");
corsRule.setAllowedOrigins("http://mail.qq.com", "http://www.qq.com", "http://video.qq.com");
corsRule.setExposedHeaders("x-cos-request-id");
corsRule.setMaxAgeSeconds(60);
corsRules.add(corsRule);
bucketCORS.setRules(corsRules);
cosClient.setBucketCrossOriginConfiguration(bucketName, bucketCORS);

Parameter description

Response description

• Success: No value is returned.
• Failure: If an error (such as authentication failure) occurs, the CosClientException or CosServiceException exception will be reported. For more information, see Troubleshooting.

Querying CORS Configuration

Description

This API is used to query the CORS configuration of a bucket.

Method prototype

public BucketCrossOriginConfiguration getBucketCrossOriginConfiguration(String bucketName)
throws CosClientException, CosServiceException;

Sample request

// Enter the bucket name in the format: BucketName-APPID.
String bucketName = "examplebucket-1250000000";
BucketCrossOriginConfiguration corsGet = cosClient.getBucketCrossOriginConfiguration(bucketName);
List<CORSRule> corsRules = corsGet.getRules();
for (CORSRule rule : corsRules) {
   List<CORSRule.AllowedMethods> allowedMethods = rule.getAllowedMethods();
   List<String> allowedHeaders = rule.getAllowedHeaders();
   List<String> allowedOrigins = rule.getAllowedOrigins();
   List<String> exposedHeaders = rule.getExposedHeaders();
   int maxAgeSeconds = rule.getMaxAgeSeconds();
}

Parameter description

Response description

-Success: Returns the cross-origin rules for the bucket.

• Failure: If an error (such as authentication failure) occurs, the CosClientException or CosServiceException exception will be reported. For more information, see Troubleshooting.

Deleting CORS Configuration

Description

This API is used to delete the CORS configuration of a bucket.

Method prototype

public void deleteBucketCrossOriginConfiguration(String bucketName)
throws CosClientException, CosServiceException;

Sample request

Bucket. Format: BucketName-APPID
String bucketName = "examplebucket-1250000000";
cosClient.deleteBucketCrossOriginConfiguration(bucketName);

Parameter description

Response description

• Success: No value is returned.
• Failure: If an error (such as authentication failure) occurs, the CosClientException or CosServiceException exception will be reported. For more information, see Troubleshooting.