tencent cloud

文档反馈

设置访问域名(CDN/全球加速)

最后更新时间:2024-01-19 15:41:29

    简介

    本文档提供关于如何使用非默认域名请求 COS 服务。

    默认 CDN 加速域名

    功能说明

    在 COS 控制台为存储桶开启默认 CDN 加速域名后,可在 SDK 代码中设置对应的域名,以便实现默认加速功能。 关于如何开启默认加速域名请参见 开启默认 CDN 加速域名

    方法原型

    void com.qcloud.cos.ClientConfig.setEndPointSuffix(String endPointSuffix)

    请求示例

    // 1 使用 CDN 加速域名,无需再发送 COS 的认证信息
    COSCredentials cred = new AnonymousCOSCredentials();
    // 2 设置 bucket 的地域简称,COS 地域简称请参照 https://www.tencentcloud.com/document/product/436/6224
    ClientConfig clientConfig = new ClientConfig(new Region("ap-beijing"));
    // 推荐使用 https 协议
    clientConfig.setHttpProtocol(HttpProtocol.https);
    // 3 设置默认 CDN 加速域名后缀
    String cdnSuffix = "file.myqcloud.com";
    clientConfig.setEndPointSuffix(cdnSuffix);
    // 4 生成 cos 客户端
    COSClient cosclient = new COSClient(cred, clientConfig);

    参数说明

    参数名称
    描述
    类型
    endPointSuffix
    通过设置域名后缀,使用 CDN 加速域名
    String

    自定义 CDN 加速域名

    功能说明

    在 COS 控制台为存储桶设置自定义 CDN 加速域名后,可在 SDK 代码中设置对应的域名,以便实现自定义域名的加速功能。关于如何开启自定义 CDN 加速域名,请参见 开启自定义 CDN 加速域名

    方法原型

    void com.qcloud.cos.ClientConfig.setEndpointBuilder(EndpointBuilder endpointBuilder)

    请求示例

    // 1 使用 CDN 加速域名,无需再发送 COS 的认证信息
    COSCredentials cred = new AnonymousCOSCredentials();
    // 2 设置 bucket 的地域简称,COS 地域简称请参照 https://www.tencentcloud.com/document/product/436/6224
    ClientConfig clientConfig = new ClientConfig(new Region("ap-beijing"));
    // 推荐使用 https 协议,如果使用 https 协议,请确保自定义域名有相关 https 证书
    clientConfig.setHttpProtocol(HttpProtocol.https);
    // 3 设置 CDN 自定义域名
    // get service 请求会使用这个域名,这个域名不能自定义
    String serviceApiEndpoint = "service.cos.myqcloud.com";
    String cdnEndpoint = "xxx.xxx.com";
    UserSpecifiedEndpointBuilder endPointBuilder = new UserSpecifiedEndpointBuilder(cdnEndpoint, serviceApiEndpoint);
    clientConfig.setEndpointBuilder(endPointBuilder);
    // 4 生成 cos 客户端
    COSClient cosclient = new COSClient(cred, clientConfig);

    参数说明

    参数名称
    描述
    类型
    endPointerBuilder
    参数用于构建自定义 CDN 加速域名
    UserSpecifiedEndpointBuilder
    UserSpecifiedEndpointBuilder 说明:
    参数名称
    描述
    类型
    generalApiEndpoint
    填写用户的自定义 CDN 加速域名
    String
    getServiceApiEndpoint
    只能填写 service.cos.myqcloud.com
    String

    自定义源站域名

    功能说明

    在 COS 控制台为存储桶设置自定义源站域名后,可在 SDK 代码中设置对应的域名,以便实现访问 COS 资源。关于如何设置自定义源站域名请参见 自定义源站域名

    方法原型

    void com.qcloud.cos.ClientConfig.setEndpointBuilder(EndpointBuilder endpointBuilder)

    请求示例

    // 1 初始化用户身份信息(secretId, secretKey)
    // SECRETID和SECRETKEY请登录访问管理控制台进行查看和管理
    String secretId = "SECRETID";
    String secretKey = "SECRETKEY";
    COSCredentials cred = new BasicCOSCredentials(secretId, secretKey);
    // 2 设置 bucket 的地域简称,COS 地域简称请参照 https://www.tencentcloud.com/document/product/436/6224
    ClientConfig clientConfig = new ClientConfig(new Region("ap-beijing"));
    // 推荐使用 https 协议
    clientConfig.setHttpProtocol(HttpProtocol.https);
    // 3 设置自定义域名
    // get service 请求会使用这个域名,这个域名不能自定义
    String serviceApiEndpoint = "service.cos.myqcloud.com";
    String userEndpoint = "xxx.xxx.com";
    UserSpecifiedEndpointBuilder endPointBuilder = new UserSpecifiedEndpointBuilder(userEndpoint, serviceApiEndpoint);
    clientConfig.setEndpointBuilder(endPointBuilder);
    // 4 生成 cos 客户端
    COSClient cosclient = new COSClient(cred, clientConfig);

    参数说明

    参数名称
    描述
    类型
    endPointerBuilder
    参数用于构建自定义源站域名
    UserSpecifiedEndpointBuilder
    UserSpecifiedEndpointBuilder 说明:
    参数名称
    描述
    类型
    generalApiEndpoint
    填写自定义源站域名
    String
    getServiceApiEndpoint
    只能填写 service.cos.myqcloud.com
    String

    全球加速域名

    功能说明

    在 COS 控制台为存储桶开启全球加速域名后,可在 SDK 代码中设置对应的域名,以便实现全球加速功能。关于全球加速的功能介绍,请参见 全球加速功能概述

    方法原型

    void com.qcloud.cos.ClientConfig.setEndPointSuffix(String endPointSuffix)

    请求示例

    // 1 初始化用户身份信息(secretId, secretKey)
    // SECRETID和SECRETKEY请登录访问管理控制台进行查看和管理
    String secretId = "SECRETID";
    String secretKey = "SECRETKEY";
    COSCredentials cred = new BasicCOSCredentials(secretId, secretKey);
    // 2 设置 bucket 的地域简称,COS 地域简称请参照 https://www.tencentcloud.com/document/product/436/6224
    ClientConfig clientConfig = new ClientConfig(new Region("ap-beijing"));
    // 推荐使用 https 协议
    clientConfig.setHttpProtocol(HttpProtocol.https);
    // 3 设置全球加速域名后缀
    String cosSuffix = "cos.accelerate.myqcloud.com";
    clientConfig.setEndPointSuffix(cosSuffix);
    // 4 生成 cos 客户端
    COSClient cosclient = new COSClient(cred, clientConfig);

    参数说明

    参数名称
    描述
    类型
    endPointSuffix
    通过设置域名后缀,使用全球加速域名
    String
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持