Domain name for API request: teo.intl.tencentcloudapi.com.
This API is used to batch read key values from a specified namespace, supporting a single query of up to 20 keys.
A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| Action | Yes | String | Common Params. The value used for this API: EdgeKVGet. |
| Version | Yes | String | Common Params. The value used for this API: 2022-09-01. |
| Region | No | String | Common Params. This parameter is not required. |
| ZoneId | Yes | String | Zone ID. |
| Namespace | Yes | String | Namespace name. You can obtain the list of namespaces under the site through the DescribeEdgeKVNamespaces API. |
| Keys.N | Yes | Array of String | Name list. Maximum array length is 20. Each key cannot be empty, with a length of 1-512 characters. Allowed characters include letters, numbers, hyphens, and underscores. To query a single key, input an array with one element. |
| Parameter Name | Type | Description |
|---|---|---|
| Data | Array of KeyValuePair | Key-value pair data list. Return results sequentially in the order of input Keys. If a key does not exist, the corresponding Value Field returns empty string. |
| RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
Query the content of the key-value pair named hello in namespace ns-011 of site zone-3j1xw7910arp.
POST / HTTP/1.1
Host: teo.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: EdgeKVGet
<Common request parameters>
{
"ZoneId": "zone-3j1xw7910arp",
"Namespace": "ns-011",
"Keys": [
"hello"
]
}
{
"Response": {
"Data": [
{
"Expiration": "2026-03-26T08:20:00Z",
"Key": "hello",
"Value": "world"
}
],
"RequestId": "07aea30b-d34f-4480-b14c-ffb4f7e10555"
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
| Error Code | Description |
|---|---|
| FailedOperation | Operation failed. |
| InvalidParameter.KeysTooMany | The number of keys in the request exceeds the limit. |
| ResourceUnavailable.NamespaceNotFound | KV namespace does not exist. |
文档反馈