Obtaining the Custom Domain Names of a Bucket

Function

This API is used to obtain the custom domain name list of an OBS bucket.

Restrictions

• To obtain the custom domain names of a bucket, you must be the bucket owner or have the required permission (obs:bucket:GetBucketCustomDomain granted using IAM or GetBucketCustomDomain granted using a bucket policy). For details, see Introduction to OBS Access Control, IAM Custom Policies, and Creating a Custom Bucket Policy.
• The mapping between OBS regions and endpoints must comply with what is listed in Regions and Endpoints.

Method

ObsClient.getBucketCustomDomain(GetBucketCustomDomainRequest request)

Request Parameters

Responses

Sample Code

This example obtains the custom domain names of a bucket.

import android.util.Log;
import com.obs.services.ObsClient;
import com.obs.services.exception.ObsException;
import com.obs.services.model.BucketCustomDomainInfo;

new Thread(() -> {
    // Security warning: Hard-coded AK and SK are risky. You are advised to obtain the AK and SK from the security credential management system.
    String ak = System.getenv("ACCESS_KEY_ID");
    String sk = System.getenv("SECRET_ACCESS_KEY");
    String endPoint = "https://your-endpoint";

    ObsClient obsClient = null;
    try {
        obsClient = new ObsClient(ak, sk, endPoint);

        String bucketName = "examplebucket";

        BucketCustomDomainInfo result = obsClient.getBucketCustomDomain(bucketName);
        Log.i("ObsDemo", "Obtained the custom domain names of the bucket successfully. Custom domain names: " + result.getCustomDomains());
    } catch (ObsException e) {
        Log.e("ObsDemo", "Failed to obtain the custom domain names of the bucket. HTTP status code: " + e.getResponseCode()
                + ". Error code: " + e.getErrorCode()
                + ". Error message: " + e.getErrorMessage());
    } finally {
        if (obsClient != null) {
            try {
                obsClient.close();
            } catch (Exception e) {
                Log.e("ObsDemo", "Failed to close ObsClient.", e);
            }
        }
    }
}).start();