请求费用

更新时间:
复制 MD 格式

您对OSS的所有访问和管理操作,无论是通过内网还是外网,无论是通过调用API、使用SDK、通过OSS管理控制台、使用命令行工具ossutil还是图形化工具ossbrowser等方式,无论访问的是公共读还是私有文件,其实质都是基于OSS API。OSS将根据您实际调用的API次数收取相应的请求费用。如果您的业务涉及访问冷归档、深度冷归档存储类型的数据,需要对这部分数据进行解冻,解冻过程还会产生数据取回请求费用。

计费单价

本文仅说明相关请求费用计费项和付费方式。有关计费项的定价详情,请参见OSS产品定价。

计费项

以下计费项中,返回码为2xx、3xx的请求会产生请求费用,返回码为4xx、5xx的请求不会产生请求费用。

Put类型请求

计费项

计费项Code

计费规则

Put类型请求

PutRequest

根据OSS API的Put类请求次数计算请求费用。

Put类型请求包括数据上传、拷贝、删除等操作,以及对 Table Bucket 的操作。请参见下表获取Put类型具体包含的API请求。

Put类API请求

  • 对象 Bucket 的API请求

    API请求

    对应操作

    PutBucket

    创建存储空间(Bucket)。

    GetBucket (ListObject)、GetBucketV2 (ListObjectsV2)

    列举所有Object。

    PutBucketACL

    为Bucket设置读写权限ACL。

    PutBucketInventory

    为Bucket配置清单规则。

    DeleteBucketInventory

    删除Bucket中指定的清单任务。

    PutBucketLogging

    开启日志转存。

    DeleteBucketLogging

    关闭日志转存。

    PutBucketWebsite

    为Bucket设置静态网站托管模式并设置跳转规则(RoutingRule)。

    DeleteBucketWebsite

    关闭Bucket的静态网站托管模式以及跳转规则。

    PutBucketReferer

    为Bucket设置Referer的访问白名单以及是否允许Referer字段为空。

    PutBucketLifecycle

    设置生命周期规则。

    CommitTransition

    通过生命周期规则转换存储类型。

    重要

    通过生命周期将低频、归档、冷归档转为其他类型的Put类型请求费用高于从标准存储类型转为低频访问、归档、冷归档、深度冷归档类型的Put类型请求费用。

    ExpireObject

    通过生命周期删除Object。

    重要
    • 在中国内地各地域,通过生命周期规则删除低频访问、归档、冷归档的Put类请求费用高于删除标准存储类型Object的Put类请求费用。通过生命周期规则删除深度冷归档存储类型Object,不收取Put类请求费用。

    • 在中国香港以及海外地域,通过生命周期规则删除各存储类型Object时不收取Put类请求费用。

    DeleteBucketLifecycle

    删除生命周期规则。

    DeleteBucket

    删除Bucket。

    PutObject

    上传Object。

    CopyObject

    在同一地域下相同或不同Bucket之间拷贝Object。

    重要

    按Object源存储类型的PUT类型请求次数计费。

    AppendObject

    以追加写的方式上传Object。

    DeleteObject

    删除单个Object。

    DeleteMultipleObjects

    删除多个Object。

    PutObjectACL

    为Object设置读写权限ACL。

    PostObject

    通过HTML表单上传的方式上传Object。

    PutSymlink

    创建软链接。

    RestoreObject

    解冻归档类型Object。

    CleanRestoredObject

    结束冷归档或者深度冷归档的解冻状态,文件副本不再产生临时存储费用。

    InitiateMultipartUpload

    初始化MultipartUpload事件。

    UploadPart

    根据指定的Object名称和UploadId来分片上传数据。

    重要

    按分片数(partNumber)计算PUT请求数量,每上传一个分片需要调用一次UploadPart接口,即一个分片对应一次API调用,分片数量直接等于PUT请求调用次数(分片数 = 接口调用次数 = PUT请求数)。例如,上传一个大文件并分成1000个分片(partNumber=1000),则需要调用1000次UploadPart接口,产生1000个PUT请求。

    AbortMultipartUpload

    取消MultipartUpload事件并删除对应的碎片数据。

    重要
    • 在中国内地各地域,通过生命周期规则删除低频访问、归档、冷归档类型碎片的Put类请求费用高于删除标准存储类型碎片的Put类请求费用。通过生命周期规则删除深度冷归档存储类型碎片,不收取Put类请求费用。

    • 在中国香港以及海外地域,通过生命周期规则删除各存储类型碎片时不收取Put类请求费用。

    UploadPartCopy

    分片拷贝。

    重要
    • 按分片数(partNumber)计算PUT请求数量,每拷贝一个分片需要调用一次UploadPartCopy接口,即一个分片对应一次API调用,分片数量直接等于PUT请求调用次数(分片数 = 接口调用次数 = PUT请求数)。例如,通过拷贝方式上传并分成1000个分片(partNumber=1000),则需要调用1000次UploadPartCopy接口,产生至少1000个PUT请求。

    • 按Object目标存储类型的PUT类型请求次数计费。

    ListMultipartUploads

    列举所有执行中的Multipart Upload事件,即已经初始化但还未完成(Complete)或者还未中止(Abort)的Multipart Upload事件。

    ListParts

    列举指定Upload ID所属的所有已经上传成功Part。

    PutBucketReplication

    为Bucket配置数据复制规则。

    DeleteBucketReplication

    停止某个Bucket的数据复制任务并删除Bucket的复制配置。

    PutBucketCors

    添加CORS配置。

    DeleteBucketCors

    删除CORS配置。

    CompleteMultipartUpload

    完成分片上传。

    InitiateBucketWorm

    为Bucket创建合规保留策略。

    AbortBucketWorm

    删除未锁定的合规保留策略。

    CompleteBucketWorm

    锁定合规保留策略。

    ExtendBucketWorm

    延长已锁定的合规保留策略对应Bucket中Object的保留天数。

    PutBucketVersioning

    为Bucket开启版本控制。

    ListObjectVersions(GetBucketVersions)

    列出Bucket中包括删除标记(Delete Marker)在内的所有Object的版本信息。

    PutBucketPolicy

    设置Bucket Policy。

    DeleteBucketPolicy

    删除Bucket Policy。

    PutBucketTags

    为Bucket添加或修改标签。

    DeleteBucketTags

    删除Bucket标签。

    PutBucketEncryption

    为Bucket配置加密规则。

    DeleteBucketEncryption

    删除Bucket加密规则。

    PutBucketRequestPayment

    为Bucket设置请求者付费模式。

    PutObjectTagging

    为Object添加或修改标签。

    DeleteObjectTagging

    删除Object标签。

    PutLiveChannel

    创建一个LiveChannel。

    DeleteLiveChannel

    删除指定的LiveChannel。

    PutLiveChannelStatus

    切换LiveChannel状态。

    PostVodPlaylist

    为LiveChannel生成用于点播的播放列表。

    PutStyle

    新增图片样式。

    ListStyle

    查询某个Bucket下已创建的所有样式。

    DeleteStyle

    删除某个Bucket下指定的图片样式。

    WriteGetObjectResponse

    自定义返回数据和响应标头。

    PutBucketTransferAcceleration

    为Bucket配置传输加速。

    PutBucketRTC

    为已有的跨区域复制规则开启或关闭数据复制时间控制(RTC)功能。

    ListUserDataRedundancyTransition

    列举用户级别的存储冗余转换任务。

    ListBucketDataRedundancyTransition

    列举Bucket级别的存储冗余转换任务。

    CreateBucketDataRedundancyTransition

    创建Bucket的存储冗余转换任务。

    DeleteBucketDataRedundancyTransition

    删除Bucket的存储冗余转换任务。

    PutBucketAccessMonitor

    配置Bucket的访问跟踪状态。

    OpenMetaQuery

    为Bucket开启元数据索引功能。

    DoMetaQuery

    查询满足指定条件的Object。

    CloseMetaQuery

    关闭Bucket的元数据管理功能。

    InitUserAntiDDosInfo

    创建高防OSS实例。

    UpdateUserAntiDDosInfo

    更改高防OSS实例状态。

    InitBucketAntiDDosInfo

    初始化Bucket防护。

    UpdateBucketAntiDDosInfo

    更新Bucket防护状态。

    ListBucketAntiDDosInfo

    获取Bucket防护信息列表。

    PutBucketResourceGroup

    为Bucket配置资源组。

    CreateCnameToken

    创建域名所有权验证所需的CnameToken。

    PutCname

    为某个Bucket绑定CNAME。

    ListCname

    获取某个Bucket下绑定的所有CNAME列表。

    DeleteCname

    删除已绑定的CNAME。

    PutBucketArchiveDirectRead

    为Bucket开启或关闭归档直读。

    PutBucketHttpsConfig

    为Bucket开启或关闭TLS版本设置。

    CreateAccessPoint

    为Bucket创建接入点。

    DeleteAccessPoint

    删除Bucket的接入点。

    ListAccessPoints

    列举Bucket的所有接入点。

    PutAccessPointPolicy

    为接入点配置访问策略。

    DeleteAccessPointPolicy

    删除接入点的访问策略。

    CreateAccessPointForObjectProcess

    创建对象FC接入点。

    DeleteAccessPointForObjectProcess

    删除对象FC接入点。

    ListAccessPointsForObjectProcess

    获取用户级别的对象FC接入点信息。

    PutAccessPointConfigForObjectProcess

    修改对象FC接入点配置。

    PutAccessPointPolicyForObjectProcess

    为对象FC接入点配置权限策略。

    DeleteAccessPointPolicyForObjectProcess

    删除对象FC接入点的权限策略。

    PutBucketPublicAccessBlock

    为Bucket开启阻止公共访问。

  • Table Bucket 的API请求

    重要

    OSS Table Bucket 目前处于公测阶段,公测期间不收取费用;自北京时间 2026 年 12 月 30 日起将正式启动商业化收费。请及时关注产品账单金额,详情请参见官网公告。

    API请求

    对应操作

    CreateTableBucket

    创建 Table Bucket。

    DeleteTableBucket

    删除 Table Bucket。

    PutTableBucketEncryption

    设置 Table Bucket 加密配置。

    DeleteTableBucketEncryption

    删除 Table Bucket 加密配置。

    PutTableBucketPolicy

    设置 Table Bucket 访问策略。

    DeleteTableBucketPolicy

    删除 Table Bucket 访问策略。

    PutTableBucketMaintenanceConfiguration

    设置 Table Bucket 维护配置。

    CreateNamespace

    创建 Namespace。

    DeleteNamespace

    删除 Namespace。

    ListNamespaces

    列举 Namespace。

    CreateTable

    创建表。

    DeleteTable

    删除表。

    ListTables

    列举表。

    RenameTable

    重命名表。

    UpdateTableMetadataLocation

    更新表的元数据位置。

    PutTablePolicy

    设置表访问策略。

    DeleteTablePolicy

    删除表访问策略。

    PutTableMaintenanceConfiguration

    设置表维护配置。

    IcebergCreateNamespace

    创建 Namespace(Iceberg)。

    IcebergDropNamespace

    删除 Namespace(Iceberg)。

    IcebergListNamespaces

    列举 Namespace(Iceberg)。

    IcebergCreateTable

    创建表(Iceberg)。

    IcebergDropTable

    删除表(Iceberg)。

    IcebergListTables

    列举表(Iceberg)。

    IcebergRenameTable

    重命名表(Iceberg)。

    IcebergUpdateTable

    更新表(Iceberg)。

    LanceCreateNamespace

    创建 Namespace(Lance)。

    LanceDropNamespace

    删除 Namespace(Lance)。

    LanceListNamespaces

    列举 Namespace(Lance)。

    LanceCreateTable

    创建表(Lance)。

    LanceDeclareTable

    声明表(Lance)。

    LanceDropTable

    删除表(Lance)。

    LanceListTables

    列举表(Lance)。

    LanceListAllTables

    列举全部表(Lance)。

    LanceRenameTable

    重命名表(Lance)。

    LanceDeregisterTable

    注销表(Lance)。

    SubmitLanceTableCompactTask

    提交文件合并(Compact)任务。

    SubmitLanceTableScalarIndexTask

    提交标量索引任务。

    SubmitLanceTableVectorIndexTask

    提交向量索引任务。

    SubmitLanceTableOptimizeIndicesTask

    提交索引优化任务。

    SubmitLanceTableCleanupTask

    提交版本清理任务。

    ListLanceTasks

    列举维护任务。

    DeleteLanceTask

    删除维护任务记录。

