使用 TurboS3接入点前,请仔细阅读以下限制条件,避免因配置不当导致功能不可用。
相关产品
文件存储 产品页,含版本规格、价格与购买入口。
一、文件系统要求
| 限制项 |
说明 |
| 文件系统类型 |
仅支持 CFS Turbo 系列,通用系列文件系统不支持 S3接入点。 |
| 文件系统状态 |
文件系统必须处于可用状态才能创建接入点。 |
二、网络要求
| 限制项 |
说明 |
| 网络类型 |
仅支持 VPC 私有网络访问,不支持基础网络访问和公网访问。 |
| 可用区 |
接入点所在 VPC 及子网必须与文件系统同可用区。 |
| 子网 IP 数量 |
创建接入点时,所选子网下可用 IP 数量不得少于10个。 |
| 访问域名 |
固定为 https://turbos3.internal.tencentcfs.com,仅限 VPC 内部访问。 |
注意:接入点域名为内网域名,无法从公网直接访问。如需从非 VPC 环境访问,请提前规划网络连接方案(如专线、VPN 等)。
三、接入点配置限制
| 限制项 |
说明 |
| 绑定 VPC 数量 |
每个接入点最多绑定100个 VPC(含创建时指定的主 VPC)。 |
| 数量限制 |
同一 VPC 内如果需要创建大于1个 CFS Turbo 的 S3接入点。在涉及访问 headbucket 接口时,需要手动配置 turbos3.internal.tencentcfs.com 的 host,到指定 IP,避免冲突。 |
| 配置不可修改项 |
接入点的可用区、VPC、子网在创建后均不可修改。 |
| 鉴权策略选项 |
仅支持仅私有读写、公有读私有写、公有读写三种,不可自定义。 |
四、策略配置限制
| 限制项 |
说明 |
| 策略操作条件 |
只有接入点状态为可用时,才能创建新的权限策略。 |
| 策略编辑条件 |
策略状态为可用或已失效时可进行编辑操作。 |
| Secret Key 安全 |
Secret Key 在提交后不会明文展示,请在创建前备好密钥信息。 |
| 资源路径格式 |
指定资源路径时,前缀固定为 /<文件系统 ID>/,用户只需填写文件系统内的子路径部分。 |
五、删除限制
| 限制项 |
说明 |
| 删除接入点前提 |
接入点下必须无任何权限策略,才可执行删除。 |
| 状态限制 |
仅可用(且无策略)和失败状态的接入点可删除;创建中和删除中状态不可操作。 |
| 不可恢复 |
接入点删除后无法恢复,已绑定的 VPC 访问权限随即失效。 |
六、支持的 S3接口类型
| 接口类型 |
说明 |
| delete_object |
支持传入参数:Bucket(必填)、Key(必填) |
| delete_objects |
支持传入参数:Bucket(必填)、Delete(必填) |
| get_object |
支持传入参数:Bucket(必填)、Key(必填)、IfMatch、IfModifiedSince、IfNoneMatch、IfUnmodifiedSince、Range、ResponseCacheControl、ResponseContentDisposition、ResponseContentEncoding、ResponseContentLanguage、ResponseContentType、ResponseExpires、PartNumber |
| head_bucket |
支持传入参数:Bucket(必填) |
| head_object |
支持传入参数:Bucket(必填)、Key(必填)、IfMatch、IfModifiedSince、IfNoneMatch、IfUnmodifiedSince、Range、PartNumber |
| list_objects |
支持传入参数:Bucket(必填)、Delimiter、EncodingType、Marker、MaxKeys、Prefix |
| list_objects_v2 |
支持传入参数:Bucket(必填)、Delimiter、EncodingType、MaxKeys、Prefix、ContinuationToken、StartAfter |
| put_object |
支持传入参数:Bucket(必填)、Key(必填)、Body说明:如果要创建目录,Key 以 / 结尾,保持 body 内容为空即可。 |
| CopyObject |
支持传入参数:Bucket(必填)、CopySource(必填)、Key(必填)、CopySourceIfMatch、CopySourceIfModifiedSince、CopySourceIfNoneMatch、CopySourceIfUnmodifiedSince |
| CreateMultipartUpload |
支持传入参数:Bucket(必填)、Key(必填) |
| upload_part |
支持传入参数:Bucket(必填)、Key(必填)、PartNumber(必填)、UploadId(必填)、Body |
| upload_part_copy |
支持传入参数:Bucket(必填)、CopySource(必填)、Key(必填)、PartNumber(必填)、UploadId(必填)、CopySourceIfMatch、CopySourceIfModifiedSince、CopySourceIfNoneMatch、CopySourceIfUnmodifiedSince 、CopySourceRange |
| CompleteMultipartUpload |
支持传入参数:Bucket(必填)、Key(必填)、UploadId(必填)、MultipartUpload |
| AbortMultipartUpload |
支持传入参数:Bucket(必填)、Key(必填)、UploadId(必填) |
| list_multipart_uploads |
支持传入参数:Bucket(必填)、Delimiter、EncodingType、KeyMarker、MaxUploads、Prefix、UploadIdMarker |
| ListParts |
支持传入参数:Bucket(必填)、Key(必填)、UploadId(必填)、MaxParts、PartNumberMarker |