Operations in Object Storage Service (OSS) are implemented by calling OSS API operations. Fees are calculated based on the number of API requests. If you want to access Cold Archive or Deep Cold Archive data, you must first restore the data. You are also charged data retrieval fees when you restore data.
This topic describes the billable items and billing methods of OSS. For more information, visit the OSS pricing page.
Billable items
The billable items include the number of PUT requests, GET requests, and retrieval requests of Cold Archive and Deep Cold Archive data.
A free quota is provided only for the following billable items:
Number of PUT requests
A free quota of 100 million requests per month is provided. If the number of PUT requests per month is less than or equal to 100 million, you are not charged for OSS API operations that are called to send PUT requests.
Number of GET requests
A free quota of 500 million requests per month is provided. If the number of GET requests per month is less than or equal to 500 million, you are not charged for OSS API operations that are called to send GET requests.
Billable item | Billing rule | Billing cycle | Billing method |
Number of PUT requests | You are charged for OSS API operations that are called to send PUT requests. For more information about PUT requests, see the PUT requests section of this topic. Note You are not charged for failed requests. Failed requests include requests for which the HTTP status code 4xx or 5xx is returned. | You are billed on an hourly basis. Bills are generally generated after a billing cycle ends. The time when bills are generated is determined by the system. |
|
Number of GET requests | You are charged for OSS API operations that are called to send GET requests. For more information about GET requests, see the GET requests section of this topic. Note You are not charged for failed requests. Failed requests include requests for which the HTTP status code 4xx or 5xx is returned. | ||
Number of retrieval requests for Cold Archive data (DataRetrievalRequest) | Before you can access a Cold Archive object, you must restore the object. The amount of time required to restore a Cold Archive object varies based on the data size and the specified restoration mode. You are charged for data retrieval when you restore a Cold Archive object. Data retrieval requests are divided into the following types based on different restoration modes for Cold Archive data:
| ||
Number of retrieval requests for Deep Cold Archive data (DataRetrievalRequest) | Before you can access a Deep Cold Archive object, you must restore the object. The amount of time required to restore a Deep Cold Archive object varies based on the data size and the specified restoration mode. You are charged for data retrieval when you restore a Deep Cold Archive object. Data retrieval requests are divided into the following types based on different restoration modes for Deep Cold Archive data:
|
For more information about PUT and GET requests, see List of operations by function.
PUT requests
PUT requests include requests that are initiated to perform operations such as data upload, data copy, and data deletion by using the OSS API, SDK, or console.
API request | Description |
PutBucket | Creates a bucket. |
ListObjects (GetBucket) or ListObjectsV2 (GetBucketV2) | Lists all objects in a bucket. |
PutBucketACL | Configures an access control list (ACL) for a bucket. |
PutBucketInventory | Configures inventories for a bucket. |
DeleteBucketInventory | Deletes specific inventories of a bucket. |
PutBucketLogging | Enables logging for a bucket. |
DeleteBucketLogging | Disables logging for a bucket. |
PutBucketWebsite | Enables static website hosting for a bucket and configures redirection rules for the bucket. |
DeleteBucketWebsite | Disables static website hosting for a bucket and deletes the redirection rules of the bucket. |
PutBucketReferer | Configures the Referer whitelist and specifies whether requests with empty Referer fields are allowed. |
PutBucketLifecycle | Configures lifecycle rules for a bucket. |
CommitTransition | Converts the storage class of objects to IA, Archive, Cold Archive, or Deep Cold Archive based on lifecycle rules. |
ExpireObject | Deletes an object based on lifecycle rules. |
DeleteBucketLifecycle | Deletes lifecycle rules of a bucket. |
DeleteBucket | Deletes a bucket. |
PutObject | Uploads an object. |
CopyObject | Copies objects to the same bucket or another bucket within the same region. |
AppendObject | Uploads an object by appending the content of the object to an existing object. |
DeleteObject | Deletes an object. |
DeleteMultipleObjects | Deletes multiple objects. |
PutObjectACL | Configures an ACL for an object. |
PostObject | Uploads an object by using an HTML form. |
ListObjectVersions (GetBucketVersions) | Queries the versions of all objects in a bucket. |
PutSymlink | Creates a symbolic link. |
RestoreObject | Restores an Archive, Cold Archive, or Deep Cold Archive object. |
InitiateMultipartUpload | Initiates a multipart upload task. |
UploadPart | Uploads an object by part based on the specified object name and the upload ID. |
AbortMultipartUpload | Cancels a multipart upload task and deletes uploaded parts. |
UploadPartCopy | Copies an object by part. |
PutBucketReplication | Configures data replication rules for a bucket. |
DeleteBucketReplication | Stops a data replication task for a bucket and deletes the data replication rules of the bucket. |
PutBucketCors | Configures cross-origin resource sharing (CORS) for a bucket. |
DeleteBucketCors | Deletes the CORS configurations of a bucket. |
CompleteMultipartUpload | Completes the multipart upload task. |
InitiateBucketWorm | Creates a retention policy for a bucket. |
AbortBucketWorm | Deletes an unlocked retention policy. |
CompleteBucketWorm | Locks a retention policy. |
ExtendBucketWorm | Extends the retention period (days) of objects in a bucket for which a retention policy is locked. |
PutBucketVersioning | Enables versioning for a bucket. |
PutBucketPolicy | Configures a bucket policy. |
DeleteBucketPolicy | Deletes a bucket policy. |
PutBucketTags | Adds tags to or modifies the tags of a bucket. |
DeleteBucketTags | Deletes tags of a bucket. |
PutBucketEncryption | Configures a data encryption rule for a bucket. |
DeleteBucketEncryption | Deletes a data encryption rule of a bucket. |
PutBucketRequestPayment | Configures request payment settings for a bucket. |
PutObjectTagging | Adds tags to or modifies the tags of an object. |
DeleteObjectTagging | Deletes the tags of an object. |
PutLiveChannel | Creates a LiveChannel. |
DeleteLiveChannel | Deletes a specific LiveChannel. |
PutLiveChannelStatus | Switches the status of a LiveChannel. |
PostVodPlaylist | Generates a playlist used for video on demand (VOD) for a LiveChannel. |
GET requests
GET requests include requests that are initiated to perform read operations, except for ListObjects (GetBucket), ListObjectsV2 (GetBucketV2), and ListObjectVersions (GetBucketVersions), on objects and other data by using the OSS API, SDK, or console.
API request | Description |
GetBucketAcl | Queries the ACL of a bucket. |
GetBucketLocation | Queries the data center where a bucket is located. |
GetBucketInfo | Queries the information about a bucket. |
GetBucketLogging | Queries the logging configurations of a bucket. |
GetBucketWebsite | Queries the static website hosting configurations of a bucket. |
GetBucketReferer | Queries the Referer configurations of a bucket. |
GetBucketLifecycle | Queries the lifecycle rules of a bucket. |
GetBucketReplication | Queries the data replication rules of a bucket. |
GetBucketReplicationLocation | Queries the regions of the destination bucket to which data can be replicated. |
GetBucketReplicationProgress | Queries the progress of data replication. |
GetBucketInventory | Queries a specific inventory of a bucket. |
ListBucketInventory | Queries all inventories of a bucket. |
GetObject | Downloads an object. |
HeadObject | Queries all metadata of an object. |
GetObjectMeta | Queries part of the metadata of an object. |
GetObjectACL | Queries the ACL of an object. |
GetSymlink | Queries symbolic links. |
ListMultipartUploads | Lists all ongoing multipart upload tasks. |
ListParts | Lists the uploaded parts. |
UploadPartCopy | Copies an object by part. |
GetBucketCors | Queries the CORS configurations of a bucket. |
GetBucketWorm | Queries the retention policies of a bucket. |
GetBucketVersioning | Queries the versioning status of a bucket. |
GetBucketPolicy | Queries the bucket policies of a bucket. |
GetBucketReferer | Queries the Referer configurations of a bucket. |
GetBucketTags | Queries the tags of a bucket. |
GetBucketEncryption | Queries the encryption configurations of a bucket. |
GetBucketRequestPayment | Queries the request payment settings of a bucket. |
SelectObject | Scans an object. |
GetObjectTagging | Queries the tags of an object. |
ListLiveChannel | Queries the list of LiveChannels. |
GetLiveChannelInfo | Queries the configurations of a specific LiveChannel. |
GetLiveChannelStat | Queries the stream ingest status of a specific LiveChannel. |
GetLiveChannelHistory | Queries the stream ingest history of a specific LiveChannel. |
GetVodPlaylist | Queries the playlist that is generated by the streams ingested to a specific LiveChannel within a specific time range. |
References
For more information about how to query OSS billing data generated on an hourly basis, see Query OSS billing data generated on an hourly basis.
For more information about the billing details of the billable items, see Query bills.