Get类型请求

计费项

计费项Code

计费规则

Get类型请求

GetRequest

根据OSS API的Get类请求次数计算请求费用。

Get类型请求主要包括Bucket、Object和catalog信息的读取操作,请参见下表获取Get类型具体包含的API请求。

Get类API请求

  • 对象 Bucket 的API请求

    API请求

    对应操作

    GetBucketAcl

    查看Bucket的访问权限。

    GetBucketLocation

    查看Bucket所属的数据中心。

    GetBucketInfo

    查看Bucket的相关信息。

    GetBucketLogging

    查看Bucket的访问日志配置。

    GetBucketWebsite

    查看Bucket的静态网站托管配置。

    GetBucketReferer

    查看Bucket的Referer配置。

    GetBucketLifecycle

    查看Bucket的Lifecycle配置。

    GetBucketReplication

    查看Bucket已配置的数据复制规则。

    GetBucketReplicationLocation

    查看数据可复制到的目标Bucket所在的地域。

    GetBucketReplicationProgress

    查看数据复制进度。

    GetBucketInventory

    查看Bucket指定的清单任务。

    ListBucketInventory

    查看Bucket所有的清单任务。

    GetObject

    下载Object。

    HeadObject

    查看Object包含的所有meta信息。

    GetObjectMeta

    查看Object包含的部分meta信息。

    SelectObject

    通过SQL语句查询和检索数据。

    GetObjectACL

    查看Object的读写权限ACL。

    GetSymlink

    查看软链接。

    GetBucketcors

    查看Bucket的CORS配置。

    GetBucketWorm

    查看Bucket的合规保留策略配置。

    GetBucketVersioning

    查看Bucket的版本控制状态。

    GetBucketPolicy

    查看Bucket Policy配置。

    GetBucketReferer

    查看防盗链配置。

    GetBucketTags

    查看Bucket的标签信息。

    GetBucketEncryption

    查看Bucket的加密配置。

    GetBucketRequestPayment

    获取请求者付费模式配置。

    GetObjectTagging

    查看Object的标签信息。

    ListLiveChannel

    查看所有LiveChannel的信息。

    GetLiveChannelInfo

    查看指定LiveChannel的信息。

    GetLiveChannelStat

    查看指定LiveChannel的推流状态信息。

    GetLiveChannelHistory

    查看指定LiveChannel的推流记录。

    GetVodPlaylist

    查看指定LiveChannel在指定时间段内推流生成的播放列表。

    GetStyle

    查询某个Bucket下指定的样式信息。

    get_image_info

    获取图片的基本信息。

    get_image_exif

    获取图片的exif信息。

    get_image_infoexif

    获取图片的基本信息和exif信息。

    ProcessImage

    图片处理。使用图片处理服务时,涉及多个计费项。更多信息,请参见图片处理计费说明。

    GetBucketStat

    获取Bucket的存储容量以及Object数量。

    Options

    浏览器在发送跨域请求之前发送的预检请求,用于确定是否允许跨域访问。

    GetBucketTransferAcceleration

    获取Bucket的传输加速配置。

    GetBucketDataRedundancyTransition

    获取Bucket的存储冗余转换配置。

    GetBucketAccessMonitor

    获取Bucket的访问跟踪配置。

    GetMetaQueryStatus

    获取Bucket的元数据索引状态。

    GetUserAntiDDosInfo

    查询指定账号下的高防OSS实例信息。

    GetBucketResourceGroup

    获取Bucket的资源组配置。

    GetCnameToken

    获取已创建的CnameToken。

    GetBucketArchiveDirectRead

    获取Bucket的归档直读配置。

    GetBucketHttpsConfig

    获取Bucket的HTTPS访问配置。

    GetAccessPoint

    获取指定接入点的配置信息。

    GetAccessPointPolicy

    获取接入点的访问策略。

    GetAccessPointForObjectProcess

    获取对象FC接入点基础信息。

    GetAccessPointConfigForObjectProcess

    获取对象FC接入点配置信息。

    GetAccessPointPolicyForObjectProcess

    获取对象FC接入点的权限策略配置。

    GetBucketPublicAccessBlock

    获取指定Bucket的阻止公共访问配置信息。

    GetBucketPolicyStatus

    查看当前Bucket Policy是否允许公共访问。

  • Table Bucket 的API请求

    重要

    OSS Table Bucket 目前处于公测阶段,公测期间不收取费用;自北京时间 2026 年 12 月 30 日起将正式启动商业化收费。请及时关注产品账单金额,详情请参见官网公告。

    API请求

    对应操作

    GetTableBucket

    查询 Table Bucket 信息。

    GetTableBucketEncryption

    查询 Table Bucket 加密配置。

    GetTableBucketPolicy

    查询 Table Bucket 访问策略。

    GetTableBucketMaintenanceConfiguration

    查询 Table Bucket 维护配置。

    GetNamespace

    查询 Namespace 信息。

    GetTable

    查询表信息。

    GetTableMetadataLocation

    查询表的元数据位置。

    GetTableEncryption

    查询表加密配置。

    GetTablePolicy

    查询表访问策略。

    GetTableMaintenanceConfiguration

    查询表维护配置。

    GetTableMaintenanceJobStatus

    查询维护任务状态。

    IcebergGetConfig

    获取 Catalog 配置(Iceberg)。

    IcebergLoadNamespaceMeta

    加载 Namespace 元数据(Iceberg)。

    IcebergNamespaceExists

    判断 Namespace 是否存在(Iceberg)。

    IcebergLoadTable

    加载表元数据(Iceberg)。

    IcebergTableExists

    判断表是否存在(Iceberg)。

    LanceDescribeNamespace

    获取 Namespace 描述信息(Lance)。

    LanceNamespaceExists

    判断 Namespace 是否存在(Lance)。

    LanceDescribeTable

    获取表描述信息(Lance)。

    LanceTableExists

    判断表是否存在(Lance)。

    GetLanceTaskStatus

    查询维护任务状态(Lance)。

