Updated on 2022-05-17 GMT+08:00

Requests

Each API call is counted as a request. When you perform operations on OBS through OBS Console, tools, or APIs, you are actually calling APIs. You will be billed for the number of OBS API calls.

Request Types

OBS requests include read, write, and delete requests:

  • Read requests: GET, HEAD, and other requests, such as downloading objects, obtaining bucket locations, and obtaining bucket policies
  • Write requests: PUT, POST, COPY, LIST, and other requests, such as uploading objects and listing objects
  • Delete requests: DELETE and other requests, such as deleting objects and canceling multipart upload tasks

Introduction

Category

Billing Item

Description

Billing Mode

Requests

All types of requests

The number of OBS API calls, including PUT, POST, COPY, LIST, GET, and HEAD requests.

Pay-per-use

Request Billing

Requests can only be billed on a pay-per-use basis. The unit request price varies with request type.

Except the requests whose status code returned by the server is 5XX or 403, all other requests are counted in the number of requests.

Examples

Example 1

Take object upload for example. Each time you upload an object or an object part is counted as a request. Assuming that a folder has 100 objects:

  • If you call the PutObject API to upload all objects, sending 100 PUT requests means that the number of requests is 100.
  • If you use multipart upload tasks to upload the large objects in the folder, the final number of requests is greater than 100, because the processing of object parts will increase the number of requests. In addition, extra requests are required for initializing multipart upload tasks and merging parts into objects.

Example 2

Each operation on OBS Console delivers a request that is counted for billing.

For example, when you open the homepage of OBS Console, the list of buckets is loaded. In this process, requests are sent to obtain the bucket list and bucket locations. Then when you switch to the Overview page of a bucket, requests are sent to query the bucket storage information and metadata.