本接口用于查看存储空间中某个键(Key)对应的值(Value)。
本接口返回的Body内容即为所查询的值(Value)。
状态码
当请求返回的服务端状态码为200时,表示获取到数据。
当请求返回的服务端状态码为404时,表示键(Key)不存在。
返回状态码为其他时候,表示请求失败,返回的内容与其他请求保持一致。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | GetKvKey | 公共参数。该参数表示接口名称。取值:GetKvKey |
Version | String | 是 | 2021-04-30 | 公共参数。该参数表示接口版本。取值:2021-04-30。 |
namespace_name | String | 是 | test-kv1 | 数据所属存储空间的名称。 |
key | String | 是 | testkey | 查询的键(Key) |
参数 | 位置 | 类型 | 示例值 | 描述 |
---|---|---|---|---|
X-Kv-Key-Ddl | Header | String | 0 | 数据到期时间。数据到期之后,Key中的Value将无法被访问。
|
参数 | 位置 | 示例值 | 描述 |
---|---|---|---|
<value> | Body | testvalue123 | 键(Key)对应的值(Value)。 |
GET https://veefedge.volcengineapi.com/?Action=GetKvKey &namespace_name=test-kv1 &key=testkey &<公共请求参数>
testvalue123
如果响应正文中包含 Error 字段,则表示 API 请求失败。关于错误码的更多信息,参见错误码。