冷归档取回请求

计费项

计费项Code

计费规则

冷归档取回请求

按照冷归档数据的不同解冻优先级,取回请求分为以下三种,对应的计费项Code如下:

  • 标准取回请求(CAStdRetrievalRequest)

  • 高优先级取回请求(CAHighPriorRetrievalRequest)

  • 批量取回请求(CABulkRetrievalRequest)

冷归档存储类型文件需解冻后才能访问,解冻时间取决于数据大小和选择的解冻优先级,解冻会产生数据取回请求费用。请求解冻一个冷归档类型文件被视为一次取回请求,请求次数的统计与请求文件的大小无关。

说明

解冻冷归档类型文件除了产生数据取回请求费用以外,还会产生冷归档存储数据取回容量以及临时存储容量费用。

深度冷归档取回请求

计费项

计费项Code

计费规则

深度冷归档取回请求

按照深度冷归档数据的不同解冻优先级,取回请求分为以下两种,对应的计费项Code如下:

  • 标准取回请求(DeepCAStdRetrievalRequest)

  • 高优先级取回请求(DeepCAHighPriorRetrievalRequest)

深度冷归档类型文件需解冻后才能访问,解冻时间取决于数据大小和选择的解冻优先级,解冻会产生数据取回请求费用。请求解冻一个深度冷归档类型文件被视为一次冷归档取回请求,请求次数的统计与请求文件的大小无关。

