查詢指定站點與業務類型的實時日志投遞剩余配額。
接口說明
使用此接口可以查詢指定阿里云用戶下，特定站點與業務類型的實時日志投遞服務剩余配額數量。這對于監控與管理您的日志投遞容量至關重要，確保日志能夠順利推送至目標存儲端，避免因配額不足導致的數據丟失或延遲。
參數注意事項：
BusinessType是必填項，需指定業務類型以獲取相應的配額信息。SiteId需要是有效的站點 ID，且格式應為整數，確保與您在阿里云上配置的站點相對應。
響應內容：
- 接口成功響應將返回投遞配額數量（
FreeQuota），以及請求標識（RequestId），站點 ID（SiteId）和業務類型（BusinessType）作為確認和記錄使用。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| esa:GetSiteLogDeliveryQuota | none | *全部資源 * |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| BusinessType | string | 是 | 實時日志類型，取值：
| dcdn_log_access_l1 |
| SiteId | long | 是 | 站點 ID，可通過調用 ListSites 接口獲取。 | 123456**** |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "4C14840EF0EAAB6D97CDE0C5F6554ACE",
"FreeQuota": 3,
"BusinessType": "dcdn_log_access_l1",
"SiteId": 0
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidParameter | The specified parameter is invalid. | 輸入參數規范校驗失敗。 |
| 400 | InternalError | An internal exception occurred, please try again later. | 觸發內部異常，請稍后再試。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-09-27 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |