Overview

This document provides an overview of APIs and SDK code samples related to custom domains.

SDK API References

For the parameters and method description of all the APIs in the SDK, see API Documentation.

Setting Custom Domains

Description

This API (PUT Bucket domain) is used to set a custom domain for a bucket.

Sample code

try
{
 // Bucket name in the format of `BucketName-APPID`. You can get APPID by referring to https://console.cloud.tencent.com/developer.
 string bucket = "examplebucket-1250000000";

 DomainConfiguration domain = new DomainConfiguration();
 domain.rule = new DomainConfiguration.DomainRule();
 domain.rule.Name = "www.qq.com";
 domain.rule.Status = "ENABLED";
 domain.rule.Type = "WEBSITE";

 PutBucketDomainRequest request = new PutBucketDomainRequest(bucket, domain);   
 // Execute the request
 PutBucketDomainResult result = cosXml.PutBucketDomain(request);

 // Request succeeded
 Console.WriteLine(result.GetResultInfo());
}
catch (COSXML.CosException.CosClientException clientEx)
{
 // Request failed
 Console.WriteLine("CosClientException: " + clientEx);
}
catch (COSXML.CosException.CosServerException serverEx)
{
 // Request failed
 Console.WriteLine("CosServerException: " + serverEx.GetInfo());
}

Note：

For the complete sample, go to GitHub.

Error codes

The following describes some common errors that may occur when you call this API:

Querying a Custom Domain

Description

This API (GET Bucket domain) is used to query the custom domain set for a bucket.

Sample code

try
{
 // Bucket name in the format of `BucketName-APPID`. You can get APPID by referring to https://console.cloud.tencent.com/developer.
 string bucket = "examplebucket-1250000000";
 GetBucketDomainRequest request = new GetBucketDomainRequest(bucket);   
 // Execute the request
 GetBucketDomainResult result = cosXml.GetBucketDomain(request);

 // Request succeeded
 Console.WriteLine(result.domainConfiguration);
}
catch (COSXML.CosException.CosClientException clientEx)
{
 // Request failed
 Console.WriteLine("CosClientException: " + clientEx);
}
catch (COSXML.CosException.CosServerException serverEx)
{
 // Request failed
 Console.WriteLine("CosServerException: " + serverEx.GetInfo());
}

Note：

For the complete sample, go to GitHub.

Response parameters