在兼容 S3 的第三方应用中使用 COS 的通用配置

最后更新时间:2020-11-23 10:41:50

    Amazon Simple Storage Service(Amazon S3,下文简称 S3)是 AWS 最早推出的云服务之一,经过多年的发展,S3 协议在对象存储行业事实上已经成为标准。腾讯云对象存储 COS(下文简称 COS)提供了兼容 S3 的实现方案,因此您可以在大部分兼容 S3 应用中直接使用 COS 服务。本文将重点介绍如何将此类应用配置为使用 COS 服务。

    准备工作

    确认应用是否可以使用 COS 服务

    • 如果您在应用的说明中看到类似S3 Compatible字样,那么大多数情况可以使用 COS 服务。如果您在实际使用过程中发现应用的某些功能无法正常使用,您可以向我们 提交工单 进行咨询,在提交工单时,请说明您是从该文档中看到的指引,并提供相关应用的名称和截图等信息,以便我们可以更快的帮您解决问题。
    • 如果您的应用只说明支持Amazon S3,这表明该应用可以使用 S3 服务,但能否使用 COS 服务,还需要在相关的配置中进一步尝试,本文也会在后续的配置说明中做进一步的说明。

    准备 COS 服务

    步骤1:注册腾讯云账号

    (如果已在腾讯云注册,可忽略此步骤。)

    步骤2:完成实名认证

    (如果已完成,可忽略此步骤。)

    详细认证流程,请参见 实名认证介绍。未进行实名认证的用户无法购买中国境内的 COS 服务。

    步骤3:开通 COS 服务

    步骤4:准备 APPID 和访问密钥

    在访问管理控制台的 API 密钥管理 页面中获取并记录 APPIDSecretIdSecretKey

    步骤5:创建存储桶

    部分应用内置创建存储桶的过程,如果您希望由应用去创建存储桶,您可以忽略此步骤。

    1. 对象存储控制台 左侧导航栏中单击【存储桶列表】,进入存储桶管理页。
    2. 单击【创建存储桶】,输入存储桶信息。
      • 名称:存储桶名称,如 examplebucket。
      • 所属地域:存储桶存放地域,选择与您最近的一个地区,例如我在 “深圳”,地域可以选择 “广州”。
      • 访问权限:存储桶访问权限,此处我们选择“私有读写”。
    3. 单击【确定】,即可创建存储桶。

    在应用中配置 COS 服务

    基本配置

    大部分应用在配置使用的存储服务时,都有类似的配置项,下面列举这些配置项的常见名称及相关说明:

    如果您在配置过程中有任何疑问,也可以向我们 提交工单 咨询,在提交工单时,请说明您是从该文档中看到的指引,并提供相关应用的名称和截图等信息,以便我们可以更快的帮您解决问题。

    配置项的常见名称 相关说明
    提供商/服务提供商/
    存储服务提供商/
    Service Provider/
    Storage Provider/
    Provider 等
    这里主要是选择应用应使用哪种存储,可能存在以下几种情况:
  • 如果该选项中有类似 S3 兼容存储/S3 Compatible等字样的选项,那么优先使用这个选项。
  • 如果只有 amazon web services/AWS/Amazon S3 等字样,那么先使用这个选项,但是在后面的配置中需留意我们的进一步说明。
  • 如果没有类似选项,但是在应用的说明中有提到支持 S3 服务或 S3 兼容服务,那么您可以继续后面的配置,但同样需要留意我们的进一步说明。
  • 如果是其他情况,很抱歉,该应用可能不能使用 COS 服务。
  • 服务端点/服务地址/服务 URL/Endpoint/Custom Endpoint/Server URL 等 这里用于填写 S3 兼容服务的服务地址,在使用 COS 服务时,这里填写 COS 的服务地址,形式为:cos.<Region>.myqcloud.com
    https://cos.<Region>.myqcloud.com
    是否需要填写https://,根据具体的应用有所不同,您可以自行尝试。其中<Region>代表 COS 的可用地域。
    在应用中,您只能在服务地址中指定的地域创建或选择存储桶。
  • 例如您的存储桶在广州地域,那么服务地址应当配置为cos.ap-guangzhou.myqcloud.com,如果您配置成其他地域,那么在应用中您无法找到广州地域下的存储桶。
  • 如果应用的服务提供商中只能选择Amazon S3,并且服务端点是可以配置的,那么您可以将服务端点修改为前述的cos.<Region>.myqcloud.comhttps://cos.<Region>.myqcloud.com
  • 如果服务端点是不可配置的或没有服务端点配置项,那么您的应用不能使用 COS 服务。
  • Access Key/Access Key ID 等 这里填写 步骤4 中记录的 SecretId
    Secret Key/Secret/
    Secret Access Key 等
    这里填写 步骤4 中记录的 SecretKey
    地域/Region 等 选择默认、自动、Auto 或 Automatic。
    存储桶/Bucket 等 选择或输入现有的存储桶名称,格式为<BucketName-APPID>,例如examplebucket-1250000000,其中 BucketName步骤5 中创建存储桶时填写的存储桶名称,APPID步骤4 中记录的 APPID
    如上文所描述,这里的存储桶将限定在服务地址所指定的地域中,其他地域的存储桶将不会被列出或无法正常使用。如果您需要创建新的存储桶,那么新创建的存储桶名字也需要符合前面所讲的<BucketName-APPID> 格式,否则就无法正常创建存储桶。

    其他项与高级配置说明

    部分应用除了上述基本配置外,还有一些其他项与高级配置,下面将提供部分 COS 的功能说明,以便您更好的在应用中使用 COS 服务。

    • 服务端口与协议
      COS 服务支持 HTTP 协议和 HTTPS 协议,均使用协议默认的80和443端口,基于安全考虑,我们建议您优先通过 HTTPS 协议使用 COS 服务。
    • Path-Style 与 Virtual Hosted-Style
      COS 同时支持两种使用风格。
    • AWS V2 签名与 AWS V4 签名
      COS 同时支持两种签名格式。

    结语

    COS 不保证与 S3 的完全兼容,如果您在应用中使用 COS 服务时遇到任何问题,欢迎向我们 提交工单 咨询,在提交工单时,请说明您是从该文档中看到的指引,并提供相关应用的名称和截图等信息,以便我们可以更快的帮您解决问题。

    Was this page helpful?

    本页内容是否解决了您的问题?

    • 完全没帮助
    • 文档较差
    • 文档一般
    • 文档不错
    • 文档很好
    反馈
    帮助