KS3访问域名使用规则

最近更新时间:2019-11-06 17:03:15

KS3访问域名使用规则

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

KS3域名构成规则

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

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

通过外网访问KS3服务

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

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

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

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

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

    您还可以直接将Object的URL放入HTML中使用,如下所示:

    <img src="https://ks3-cn-beijing.ksyun.com/aaa/bbb/ccc.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>://<内网Endpoint>/<Bucket>/<Object>
    • Schema:HTTP或者为HTTPS。
    • 内网Endpoint:Bucket所在地区供同地区KEC访问的内网Endpoint,各地区Endpoint详情请参见 Endpoint与Region的对应关系
    • Bucket:KS3存储空间名称。
    • Object:上传到KS3上的文件的访问路径。

    示例:如果您的Region为北京,Bucket名称为aaa,Object访问路径为bbb/ccc.txt,那么您的外网访问地址为 ks3-cn-beijing-internal.ksyun.com/aaa/bbb/ccc.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);

金山云,开启您的云计算之旅

注册有礼