EdgeKv产品在全站加速边缘节点提供一个全球通用的Key-Value(KV)数据库,调用PutDcdnKvAccount停用或启用账户的Key-Value(KV)功能。

说明 单用户调用频率:5次/秒。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Status String online

设置账户Key-Value(KV)功能状态,取值:

  • online:开启
  • offline:关闭
AccountType String prod

账号类型。固定取值prod,表示外部账号。

返回数据

名称 类型 示例值 描述
NamespaceList Array of namespaces

NamespaceList子节点。

Description String the first namespace

Namespace描述信息。

Namespace String ns1

Namespace名称。

NamespaceId String 12423131231****

Namespace ID。

Status String online

Namespace状态,取值:

  • online:正常。
  • delete:待删除。
  • deleting:删除中。
  • deleted:已删除。
NamespaceQuota Integer 10

账号下最多可申请的Namespace数。

NamespaceUsed Integer 0

账号下已申请Namespace数。

RequestId String D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C

请求ID。

Status String online

账户Key-Value(KV)功能状态,取值:

  • online:开启
  • offline:关闭

示例

请求示例

http(s)://dcdn.aliyuncs.com/?Action=PutDcdnKvAccount
&Status=online
&<公共请求参数>

正常返回示例

XML格式

<PutDcdnKvAccountResponse>
  <RequestId>D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C</RequestId>
  <NamespaceUsed>0</NamespaceUsed>
  <NamespaceQuota>10</NamespaceQuota>
  <Status>online</Status>
  <NamespaceList>
        <NamespaceId>12423131231****</NamespaceId>
        <Description>the first namespace</Description>
        <Title>ns1</Title>
  </NamespaceList>
</PutDcdnKvAccountResponse>

JSON格式

{
    "RequestId": "D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C",
    "NamespaceUsed": 0,
    "NamespaceQuota": 10,
    "Status": "online",
    "NamespaceList": [
        {
            "NamespaceId": "12423131231****",
            "Description": "the first namespace",
            "Title": "ns1"
        }
    ]
}

错误码

HttpCode 错误码 错误信息 描述
400 Invalid.Parameter The specified parameter is invalid. 输入参数无效
404 InvalidAccount.NotFound The specified account does not exist. 账号不存在,未创建
400 InvalidAccount.Malformed The specified account is invalid. 账号输入不对,比如输入为空
429 TooManyRequests Too many requests are submitted. 请求速率过快
404 InvalidNameSpace.NotFound The specified namespace does not exist. namespace不存在
400 InvalidNameSpace.Malformed The specified namespace is invalid. namespace输入不对,比如输入为空
406 InvalidNameSpace.Duplicate The specified namespace already exists. namespace已存在
406 InvalidNameSpace.QuotaFull The maximum number of namespaces is exceeded. namespace个数超过quota限制
404 InvalidKey.NotFound The specified key does not exist. 请求的key不存在
400 InvalidKey.Malformed The specified key is invalid. key输入不对,比如输入为空
400 InvalidKey.ExceedsMaximum The size of the key cannot exceed 512 bytes. key长度不能超过512B
400 InvalidValue.ExceedsMaximum The size of the value cannot exceed 2,000,000 bytes. value长度不能越过2000000B
406 InvalidKey.QuotaFull The maximum number of keys is exceeded. key个数超过quota限制
403 InvalidKey.ExceedsCapacity The maximum capacity of a single namespace cannot exceed 1 GB. namespace容量超过限制,单个namespace最大容量为1G
429 TooQuickRequests Request for putting or deleting keys are frequently submitted. key put/delete操作太频繁
403 Unauthorized.InvalidParameters The specified authentication parameters are invalid. 鉴权参数输入错误
403 Unauthorized.InvalidTime The specified authentication time is invalid. 鉴权时间参数格式错误
403 Unauthorized.InvalidToken Token authentication failed. 鉴权token校验失败
403 Unauthorized.InvalidResource Resource authentication failed. 资源校验失败

访问错误中心查看更多错误码。