说明

解冻深度冷归档类型文件除了产生数据取回请求费用以外,还会产生深度冷归档存储数据取回容量以及临时存储容量费用。

特殊请求计费逻辑

Put类和Get类API请求遵循请求一次收取一次请求费用的原则。以下部分API请求可能涉及批量操作,在请求费用计算逻辑上存在特殊性,具体说明如下:

API请求

说明

请求费用

示例

ListObjects

列举某个Bucket内的所有文件。

调用一次ListObjects或者ListObjectsV2接口算一次Put类请求。在列举相同数量文件的情况下,调用该接口产生的请求次数取决于每次调用时设置的返回文件数量。

假设Bucket内有10,000个文件:

  • 如果调用该接口时未设置max-keys参数,默认一次返回100个文件,则列举10,000个文件,涉及100次Put类请求。

  • 如果调用该接口时设置了max-keys参数(取最大值1000),则列举10,000个文件,涉及10次Put类请求。

ListObjectsV2

DeleteMultipleObjects

批量删除Bucket内的文件。

调用一次DeleteMultipleObjects接口算一次Put类请求。在删除相同数量文件的情况下,调用该接口产生的请求次数取决于每次调用时操作的文件数量。

假设Bucket内有10,000个文件:

  • 如果调用该接口时Key参数填写了100个文件名,则删除10,000个文件,涉及100次Put类请求。

  • 如果调用该接口时Key参数填写了1000个(取最大值)文件名,则删除10,000个文件,涉及10次Put类请求。

