全部產品
Search
文件中心

Edge Security Acceleration:GetKvAccount - 查詢賬戶的KV服務使用資訊

更新時間:Mar 17, 2026

查詢賬戶在KV服務的使用資訊,包含所有的KV儲存空間列表等資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

當前API無需請求參數

返回參數

名稱

類型

描述

樣本值

object

Status

string

賬戶狀態。

  • online:開啟。

  • offline:關閉。

online

RequestId

string

請求 ID。

EEEBE525-F576-1196-8DAF-2D70CA3F4D2F

NamespaceUsed

integer

帳號下已申請 KV 儲存空間數。

1

NamespaceQuota

integer

帳號下最多可申請的 KV 儲存空間配額數。

10

CapacityString

string

賬戶下所有 KV 儲存空間的可用容量。

1 GB

CapacityUsedString

string

賬戶下所有 KV 儲存空間的已用容量。

100 MB

Capacity

integer

賬戶下所有 KV 儲存空間的可用容量,單位為位元組。

1073741824

CapacityUsed

integer

賬戶下所有 KV 儲存空間的已用容量,單位為位元組。

10048576

NamespaceList

array<object>

帳號的 KV 儲存空間列表。

object

Status

string

KV 儲存空間狀態,取值:

  • online:正常。

  • delete:待刪除。

  • deleting:刪除中。

  • deleted:已刪除。

online

Namespace

string

KV 儲存空間名稱。

test_namespace

NamespaceId

string

KV 儲存空間 ID。

643355322374688768

Description

string

KV 儲存空間的描述資訊。

the first namespace

Capacity

integer

KV 儲存空間的可用容量,單位為位元組。

1073741824

CapacityUsed

integer

KV 儲存空間的已用容量,單位為位元組。

100048576

CapacityString

string

KV 儲存空間的可用容量。

1 GB

CapacityUsedString

string

KV 儲存空間的已用容量。

100 MB

樣本

正常返回樣本

JSON格式

{
  "Status": "online",
  "RequestId": "EEEBE525-F576-1196-8DAF-2D70CA3F4D2F",
  "NamespaceUsed": 1,
  "NamespaceQuota": 10,
  "CapacityString": "1 GB",
  "CapacityUsedString": "100 MB",
  "Capacity": 1073741824,
  "CapacityUsed": 10048576,
  "NamespaceList": [
    {
      "Status": "online",
      "Namespace": "test_namespace",
      "NamespaceId": "643355322374688768",
      "Description": "the first namespace",
      "Capacity": 1073741824,
      "CapacityUsed": 100048576,
      "CapacityString": "1 GB",
      "CapacityUsedString": "100 MB"
    }
  ]
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 InvalidAccount.Malformed The specified account is invalid. 帳號輸入不對,比如輸入為空白。
400 InvalidNameSpace.Malformed The specified namespace is invalid. 儲存空間名輸入錯誤,比如輸入Null 字元串。
400 InvalidKey.Malformed The specified key is invalid. Key名輸入錯誤,比如輸入Null 字元串。
400 InvalidKey.ExceedsMaximum The size of the key cannot exceed 512 bytes. 請求的Key的長度過大。
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. 您輸入的token無效,請檢查並輸入正確的token後進行重試。
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. 索引值對的修改或者刪除操作太頻繁。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情