访问域名Endpoint阿里云对象存储OSS

OSS Region和Endpoint对照表

经典网络情况下各地域均支持HTTPS访问。各地域Endpoint的内外网设置如下。

VPC网络下Region和Endpoint对照表

如何使用访问域名

• 关于OSS域名的构成规则以及如何使用内网和外网访问OSS，请参见OSS访问域名使用规则。
• 如果您是ECS用户，需要使用内网地址访问同地域的OSS，请参见ECS实例通过OSS内网地址访问OSS资源。

金融云下Region和Endpoint对照表

在金融云下的ECS访问OSS只能使用如下的Endpoint：

金融云公网下Region和Endpoint对照表

在金融云公网下的ECS访问OSS只能使用如下的Endpoint：

OSS域名构成规则

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

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

内网、外网访问域名可直接使用，无需额外配置，而传输加速域名使用前需先开启Bucket的传输加速功能。详情请参见设置传输加速。

通过外网访问OSS服务

外网指的是互联网。通过外网访问产生的流入流量（写）是免费的，流出流量（读）是收费的。

外网访问OSS有如下两种方式：

• 访问方式一：访问时以URL的形式来表示OSS的资源。OSS的URL构成如下：
  <Schema>://<Bucket>.<外网Endpoint>/<Object> 

  • Schema：HTTP或者为HTTPS。
  • Bucket：OSS存储空间名称。
  • 外网Endpoint：Bucket所在数据中心供外网访问的Endpoint，各地域Endpoint详情请参见访问域名和数据中心。
  • Object：上传到OSS上的文件的访问路径。

  示例：如果您的Region为华东1（杭州），Bucket名称为examplebucket，Object访问路径为example/example.txt，那么您的外网访问地址为https://examplebucket.oss-cn-hangzhou.aliyuncs.com/example/example.txt。

  注意

  • 此域名仅当文件支持匿名访问时使用，若文件为私有，则还需要增加签名信息。
  • OSS访问域名需携带Object访问路径才可以被访问，若仅访问域名，例如examplebucket.oss-cn-hangzhou.aliyuncs.com，会有报错提示。若您希望直接访问OSS访问域名，可以通过静态网站托管来实现。

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

  <img src="https://examplebucket.oss-cn-hangzhou.aliyuncs.com/example/example.png" />

• 访问方式二： 通过OSS SDK配置外网访问域名。

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

  以Java SDK为例，对华东1的Bucket进行操作时，需要在对类实例化时设置Endpoint：

  String accessKeyId = "";
    String accessKeySecret = "";
    String endpoint = "oss-cn-hangzhou.aliyuncs.com";
    OSSClient client = new OSSClient(endpoint, accessKeyId, accessKeySecret);

通过内网访问OSS服务

内网访问OSS有如下两种方式：

• 访问方式一：在访问的时候以URL的形式来表示OSS的资源。OSS的URL构成如下。
  <Schema>://<Bucket>.<内网Endpoint>/<Object> 

  • Schema：HTTP或者为HTTPS。
  • Bucket：OSS存储空间名称。
  • 内网Endpoint：Bucket所在数据中心供同地域ECS访问的内网Endpoint，各地域Endpoint详情请参见访问域名和数据中心。
  • Object：上传到OSS上的文件的访问路径。

  示例：如您的Bucket名称为examplebucket，Region为华东1（杭州），Object名称为example/example.txt，那么您的内网访问地址为https://examplebucket.oss-cn-hangzhou-internal.aliyuncs.com/example/example.txt。

• 访问方式二：通过ECS使用OSS SDK配置内网Endpoint。
  以Java SDK为例，对华东1地域的Bucket进行操作时，需要将endpoint设置为华东1地域的内网Endpoint。

  String accessKeyId = "";
    String accessKeySecret = "";
    String endpoint = "oss-cn-hangzhou-internal.aliyuncs.com";
    OSSClient client = new OSSClient(endpoint, accessKeyId, accessKeySecret);

  同一个Region的ECS和OSS之间内网互通，不同Region的ECS和OSS之间内网不互通。例如您的OSS有两个Bucket，并且购买了华北2（北京）的ECS：

  • 其中一个Bucket名称为beijingres，Region为华北2（北京），那么在华北2的ECS中可以使用https://beijingres.oss-cn-beijing-internal.aliyuncs.com来访问beijingres的资源。
  • 另外一个Bucket名称为qingdaores，Region为华北1（青岛），那么在华北2的ECS用内网地址https://qingdaores.oss-cn-qingdao-internal.aliyuncs.com是无法访问OSS的，必须使用外网地址https://qingdaores.oss-cn-qingdao.aliyuncs.com。

使用传输加速域名访问OSS

OSS传输加速支持数据上传、下载加速，可优化跨国、跨洋数据上传、下载体验。使用传输加速域名前，需先开启传输加速功能。开启后，您只需将外网Endpoint替换为传输加速Endpoint，即可实现数据传输加速。

更多关于传输加速功能的介绍请参见传输加速。

使用IPv6地址访问OSS

IPv6是互联网工程任务组IETF（Internet Engineering Task Force）设计的用于替代现行版本IP协议（IPv4）的下一代IP协议，它可以让地球上的每一粒沙子都拥有地址。目前OSS已支持通过IPv6、IPv4双栈域名访问。