CommitTransition

通过生命周期转换存储类型。

调用一次CommitTransition接口算一次Put类请求。根据生命周期转储规则命中的文件个数计算Put类型请求费用。

假设Bucket生命周期规则定义与前缀dir匹配的文件(文件数量为1000个),100天后由标准转为低频类型,则1000个文件涉及1000次Put类型请求费用。

ExpireObject

通过生命周期删除文件。

调用一次ExpireObject接口算一次Put类请求。根据生命周期删除规则命中的文件个数计算Put类型请求次数。

假设Bucket生命周期规则定义与前缀dir匹配的文件(文件数量为1000个),365天后删除,则1000个文件涉及1000次Put类型请求费用。

支付方式

选型指导

建议您参考以下付费方式的介绍,了解不同付费方式的特点、适用场景等信息,方便您选择适当的付费方式,以降低请求费用成本。

付费方式

说明

特点

适用场景

按量付费

所有计费项默认采用按量付费。按照各计费项的实际用量结算费用。先使用,后付费。

数据请求次数波动较大,难以预测

  • 请求不稳定的场景:例如,您的应用在某些时段可能会有大量的访问请求,而在其他时段可能很少,且出现大量访问请求的时段没有规律。

  • 临时性或一次性需求:您只需要使用OSS服务一段时间或者只有一次性的请求。

  • 数据备份或容灾:如果您需要将数据备份到OSS中,但是不确定何时会访问这些备份数据。

