腾讯云对象存储自定义域名

简介

本文档提供关于自定义域名的 API 概览以及 SDK 示例代码。

SDK API 参考

SDK 所有接口的具体参数与方法说明，请参考 SDK API 参考。

设置自定义域名

功能说明

PUT Bucket domain 用于为存储桶配置自定义域名。

示例代码

// 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucketString bucket = "examplebucket-1250000000";PutBucketDomainRequest putBucketDomainRequest =        new PutBucketDomainRequest(bucket);DomainConfiguration.DomainRule domainRule = new DomainConfiguration.DomainRule(        DomainConfiguration.STATUS_ENABLED,        "www.example.com",        DomainConfiguration.TYPE_REST);domainRule.forcedReplacement = DomainConfiguration.REPLACE_CNAME;putBucketDomainRequest.addDomainRule(domainRule);
cosXmlService.putBucketDomainAsync(putBucketDomainRequest,        new CosXmlResultListener() {    @Override    public void onSuccess(CosXmlRequest request, CosXmlResult result) {        PutBucketDomainResult putBucketDomainResult =                (PutBucketDomainResult) result;    }
    // 如果您使用 kotlin 语言来调用，请注意回调方法中的异常是可空的，否则不会回调 onFail 方法，即：    // clientException 的类型为 CosXmlClientException?，serviceException 的类型为 CosXmlServiceException?    @Override    public void onFail(CosXmlRequest cosXmlRequest,                       @Nullable CosXmlClientException clientException,                       @Nullable CosXmlServiceException serviceException) {        if (clientException != null) {            clientException.printStackTrace();        } else {            serviceException.printStackTrace();        }    }});

说明更多完整示例，请前往 GitHub 查看。

返回错误码说明

该请求可能会发生的一些常见的特殊错误如下：

查询自定义域名

功能说明

GET Bucket domain 用于查询存储桶的自定义域名信息。

示例代码

// 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucketString bucket = "examplebucket-1250000000";GetBucketDomainRequest getBucketDomainRequest =        new GetBucketDomainRequest(bucket);cosXmlService.getBucketDomainAsync(getBucketDomainRequest,        new CosXmlResultListener() {    @Override    public void onSuccess(CosXmlRequest request, CosXmlResult result) {        GetBucketDomainResult getBucketTaggingResult =                (GetBucketDomainResult) result;    }
    // 如果您使用 kotlin 语言来调用，请注意回调方法中的异常是可空的，否则不会回调 onFail 方法，即：    // clientException 的类型为 CosXmlClientException?，serviceException 的类型为 CosXmlServiceException?    @Override    public void onFail(CosXmlRequest cosXmlRequest,                       @Nullable CosXmlClientException clientException,                       @Nullable CosXmlServiceException serviceException) {        if (clientException != null) {            clientException.printStackTrace();        } else {            serviceException.printStackTrace();        }    }});

说明更多完整示例，请前往 GitHub 查看。

返回参数说明

删除自定义域名

功能说明

DELETE Bucket domain 用于删除存储桶的自定义域名信息。注意 COS Android SDK 版本需要大于等于 v5.9.8。

示例代码

// 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucketString bucket = "examplebucket-1250000000";DeleteBucketDomainRequest deleteBucketDomainRequest =        new DeleteBucketDomainRequest(bucket);cosXmlService.deleteBucketDomainAsync(deleteBucketDomainRequest,        new CosXmlResultListener() {            @Override            public void onSuccess(CosXmlRequest request, CosXmlResult result) {                // 详细字段请查看api文档或者SDK源码                DeleteBucketDomainResult deleteBucketDomainResult =                        (DeleteBucketDomainResult) result;            }            // 如果您使用 kotlin 语言来调用，请注意回调方法中的异常是可空的，否则不会回调 onFail 方法，即：            // clientException 的类型为 CosXmlClientException?，serviceException 的类型为 CosXmlServiceException?            @Override            public void onFail(CosXmlRequest cosXmlRequest,                               @Nullable CosXmlClientException clientException,                               @Nullable CosXmlServiceException serviceException) {                if (clientException != null) {                    clientException.printStackTrace();                } else {                    serviceException.printStackTrace();                }            }        });

说明更多完整示例，请前往 GitHub 查看。
对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