KS3访问域名使用规则

最近更新时间:2021-04-28 10:59:53

查看PDF

KS3会为每一个存储空间(Bucket)分配默认的访问域名,本文介绍KS3访问域名的构成规则及使用方式。

KS3域名构成规则

针对KS3的网络请求,除了GetService这个API以外,其他所有请求的域名都是带有指定Bucket信息的三级域名组成的。

访问域名结构:BucketName.Endpoint。BucketName为您的存储空间名称,Endpoint为存储空间对应的地域域名。

通过外网访问KS3服务

外网指的是互联网。通过外网访问产生的流入流量(写)是免费的,流出流量(读)是收费的。

外网访问KS3有如下两种方式:

  • 访问方式一:访问时以URL的形式来表示KS3的资源。KS3的URL构成如下:

      <Schema>://<Bucket>.<外网Endpoint>/<Object>
    
    • Schema:HTTP或者为HTTPS。
    • Bucket:KS3存储空间名称。
    • 外网Endpoint:Bucket所在地区供外网访问的Endpoint,各地区Endpoint详情请参见 Endpoint与Region的对应关系
    • Object:上传到KS3上的文件的访问路径。

    示例1:如果您的Region为北京(ks3-cn-beijing),Bucket名称为test,Object访问路径为aaa/bbb.txt,那么您的外网访问地址为 test.ks3-cn-beijing.ksyun.com/aaa/bbb.txt

    示例2:您可以直接将访问路径为aaa/ddd.png的Object的URL放入HTML中使用,例如:

      <img src="https://test.ks3-cn-beijing.ksyun.com/aaa/ddd.png" />
    
  • 访问方式二: 通过KS3 SDK配置外网访问域名。

    KS3 SDK会对您的每一个操作拼接访问域名。但您在对不同地域的Bucket进行操作的时候需要设置不同的Endpoint。

    以Java SDK为例,对北京地区的Bucket进行操作时,需要在对类实例化时设置Endpoint:

    Ks3ClientConfig config = new Ks3ClientConfig();
    config.setEndpoint("ks3-cn-beijing.ksyun.com");
    Ks3 client = new Ks3Client("<您的AccessKeyID>","<您的AccessKeySecret>",config);
    

通过内网访问KS3服务

内网指的是金山云产品之间的内网通信网络,例如您通过KEC云服务器访问KS3服务。内网产生的流入和流出流量均免费,但是请求次数仍会计费。

内网访问KS3有如下两种方式:

  • 访问方式一:在访问的时候以URL的形式来表示KS3的资源。KS3的URL构成如下:

      <Schema>://<Bucket>.<内网Endpoint>/<Object>
    
    • Schema:HTTP或者为HTTPS。
    • Bucket:KS3存储空间名称。
    • 内网Endpoint:Bucket所在地区供同地区KEC访问的内网Endpoint,各地区Endpoint详情请参见 Endpoint与Region的对应关系
    • Object:上传到KS3上的文件的访问路径。

    示例:如果您的Region为北京,Bucket名称为test,Object访问路径为aaa/bbb.txt,那么您的内网访问地址为 test.ks3-cn-beijing-internal.ksyun.com/aaa/bbb.txt

  • 访问方式二: 通过KEC使用KS3 SDK配置内网Endpoint。

    以Java SDK为例,对北京地区的Bucket进行操作时,需要将Endpoint设置为北京地区的内网Endpoint:

Ks3ClientConfig config = new Ks3ClientConfig();
config.setEndpoint(“ks3-cn-beijing-internal.ksyun.com”);
Ks3 client = new Ks3Client("<您的AccessKeyID>","<您的AccessKeySecret>",config);

通过IPV6地址访问KS3

IPv6是IETF(互联网工程任务组,Internet Engineering Task Force)设计的用于替代现行版本IP协议(IPv4)的下一代IP协议。

KS3目前已支持通过IPv6/IPv4双栈域名访问。

您的IPv6/IPv4客户端均可以使用KS3提供的统一双栈域名访问您的存储空间。您的DNS服务器将按照您使用的协议版本解析对应协议的KS3服务器地址给您。

目前可以通过IPv6协议访问的地域有:

  • 北京
  • 上海
  • 广州

如有需要使用新版双栈域名,请提交工单或者联系商务开通权限。

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

  • 内容不全,不深入
  • 内容更新不及时
  • 描述不清晰,比较混乱
  • 系统或功能太复杂,缺乏足够的引导
  • 内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