请求-标准存储类型资源包

针对标准类型的Put类和Get类请求推出的资源包。在费用结算时,优先从资源包抵扣用量。先购买,后抵扣。

标准类型数据请求次数相对稳定、可预测

  • 网站或应用程序的流量较为稳定:如果网站或应用程序的访问量较为稳定,那么用户对存储在OSS中的数据进行请求的频率也相对稳定。

  • 需要频繁访问数据的应用场景:例如在线游戏、实时通信等需要实时处理大量数据的应用。

请求-非标准存储类型资源包

针对低频、归档、冷归档类型的Put类和Get类请求推出的资源包。在费用结算时,优先从资源包抵扣用量。先购买,后抵扣。

低频、归档、冷归档数据请求次数相对稳定、可预测

您需要上传大量需要长期保存、但是访问频率较低(例如一年访问1到2次)的数据。

支持情况

以下是各计费项付费方式的支持情况:

计费项

按量付费

资源包

Put类型请求次数

√

Get类型请求次数

√

冷归档取回请求

√

×

深度冷归档取回请求

√

×

常见问题

是否支持请求者支付,而不是Bucket拥有者支付请求费用?

如果您希望通过请求者支付Put类型请求次数、Get类型请求次数费用,而不是通过Bucket拥有者支付这部分费用时,可以开启请求者付费模式。具体操作,请参见请求者付费。

相关文档

  • 如果您希望在具体的计费案例中了解请求费用相关计费项的详情,请参见计费案例。

  • 如果您希望查看请求费用相关计费项的费用明细,请参见账单查询。