DescribeDcdnDomainRealTimeByteHitRateData - 查詢即時位元組命中率資料 - Edge Security Acceleration

介面說明

單使用者調用頻率：10 次/秒。
由於存在多網域名稱合并儲存的情況，可能會導致命中率資料不準確，具體情況以配置為準。
如果您不指定 StartTime 和 EndTime，該介面預設返回過去 1 小時的資料；指定 StartTime 和 EndTime，該介面返回指定時間段的資料。

返回資料時間粒紋

根據您指定 StartTime 和 EndTime 時間跨度，會返回不同的資料時間粒紋，對應的可查詢歷史資料時間範圍和資料延遲如下：

時間粒紋	單次查詢的最大時間跨度	可查詢歷史資料時間範圍	資料延遲
1 分鐘	1 小時	7 天	5 分鐘
5 分鐘	3 天	93 天	15 分鐘
1 小時	31 天	186 天	一般延遲 3-4 小時

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

dcdn:DescribeDcdnDomainRealTimeByteHitRateData

get

domain

acs:dcdn:*:{#accountId}:domain/{#domainName}

無

請求參數

名稱	類型	必填	描述	樣本值
DomainName	string	是	網域名稱，多個之間用逗號（,）隔開。	example.com
StartTime	string	否	擷取資料起始時間點。日期格式按照 ISO8601 標記法，並使用 UTC 時間，格式為 yyyy-MM-ddTHH:mm:ssZ。	2017-12-10T20:00:00Z
EndTime	string	否	擷取資料結束時間點。日期格式按照 ISO8601 標記法，並使用 UTC 時間，格式為 yyyy-MM-ddTHH:mm:ssZ。結束時間需大於起始時間。	2017-12-10T21:00:00Z

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。	B955107D-E658-4E77-B913-E0AC3D31693E
Data	object
ByteHitRateDataModel	array<object>	位元組命中率資料列表。
	object
ByteHitRate	number	請求命中率資料。	0.8956940476262277
TimeStamp	string	資料時間戳記，日期格式按照 ISO8601 標記法，並使用 UTC 時間。	2016-10-20T04:00:00Z

樣本

正常返回樣本

JSON格式

{
  "RequestId": "B955107D-E658-4E77-B913-E0AC3D31693E",
  "Data": {
    "ByteHitRateDataModel": [
      {
        "ByteHitRate": 0.8956940476262277,
        "TimeStamp": "2016-10-20T04:00:00Z"
      }
    ]
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	MissingTimeParameter	The StartTime and EndTime must be both specified.	請同時提供開始時間和結束時間。
400	InvalidStartTime.Malformed	The specified StartTime parameter is invalid.	請提供正確的開始時間格式。日期格式按照ISO8601標記法，並使用UTC時間，格式為：yyyy-MM-ddTHH:mm:ssZ。
400	InvalidEndTime.Malformed	The specified EndTime is invalid.	請提供正確的結束時間格式。日期格式按照ISO8601標記法，並使用UTC時間。格式為：yyyy-MM-ddTHH:mm:ssZ。
400	InvalidEndTime.Mismatch	The specified EndTime is earlier than the StartTime.	結束時間早於開始時間，請檢查。
400	InvalidStartTime.ValueNotSupported	The specified StartTime is invalid.	不支援該開始時間，請重新填寫。

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

變更歷史

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