您的IPv6、IPv4客户端均可以使用OSS提供的统一双栈域名访问您的存储空间。您的DNS服务器将按照您使用的协议版本解析对应协议的OSS服务器地址给您。例如杭州地域的Endpoint为：cn-hangzhou.oss.aliyuncs.com，若您的Bucket名称为myiotdata，则IPv6、IPv4客户端都可通过https://myiotdata.cn-hangzhou.oss.aliyuncs.com访问。

获取OSS内网地址

• 通过OSS控制台获取

  登录OSS管理控制台，打开指定Bucket的概览页面，在访问域名区域查看Bucket的Endpoint和Bucket域名，如下图所示。

• 通过固定格式获取

  OSS的访问地址为固定格式：BucketName.Endpoint。其中，BucketName为您的存储空间名称，Endpoint为存储空间所在的地域对应的访问域名。详情请参见OSS访问域名使用规则。

同地域ECS实例访问OSS资源

与OSS同地域的ECS实例可以通过以下方式使用内网访问OSS资源：

• 通过URL直接访问OSS资源
  您可以直接使用OSS资源的内网地址访问有权限的OSS资源。例如，杭州地域某Bucket名为test，根目录下有个Object名为1.jpg，处于公共读状态。此时，杭州地域的ECS实例均可以使用http://test.oss-cn-hangzhou-internal.aliyuncs.com/1.jpg访问此Object。因此，您可以将OSS资源的访问URL嵌入到您的网站中，提供给同地域的ECS用户或已通过专线接入到与OSS同地域内网的用户访问。

  警告 为了您的数据安全，不建议您将OSS资源设置为公共读或公共读写，您可以通过Bucket Policy授权给指定用户访问您的资源。
• 通过ossbrowser访问OSS资源

  您可以在配置ossbrowser访问参数的时候，将Endpoint设置为自定义，并填写OSS的内网Endpoint地址。详情请参见ossbrowser。

• 通过ossutil访问OSS资源

  您可以在配置ossutil访问参数的时候，将Endpoint设置为OSS的内网Endpoint地址。详情请参见ossutil。

• 通过SDK访问OSS资源
  SDK初始化client的时候，Endpoint配置OSS内网对应的Endpoint即可。

  • Java SDK
    String endpoint = "http://oss-cn-hangzhou-internal.aliyuncs.com";//以华东 1为例
    String accessKeyId = "";
    String accessKeySecret = "";
    OSSClient client = new OSSClient(endpoint, accessKeyId, accessKeySecret);          

    更多详情请参见Java SDK初始化。

  • PHP SDK
    $accessKeyId = "";
    $accessKeySecret = "";
    $endpoint = "<您选定的oss数据中心访问域名，例如http: oss-cn-hangzhou-internal="" aliyuncs="" com="">";           

    更多详情请参见PHP SDK初始化。

  • Python SDK
    auth = oss2.Auth('', '')
    endpoint = 'http://oss-cn-hangzhou-internal.aliyuncs.com' # 您选定的OSS数据中心访问域名，假设Bucket处于杭州地域
    bucket = oss2.Bucket(auth, endpoint, 'BucketName')         

    更多详情请参见Python SDK初始化。

  • .NET SDK
    const string accessKeyId = "";
    const string accessKeySecret = "";
    const string endpoint = "http://oss-cn-hangzhou-internal.aliyuncs.com";
    var ossClient = new OssClient(endpoint, accessKeyId, accessKeySecret);   

    更多详情请参见.NET SDK初始化。

  • C SDK
    ptions->config = oss_config_create(options->pool);
    aos_str_set(&options->config->endpoint, "http://oss-cn-hangzhou-internal.aliyuncs.com");
    aos_str_set(&options->config->access_key_id, "");
    aos_str_set(&options->config->access_key_secret, "");
    options->config->is_cname = 0;
    options->ctl = aos_http_controller_create(options->pool, 0);         

    更多详情请参见C SDK初始化。

通过ECS反向代理访问OSS资源

以上步骤配置完成后，您的用户将通过您的ECS公网地址访问您的OSS资源。当用户访问时，ECS实例通过内网向OSS请求资源，之后再返回给用户。

用户所在地

如果您的OSS资源需要开放给其他用户访问，且希望用户有良好的访问体验，就必须考虑用户访问时的网络延迟。除了通信线路的质量外，距离是影响网络延迟的一个重要因素。

例如以杭州的用户为例，使用ping命令可以测试出其访问不同地域OSS数据中心的延迟情况。

可以看出，距离访问的数据中心越远，数据返回所需时间越长。所以，在选择地域的时候，尽量考虑离用户更近的地域。

云产品之间的关系

如果您需要将OSS作为其他阿里云产品的数据源，则需要根据其他云产品的地域去选择OSS的地域。当其他云产品和OSS在同一地域时，可以通过VPC地址访问OSS。访问时不会产生流量费用，且访问速度较外网会更快。

资源价格

因各地域的优惠政策不同，某些地域的资源包价格会更优惠。选择OSS地域的时候可优先考虑资源包价格更优惠的地域。

产品功能

OSS的新功能在发布初期会选择部分地域进行公测，若您希望试用这些新功能，需在指定地域创建存储空间。