Updated on 2025-04-17 GMT+08:00

Requests

Requests made by calling APIs or on the KVS console (essentially through API calls) are billed by request units.

With provisioned billing, you are charged for the amount of throughput you specified. If the actual throughput of the table exceeds the specified values, requests are throttled.

Types of Request Units

Standard KVS request units refer to write request units (WRUs) and read request units (RRUs) with pay-per-use billing, or write capacity units (WCUs) and read capacity units (RCUs) with provisioned billing.

Billing

Table 1 Request billing

Item

Sub-Item

Description

Billing Mode

Requests

Standard WRUs

put-kv (adding a single KV item), update-kv (updating a single KV item), delete-kv (deleting a single KV item), batch-write-kv (batch writing KV items), and others

Pay-per-use billing

Standard RRUs

get-kv (querying a single KV item), scan-kv (scanning all the KV items in a table), scan-skey-kv (scanning part of the items by shard key), and others

Standard WCUs

put-kv (adding a single KV item), update-kv (updating a single KV item), delete-kv (deleting a single KV item), batch-write-kv (batch writing KV items), and others

Provisioned billing

Standard RCUs

get-kv (querying a single KV item), scan-kv (scanning all the KV items in a table), scan-skey-kv (scanning part of the items by shard key), and others

Billing Example 1: Pay-per-Use Billing

The estimated prices in the following example are only for reference.

Assume that from 8:00:00 to 9:00:00 on a certain day, your table processed one million RRUs. From 9:00:00 to 10:00:00 on the same day, it processed two million WRUs. The billing details for the request units processed from 8:00:00 to 10:00:00 are as follows:

Table 2 Billing details

Billing Cycle

Operation

Billing Item

Unit Price

Usage

Price

8:00:00–9:00:00

Read

Standard RRUs

$0.3302 USD/million RRUs

1 million RRUs

1 million RRUs × $0.3302 USD/million RRUs = $0.3302 USD

9:00:00–10:00:00

Write

Standard WRUs

$1.667 USD/million WRUs

2 million WRUs

2 million WRUs × $1.667 USD/million WRUs = $3.334 USD

Total

/

/

/

/

$3.6642 USD

The requests for the cycles from 8:00:00 to 10:00:00 costed $3.6642 USD.

Billing Example 2: Provisioned Billing

The estimated prices in the following example are only for reference.

Assume when creating a table, you had 1,000 WCUs in write throughput and 100 RCUs in read throughput provisioned. From 8:00:00 to 9:00:00 on a certain day, the write requests recorded 900 WCUs, and the query requests recorded 100 RCUs. The details for the request units billed from 8:00:00 to 9:00:00 are as follows:

Table 3 Billing details

Billing Cycle

Operation

Billing Item

Unit Price

Usage

Price

8:00:00–9:00:00

Write

Standard WCUs

$0.0008648 USD/WCU-hour

1,000 WCUs

1,000 WCUs × $0.0008648 USD/WCU-hour = $0.8648 USD

Read

Standard RCUs

$0.000173 USD/RCU-hour

100 RCUs

100 RCUs × $0.000173 USD/RCU-hour = $0.0173 USD

Total

/

/

/

/

$0.8821 USD

The requests for the cycle from 8:00:00 to 9:00:00 costed $0.8821 USD.