このトピックでは、Energy Expert API に関する基本情報と使用上の注意について説明します。
Alibaba Cloud の API 操作を呼び出す方法の詳細については、「概要」をご参照ください。
基本情報
API バージョン
API バージョン | 説明 |
API バージョン | 説明 |
推奨 |
エンドポイント
詳細については、「エンドポイント」をご参照ください。特定の API 操作の使用上の注意に特別な指示が含まれている場合は、特別な指示が優先されます。
ユーザー ID
ユーザー ID | サポート |
ユーザー ID | サポート |
はい | |
はい | |
RAM ロール (推奨) | はい |
API スタイル
リソース指向アーキテクチャ ( ROA ) スタイルが使用されます。 API スタイルの詳細については、「API スタイル」をご参照ください。
呼び出し方法
呼び出し方法 | サポート | 参照 |
呼び出し方法 | サポート | 参照 |
Alibaba Cloud SDK (推奨) | はい |
|
Alibaba Cloud CLI | いいえ | Alibaba Cloud CLI を使用して API 操作を呼び出す方法の詳細については、「Alibaba Cloud CLI」をご参照ください。 |
Resource Orchestration Service ( ROS ) | いいえ | Alibaba Cloud ROS を使用して API 操作を呼び出す方法の詳細については、「ROS」をご参照ください。 |
Terraform | いいえ | Terraform を使用して API 操作を呼び出す方法の詳細については、「Terraform」をご参照ください。 |
上記のいずれの方法でもビジネス要件を満たせない場合は、API 呼び出しのカスタムリクエストをカプセル化できます。詳細については、「カスタマイズカプセル化」をご参照ください。
パラメーター
企業コード
Energy Expert にログインします。左側のナビゲーションペインで、[組織] をクリックします。左側のセクションで、組織ツリーで表示するノードをクリックします。右側のセクションに企業コードが表示されます。次の図は例を示しています。
API データ識別子
Energy Expert は、データ項目を使用して、さまざまな炭素排出源の統計を記録します。 API を使用して統計を送信する前に、Energy Expert でデータ項目を作成し、データ項目の API データ識別子を構成する必要があります。手順:
1. 左側のナビゲーションペインで、[炭素] をクリックします。
2. 表示されるナビゲーションペインで、[データ管理] をクリックします。
3. 右上隅にある [設定] アイコンをクリックします。[データ項目の設定] ダイアログボックスで、前の図の electricity など、[ API データ識別] 列の API データ識別子を表示できます。
使用するデータ項目の [ API データ識別] 列が空の場合は、[操作] 列の [編集] アイコンをクリックできます。[データ項目の編集] ダイアログボックスで、[データ取得モード] ドロップダウンリストから [ API エントリ] を選択し、[ API データ識別] フィールドに識別子を入力します。次の図は例を示しています。
使用するデータ項目が存在しない場合は、[データ項目の設定] ダイアログボックスで [データ項目の追加] をクリックできます。[データ項目の追加] ダイアログボックスで、データ項目を作成します。
使用上の注意
Energy Expert API を統合するには、Alibaba Cloud SDK を使用することをお勧めします。