DescribeCostRules - PolarDB

查詢成本規則。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

polardb:DescribeCostRules

get

*全部資源。

*

無

請求文法

POST  HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
PageNumber	integer	否	頁碼。	1
PageSize	integer	否	每頁記錄數，取值範圍如下： 30 50 100 預設值為 30。	30
GwClusterId	string	是	閘道器執行個體 ID。	pg-xxxxxxxx
ModelName	string	否	模型名稱（如 gpt-4、qwen-turbo）。	qwen3-max
ModelServiceId	string	否	模型服務 ID。	ms-xxxxxx
EffectiveTargetType	string	否	依生效目標類型篩選，取值 global/consumerGroup/consumer。	global
EffectiveTargetValue	string	否	依生效目標值篩選。	user
RegionId	string	否	地域 ID。	cn-beijing

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
RequestId	string	Id of the request	24A1990B-4F6E-482B-B8CB-75C612******
TotalRecordCount	integer	總記錄數。	1
PageRecordCount	integer	本頁記錄數。	30
PageNumber	integer	頁碼。	1
PageSize	integer	每頁記錄數，取值範圍為 30、50、100，預設值為 30。	30
Items	array<object>	成本規則清單。
	object	成本規則物件。
InputCostPointsPerMillion	string	輸入百萬 token 成本點（預設 0）。	0
OutputCostPointsPerMillion	string	輸出百萬 token 成本點（預設 0）。	0
CacheCostPointsPerMillion	string	Cache 百萬 token 成本點（預設 0）。	0
EffectiveTargetType	string	依生效目標類型篩選。	global
EffectiveTargetValue	string	依生效目標值篩選。	user
Model	string	模型名稱。	gpt-4
ModelServiceId	string	模型服務 ID。	ms-xxxxxxxxx
CostRuleId	string	成本規則 ID。	924d450014e64e88ac6e8486f8e990**
GwClusterId	string	閘道器執行個體 ID。	pg-xxxxxxxxxx
GmtCreated	string	建立時間。	2026-01-04T16:09:29+08:00
GmtModified	string	更新時間。	2024-10-16 16:46:20

樣本

正常返回樣本

JSON格式

{
  "RequestId": "24A1990B-4F6E-482B-B8CB-75C612******",
  "TotalRecordCount": 1,
  "PageRecordCount": 30,
  "PageNumber": 1,
  "PageSize": 30,
  "Items": [
    {
      "InputCostPointsPerMillion": "0",
      "OutputCostPointsPerMillion": "0",
      "CacheCostPointsPerMillion": "0",
      "EffectiveTargetType": "global",
      "EffectiveTargetValue": "user",
      "Model": "gpt-4",
      "ModelServiceId": "ms-xxxxxxxxx",
      "CostRuleId": "924d450014e64e88ac6e8486f8e990**",
      "GwClusterId": "pg-xxxxxxxxxx",
      "GmtCreated": "2026-01-04T16:09:29+08:00",
      "GmtModified": "2024-10-16 16:46:20\n"
    }
  ]
}

錯誤碼

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

變更歷史

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