一、确认应用是否可以使用 COS 服务
·如果你在应用的说明中看到类似S3 Compatible字样,那么大多数情况可以使用 COS 服务。如果你在实际使用过程中发现应用的某些功能无法正常使用,你可以 联系我们。联系时,请说明你是从该文档中看到的指引,并提供相关应用的名称和截图等信息,以便我们可以更快地帮你解决问题。
·如果你的应用只说明支持Amazon S3,这表明该应用可以使用 S3 服务,但能否使用 COS 服务,还需要在相关的配置中进一步尝试,这篇也会在后续的配置说明中做进一步的说明。
二、步骤1:注册腾讯云账号
(如果已在腾讯云注册,可忽略此步骤。)
三、步骤2:完成实名认证
(如果已完成,可忽略此步骤。)
详细认证流程,请参见实名认证介绍。
四、步骤4:准备 APPID 和访问密钥
在访问管理控制台的 API 密钥管理 页面中获取并记录 APPID、SecretId 和 SecretKey。详情请参见 主账号访问密钥管理。
五、步骤5:创建存储桶
参见 创建存储桶 创建一个存储桶。
部分应用内置创建存储桶的过程,如果你希望由应用去创建存储桶,你可以忽略此步骤。
六、基本配置
大部分应用在配置使用的存储服务时,都有类似的配置项,下面列举这些配置项的常见名称及相关说明:
注意:说明:
注意:如果你在配置过程中有任何疑问,也可以 联系我们。联系时,请说明你是从该文档中看到的指引,并提供相关应用的名称和截图等信息,以便我们可以更快地帮你解决问题。
| 配置项的常见名称 | 相关说明 |
| 提供商/服务提供商/存储服务提供商/Service Provider/Storage Provider/Provider 等 | 这里主要是选择应用应使用哪种存储,可能存在以下几种情况:如果该选项中有类似 S3 兼容存储/S3 Compatible 等字样的选项,那么优先使用这个选项。如果只有 amazon web services/AWS/Amazon S3 等字样,那么先使用这个选项,在后面的服务端点/服务地址/服务 URL/Endpoint/Custom Endpoint/Server URL 等配置中,需留意这些配置项的相关说明。如果没有类似选项,但是在应用的说明中有提到支持 S3 服务或 S3 兼容服务,那么你可以继续后面的服务端点/服务地址/服务 URL/Endpoint/Custom Endpoint/Server URL 等配置,且需留意这些配置项的相关说明。如果是其他情况,很抱歉,该应用可能不能使用 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 等 | 这里填写 步骤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 服务。
·COS 支持 Virtual Hosted Style 风格。
注意:2024年1月1日后创建的存储桶,不支持使用 path-style 域名,仅支持使用 virtual-hosted-style 域名。此前已创建的存储桶不受影响,但建议你优先使用 virtual hosted style 域名。
·AWS V2 签名与 AWS V4 签名
COS 同时支持两种签名格式。
八、结语
COS 不保证与 S3 的完全兼容,如果你在应用中使用 COS 服务时遇到任何问题,你可以 联系我们。联系时,请说明你是从该文档中看到的指引,并提供相关应用的名称和截图等信息,以便我们可以更快地帮你解决问题。
当然,COS 不仅提供以上应用和服务,还提供多款热门开源应用,并集成腾讯云 COS 插件,欢迎点击 “此处” 一键启动,立即使用!