在兼容亚马逊S3的第三方应用中使用COS的通用配置
原创
本文分享自微信公众号 - 腾讯云存储
Amazon Simple Storage Service（Amazon S3，下文简称 S3）是 AWS 最早推出的云服务之一，经过多年的发展，S3 协议在对象存储行业事实上已经成为标准。腾讯云对象存储 COS（下文简称 COS）提供了兼容 S3 的实现方案，因此您可以在大部分兼容 S3 应用中直接使用 COS 服务。本文将重点介绍如何将此类应用配置为使用 COS 服务。
一、准备工作
1、确认应用是否可以使用 COS 服务
- 如果您在应用的说明中看到类似
S3 Compatible字样，那么大多数情况可以使用 COS 服务。如果您在实际使用过程中发现应用的某些功能无法正常使用，您可以向我们 提交工单 进行咨询，在提交工单时，请说明您是从该文档中看到的指引，并提供相关应用的名称和截图等信息，以便我们可以更快的帮您解决问题。 - 如果您的应用只说明支持
Amazon S3，这表明该应用可以使用 S3 服务，但能否使用 COS 服务，还需要在相关的配置中进一步尝试，本文也会在后续的配置说明中做进一步的说明。
2、准备 COS 服务
步骤1：注册腾讯云账号并完成实名认证，开通 COS 服务。
步骤2：准备 APPID 和访问密钥
在访问管理控制台的 API 密钥管理 页面中获取并记录 APPID、SecretId 和 SecretKey。
步骤3：创建存储桶
部分应用内置创建存储桶的过程，如果您希望由应用去创建存储桶，您可以忽略此步骤。
- 在 对象存储控制台 左侧导航栏中单击【存储桶列表】，进入存储桶管理页。
- 单击【创建存储桶】，输入存储桶信息。
- 名称：存储桶名称，如 examplebucket。
- 所属地域：存储桶存放地域，选择与您最近的一个地区，例如我在 “深圳”，地域可以选择 “广州”。
- 访问权限：存储桶访问权限，此处我们选择“私有读写”。
3. 单击【创建存储桶】，输入存储桶信息。
二、在应用中配置 COS 服务
1. 基本配置
大部分应用在配置使用的存储服务时，都有类似的配置项，下面列举这些配置项的常见名称及相关说明：
配置项的常见名称 | 相关说明 |
|---|---|
提供商/服务提供商/存储服务提供商/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.com或https://cos.<Region>.myqcloud.com。如果服务端点是不可配置的或没有服务端点配置项，那么您的应用不能使用 COS 服务。 |
Access Key/Access Key ID 等 | 这里填写 步骤2 中记录的 SecretId。 |
Secret Key/Secret/Secret Access Key 等 | 这里填写 步骤2 中记录的 SecretKey。 |
地域/Region 等 | 选择默认、自动、Auto 或 Automatic。 |
存储桶/Bucket 等 | 选择或输入现有的存储桶名称，格式为<BucketName-APPID>，例如examplebucket-1250000000，其中 BucketName 为 步骤3 中创建存储桶时填写的存储桶名称，APPID 为 步骤2 中记录的 APPID。如上文所描述，这里的存储桶将限定在服务地址所指定的地域中，其他地域的存储桶将不会被列出或无法正常使用。如果您需要创建新的存储桶，那么新创建的存储桶名字也需要符合前面所讲的<BucketName-APPID> 格式，否则就无法正常创建存储桶。 |
2. 其他项与高级配置说明
部分应用除了上述基本配置外，还有一些其他项与高级配置，下面将提供部分 COS 的功能说明，以便您更好的在应用中使用 COS 服务。
- 服务端口与协议 COS 服务支持 HTTP 协议和 HTTPS 协议，均使用协议默认的80和443端口，基于安全考虑，我们建议您优先通过 HTTPS 协议使用 COS 服务。
- Path-Style 与 Virtual Hosted-Style COS 同时支持两种使用风格。
- AWS V2 签名与 AWS V4 签名 COS 同时支持两种签名格式。
三、结语
COS 不保证与 S3 的完全兼容，如果您在应用中使用 COS 服务时遇到任何问题，欢迎向我们提交工单咨询，在提交工单时，请说明您是从该文档中看到的指引，并提供相关应用的名称和截图等信息，以便我们可以更快的帮您解决问题。
欢迎加入对象存储COS实践交流QQ群：1053187478
1. QQ群定位：技术交流、开发者互助与生态合作。
2. 加入QQ群的好处：在COS使用过程中如有任何疑问或建议，可以与腾讯云存储官方及群中的开发者沟通交流。
3. 哪些人可以加入：如果您是COS用户，或者对云存储技术感兴趣，都欢迎加入我们。
原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。
如有侵权，请联系 cloudcommunity@tencent.com 删除。
原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。
如有侵权，请联系 cloudcommunity@tencent.com 删除。