ListCostAnalysisOpenApi - 查询费用分析数据--费用中心-火山引擎

文档中心

费用中心

费用管理

ListCostAnalysisOpenApi - 查询费用分析数据

查询费用分析数据

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	ListCostAnalysisOpenApi	要执行的操作，取值：ListCostAnalysisOpenApi。
Version	String	是	2022-01-01	API的版本，取值：2022-01-01。
CostType	Integer	是	0	费用类型：若账单口径为0（账单），可选填 0:原价、1:折后价、2:应付金额、3:现金支付若账单口径为1（成本账单），可选填 4:本期已分摊-原价、5:本期已分摊-折后价、6:本期已分摊-应付金额、7:本期已分摊-现金支付
TimeGranularity	Integer	是	0	查询时间粒度 0:账期, 1:天
BeginTimeStr	String	是	2025-01-01	查询开始时间，东八区时间当TimeGranularity为0时，格式为YYYY-MM-01 当TimeGranularity为1时，格式为YYYY-MM-DD
EndTimeStr	String	是	2025-01-01	查询开始时间，东八区时间 - 当TimeGranularity为0时，格式为YYYY-MM-01 - 当TimeGranularity为1时，格式为YYYY-MM-DD
ClassifyDimension	Integer	是	10	分类维度： 1:payer, 2:owner, 3:产品, 4:计费模式, 5:计费单元, 6:地域, 7:可用区, 8:账单类型, 9:项目, 10:标签, 11:实例id、12:业务类型, 13:服务主体, 15:分拆项, 16: 配置名称, 17: 成本单元
ClassifyDimensionValue	String	否	tagA	若ClassifyDimension为10（标签），此处填tag标签若ClassifyDimension为11（实例ID），此处填实例ID，多个实例ID用逗号分隔若ClassifyDimension为15（分拆项），此处填分拆项
Filters	Array of Object	否	[ { "Operator":0, "FilterKey": 1, "FilterValue": [ "2000000000" ] } ]	过滤条件此参数不携带或携带值为空列表或携带值为null时，不作为筛选条件
Limit	Integer	否	100	每次查询的记录数，默认为10
Offset	Integer	否	0	偏移量，从0开始，默认值为0

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
CostData	Array of Object	[ { "ClassifyDimension": 1, "ClassifyItem": "总费用", "Costs": [ { "TimeStr": "2025-10", "Amount": "70.006000" }, { "TimeStr": "2025-11", "Amount": "2310.200000" }, { "TimeStr": "2025-12", "Amount": "51.700500" } ], "TotalAmount": "2431.906500" }, { "ClassifyDimension": 1, "ClassifyItem": "weitest10", "Costs": [ { "TimeStr": "2025-11", "Amount": "2310.000000" }, { "TimeStr": "2025-10", "Amount": "70.006000" }, { "TimeStr": "2025-12", "Amount": "50.500000" } ], "TotalAmount": "2430.506000" }, { "ClassifyDimension": 1, "ClassifyItem": "weitest009", "Costs": [ { "TimeStr": "2025-12", "Amount": "1.200500" }, { "TimeStr": "2025-11", "Amount": "0.200000" } ], "TotalAmount": "1.400500" } ]	费用数据
Total	Integer	2	总条数
Limit	Integer	10	步长
Offset	Integer	0	偏移量

请求示例

{
    "BeginTimeStr": "2025-10-01",
    "EndTimeStr": "2025-12-01",
    "TimeGranularity": 0,
    "AccountId": 2100057674,
    "ClassifyDimension": 1,
    "CostType": 1,
    "Limit": 30,
    "Offset": 0
}

返回示例

{
    "CostData": [
        {
            "ClassifyDimension": 1,
            "ClassifyItem": "总费用",
            "Costs": [
                {
                    "TimeStr": "2025-10",
                    "Amount": "70.006000"
                },
                {
                    "TimeStr": "2025-11",
                    "Amount": "2310.200000"
                },
                {
                    "TimeStr": "2025-12",
                    "Amount": "51.700500"
                }
            ],
            "TotalAmount": "2431.906500"
        },
        {
            "ClassifyDimension": 1,
            "ClassifyItem": "weitest10",
            "Costs": [
                {
                    "TimeStr": "2025-11",
                    "Amount": "2310.000000"
                },
                {
                    "TimeStr": "2025-10",
                    "Amount": "70.006000"
                },
                {
                    "TimeStr": "2025-12",
                    "Amount": "50.500000"
                }
            ],
            "TotalAmount": "2430.506000"
        },
        {
            "ClassifyDimension": 1,
            "ClassifyItem": "weitest009",
            "Costs": [
                {
                    "TimeStr": "2025-12",
                    "Amount": "1.200500"
                },
                {
                    "TimeStr": "2025-11",
                    "Amount": "0.200000"
                }
            ],
            "TotalAmount": "1.400500"
        }
    ],
    "Currency": "",
    "Total": 2,
    "Limit": 30,
    "Offset": 0,
    "BaseResp": {
        "StatusMessage": "",
        "StatusCode": 0,
        "HTTPStatusCode": 0,
        "ErrorCode": ""
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	MissingParameter	The request is missing %s parameter.	参数缺失
400	InvalidParam	The parameter %s is invalid.	参数无效
403	RequestReject	You have engaged in unauthorized operations, and the function is temporarily unavailable.	您涉及违规操作，暂时无法使用该功能
404	RecordNotFound	Record not found	记录未找到
429	FrequentRequest	Frequent operations, please try again later.	操作频繁，请稍后尝试
500	InternalError	Service has some internal Error. Pls Contact With Admin.	服务内部异常

最近更新时间：2026.03.02 21:10:33

这个页面对您有帮助吗？

有用

无用

费用中心

请求参数 #

返回参数 #

请求示例 #

返回示例 #

错误码 #

请求参数

返回参数

请求示例

返回示例

错误码