使用GetElecTrend获取电力用量与碳排放趋势数据-能耗宝-阿里云-能耗宝(Energy Expert)-阿里云帮助中心

本接口用于获取电力趋势分析数据。

接口说明

本接口返回值是一个列表，该列表的每一个元素是各种类型电力的排放列表。
关于上述各种类型电力的排放列表，其元素包含：排放年份和月份、用电量及其单位、用电量对应的碳排，用电量占该月总用电量比例。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

energy:GetElecTrend

none

*全部资源

*

无

请求语法

POST /api/v1/carbon/emission/analysis/elec/trend HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求体参数。
code	string	是	企业 code。	C-20240115-3
yearList	array	是	年份列表。
	integer	是	年份。	2023

返回参数

名称	类型	描述	示例值
	object	返回结构体。
requestId	string	请求 ID。	83A5A7DD-8974-5769-952E-590A97BEA34E
data	object	返回数据。
water	array<object>	水电逐月用电和碳排等数据。
	object	水电逐月用电和碳排等数据结构体。
carbonEmissionData	number	碳排量。	3.14
rawData	number	用电量。	3.14
ratio	number	用电量占当月所有用电量的比例：示例值：0.5（即占 50%）。	0.5
dataUnit	string	单位。	kWh
name	string	电力类型名称。	水电
nameKey	string	电力类型编码。	carbonInventory.check.water_electricity
month	integer	月份。	12
year	string	年份。	2024
light	array<object>	光电逐月用电和碳排等数据。
	object	光电逐月用电和碳排等数据结构体。
carbonEmissionData	number	碳排量。	3.14
rawData	number	用电量。	3.14
ratio	number	用电量占当月所有用电量的比例：示例值：0.5（即占 50%）。	0.5
dataUnit	string	单位。	kWh
name	string	电力类型名称。	光电
nameKey	string	电力类型编码。	carbonInventory.check.light_electricity
month	integer	月份。	12
year	string	年份。	2024
urban	array<object>	市电逐月用电和碳排等数据。
	object	市电逐月用电和碳排等数据结构体。
carbonEmissionData	number	碳排量。	3.14
rawData	number	用电量。	3.14
ratio	number	用电量占当月所有用电量的比例：示例值：0.5（即占 50%）。	0.5
dataUnit	string	单位。	kWh
name	string	电力类型名称。	市电
nameKey	string	电力类型编码。	carbonInventory.check.urban_electricity
month	integer	月份。	12
year	string	年份。	2024
wind	array<object>	风电逐月用电和碳排等数据。
	object	风电逐月用电和碳排等数据结构体。
carbonEmissionData	number	碳排量。	3.14
rawData	number	用电量。	3.14
ratio	number	用电量占当月所有用电量的比例：示例值：0.5（即占 50%）。	0.5
dataUnit	string	单位。	kWh
name	string	电力类型名称。	风电
nameKey	string	电力类型编码。	carbonInventory.check.wind_electricity
month	integer	月份。	12
year	string	年份。	2024
nuclear	array<object>	核电逐月用电和碳排等数据。
	object	核电逐月用电和碳排等数据结构体。
carbonEmissionData	number	碳排量。	3.14
rawData	number	用电量。	3.14
ratio	number	用电量占当月所有用电量的比例：示例值：0.5（即占 50%）。	0.5
dataUnit	string	单位。	kWh
name	string	电力类型名称。	核电
nameKey	string	电力类型编码。	carbonInventory.check.nuclear_electricity
month	integer	月份。	12
year	string	年份。	2024
renewing	array<object>	可再生电逐月用电和碳排等数据。
	object	可再生电逐月用电和碳排等数据结构体。
carbonEmissionData	number	碳排量。	3.14
rawData	number	用电量。	3.14
ratio	number	用电量占当月所有用电量的比例：示例值：0.5（即占 50%）。	0.5
dataUnit	string	单位。	kWh
name	string	电力类型名称。	可再生电
nameKey	string	电力类型编码。	carbonInventory.carbonEmissionAnalysis.components.CarbonDetail.lingTanDianLi
month	integer	月份。	12
year	string	年份。	2024
zero	array<object>	零电逐月用电和碳排等数据。
	object	零电逐月用电和碳排等数据结构体。
carbonEmissionData	number	碳排量。	3.14
rawData	number	用电量。	3.14
ratio	number	用电量占当月所有用电量的比例：示例值：0.5（即占 50%）。	0.5
dataUnit	string	单位。	kWh
name	string	电力类型名称。	零电
nameKey	string	电力类型编码。	carbonInventory.carbonEmissionAnalysis.components.CarbonDetail.lingTanDianLi
month	integer	月份。	12
year	string	年份。	2024
code	string	请求返回 code，Success 代表请求成功，其他情况代表请求不成功，具体错误原因描述可通过 msg 查看。	200

示例

正常返回示例

JSON格式

{
  "requestId": "83A5A7DD-8974-5769-952E-590A97BEA34E",
  "data": {
    "water": [
      {
        "carbonEmissionData": 3.14,
        "rawData": 3.14,
        "ratio": 0.5,
        "dataUnit": "kWh",
        "name": "水电",
        "nameKey": "carbonInventory.check.water_electricity",
        "month": 12,
        "year": "2024"
      }
    ],
    "light": [
      {
        "carbonEmissionData": 3.14,
        "rawData": 3.14,
        "ratio": 0.5,
        "dataUnit": "kWh",
        "name": "光电",
        "nameKey": "carbonInventory.check.light_electricity",
        "month": 12,
        "year": "2024"
      }
    ],
    "urban": [
      {
        "carbonEmissionData": 3.14,
        "rawData": 3.14,
        "ratio": 0.5,
        "dataUnit": "kWh",
        "name": "市电",
        "nameKey": "carbonInventory.check.urban_electricity",
        "month": 12,
        "year": "2024"
      }
    ],
    "wind": [
      {
        "carbonEmissionData": 3.14,
        "rawData": 3.14,
        "ratio": 0.5,
        "dataUnit": "kWh",
        "name": "风电",
        "nameKey": "carbonInventory.check.wind_electricity",
        "month": 12,
        "year": "2024"
      }
    ],
    "nuclear": [
      {
        "carbonEmissionData": 3.14,
        "rawData": 3.14,
        "ratio": 0.5,
        "dataUnit": "kWh",
        "name": "核电",
        "nameKey": "carbonInventory.check.nuclear_electricity",
        "month": 12,
        "year": "2024"
      }
    ],
    "renewing": [
      {
        "carbonEmissionData": 3.14,
        "rawData": 3.14,
        "ratio": 0.5,
        "dataUnit": "kWh",
        "name": "可再生电",
        "nameKey": "carbonInventory.carbonEmissionAnalysis.components.CarbonDetail.lingTanDianLi",
        "month": 12,
        "year": "2024"
      }
    ],
    "zero": [
      {
        "carbonEmissionData": 3.14,
        "rawData": 3.14,
        "ratio": 0.5,
        "dataUnit": "kWh",
        "name": "零电",
        "nameKey": "carbonInventory.carbonEmissionAnalysis.components.CarbonDetail.lingTanDianLi",
        "month": 12,
        "year": "2024"
      }
    ]
  },
  "code": "200"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。