全部產品
Search

搜尋本產品

    Edge Security Acceleration：DescribeDcdnKvNamespace - 查詢Namespace資訊

    文件中心

    Edge Security Acceleration：DescribeDcdnKvNamespace - 查詢Namespace資訊

    更新時間：Sep 11, 2025

    調用DescribeDcdnKvNamespace查詢某個Namespace的資訊。

    調試

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

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    dcdn:DescribeDcdnKvNamespace

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Namespace

    string

    是

    Namespace 名稱。

    ns1

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Status

    string

    Namespace 狀態，取值：

    • online：正常。

    • delete：待刪除。

    • deleting：刪除中。

    • deleted：已刪除。

    online
    Namespace

    string

    Namespace 名稱。

    ns1
    NamespaceId

    string

    Namespace ID。

    12423131231****
    RequestId

    string

    請求 ID。

    D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C
    Description

    string

    Namespace 描述資訊。

    the first namespace
    CapacityString

    string

    Namespace 可用容量。

    1 GB
    CapacityUsedString

    string

    Namespace 已用容量。

    100 MB
    Mode

    string

    模式（Mode）

    • 普通模式（Normal）：預設模式，在邊緣未擷取到 KV 時，嘗試從中心查詢 KV 資訊，從而保證全域資料一致性。

    • 快速模式（Rapid）：在邊緣未擷取到 KV 時，不再向中心查詢，而是直接返回“key 不存在”。開啟該模式將提升 KV 查詢效能。但可能造成 KV 查詢命中率下降，若有需求請通過工單申請開通。

    Normal
    Capacity

    integer

    Namespace 可用容量，單位為位元組。

    1073741824
    CapacityUsed

    integer

    Namespace 已用容量，單位為位元組。

    10048576

    樣本

    正常返回樣本

    JSON格式

    {
  "Status": "online",
  "Namespace": "ns1",
  "NamespaceId": "12423131231****",
  "RequestId": "D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C",
  "Description": "the first namespace",
  "CapacityString": "1 GB",
  "CapacityUsedString": "100 MB",
  "Mode": "Normal",
  "Capacity": 1073741824,
  "CapacityUsed": 10048576
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 Invalid.Parameter The specified parameter is invalid. 輸入參數無效
    400 InvalidAccount.Malformed The specified account is invalid. 帳號輸入不對，比如輸入為空白
    400 InvalidNameSpace.Malformed The specified namespace is invalid. namespace輸入不對，比如輸入為空白
    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
    403 InvalidKey.ExceedsCapacity The maximum capacity of a single namespace cannot exceed 1 GB. namespace容量超過限制，單個namespace最大容量為1G
    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後進行重試。
    403 Unauthorized.InvalidResource Resource authentication failed. 資源校正失敗
    404 InvalidAccount.NotFound The specified account does not exist. 帳號不存在，未建立
    404 InvalidNameSpace.NotFound The specified namespace does not exist. namespace不存在
    404 InvalidKey.NotFound The specified key does not exist. 請求的key不存在
    406 InvalidNameSpace.Duplicate The specified namespace already exists. namespace已存在
    406 InvalidNameSpace.QuotaFull The maximum number of namespaces is exceeded. namespace個數超過quota限制
    406 InvalidKey.QuotaFull The maximum number of keys is exceeded. key個數超過quota限制
    429 TooManyRequests Too many requests are submitted. 請求速率過快
    429 TooQuickRequests Request for putting or deleting keys are frequently submitted. key put/delete操作太頻繁

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

    變更歷史

    更多資訊，參考變更詳情。