GetKvNamespace_边缘安全加速_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

流控信息

请求速率为5/1(s)。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
esa:GetKvNamespace
None
全部资源
*

请求参数

字段名称字段详情
Namespacestring

调用 CreateKvNamespace 时指定的名称。

示例值:test_namespace正则:^[0-9a-zA-Z_-]+$参考取值来源:
    CreateKvNamespace
字符长度 <= 64

返回参数

字段名称字段详情
Statusstring

KV 存储空间状态,取值:展开详情

示例值:online
Namespacestring

KV 存储空间的名称。

示例值:test_namespace
NamespaceIdstring

KV 存储空间的 ID。

示例值:643355322374688768
RequestIdstring

请求 ID。

示例值:EEEBE525-F576-1196-8DAF-2D70CA3F4D2F
Descriptionstring

KV 存储空间的描述信息。

示例值:this is a test namespace.
CapacityStringstring

KV 存储空间可用容量。

示例值:1 GB
CapacityUsedStringstring

KV 存储空间已用容量。

示例值:100 MB
Capacityinteger<int64>

KV 存储空间可用容量,单位为字节。

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:1073741824
CapacityUsedinteger<int64>

KV 存储空间已用容量,单位为字节。

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:10048576

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
InvalidAccount.Malformed
The specified account is invalid.诊断
400
InvalidNameSpace.Malformed
The specified namespace is invalid.诊断
400
InvalidKey.Malformed
The specified key is invalid.诊断
400
InvalidKey.ExceedsMaximum
The size of the key cannot exceed 512 bytes.诊断
400
InvalidValue.ExceedsMaximum
The size of the value cannot exceed 2,000,000 bytes.诊断
403
InvalidKey.ExceedsCapacity
The maximum capacity of a single namespace cannot exceed 1 GB.诊断
403
Unauthorized.InvalidParameters
The specified authentication parameters are invalid.诊断
403
Unauthorized.InvalidTime
The specified authentication time is invalid.诊断
403
Unauthorized.InvalidToken
Token authentication failed.诊断
404
InvalidAccount.NotFound
The specified account does not exist.诊断
404
InvalidNameSpace.NotFound
The specified namespace does not exist.诊断
404
InvalidKey.NotFound
The specified key does not exist.诊断
406
InvalidNameSpace.Duplicate
The specified namespace already exists.诊断
406
InvalidNameSpace.QuotaFull
The maximum number of namespaces is exceeded.诊断
429
TooManyRequests
Too many requests are submitted.诊断
429
TooQuickRequests
Request for putting or deleting keys are frequently submitted.诊断

变更历史

变更时间变更内容概要操作
2025-04-03
变更请求参数Namespace
2024-09-20
变更错误码400
变更错误码403
变更错误码406

相关示例