API標準及多語言預置SDK
本產品（Emr/2021-03-20）的OpenAPI採用RPC簽名風格。我們已經為開發人員封裝了常見程式設計語言的SDK，開發人員可通過下載SDK直接調用本產品OpenAPI而無需關心技術細節。如果現有SDK不能滿足使用需求，可通過簽名機制進行自簽名對接。由於自簽名細節非常複雜，需花費 5個工作日左右。因此建議加入我們的服務DingTalk群（147535001692），在專家指導下進行簽名對接。
在使用API前，您需要準備好身份帳號及存取金鑰（AccessKey），才能有效通過用戶端工具（SDK、CLI等）訪問API。細節請參見擷取AccessKey。
自訂簽名情境
若您的業務情境有特殊需求，需通過自簽名方式對接 API，建議優先諮詢我們的支援人員團隊（服務DingTalk群：147535001692），擷取專業指導以確保高效接入。
帳號與安全準備
阿里雲帳號具備對所有資源的完全系統管理權限。一旦 AccessKey 泄露，所有相關資源都將面臨未經授權訪問的風險。為確保安全，建議建立一個僅具備 API 存取權限的RAM使用者並配置其 AccessKey，同時基於最小許可權原則 (PoLP) 配置 RAM 策略。僅在明確需要阿里雲帳號許可權的特定情境下，才使用阿里雲帳號。
基礎
|
API |
標題 |
API概述 |
| ListReleaseVersions | 查詢版本 | 查看EMR發布主板本。 |
| ListInstanceTypes | 擷取執行個體類型列表 | 擷取EMR機型列表。 |
叢集
|
API |
標題 |
API概述 |
| RunCluster | 建立叢集 | 建立一個隨用隨付或者預付費（訂用帳戶）叢集。 |
| CreateCluster | 建立叢集 | 建立一個隨用隨付或者預付費（訂用帳戶）的叢集。 |
| GetCluster | 擷取叢集 | 擷取叢集詳情。 |
| UpdateClusterAttribute | 更新叢集屬性 | 更新叢集屬性。 |
| ListClusters | 查詢叢集 | 查詢EMR叢集列表。 |
| DeleteCluster | 刪除叢集 | 刪除一個隨用隨付的叢集。 |
| GetClusterCloneMeta | 擷取叢集複製中繼資料 | 擷取EMR叢集複製中繼資料資訊，便於通過 CreateCluster API快速建立叢集。 |
| UpdateClusterAutoRenew | 修改叢集的自動續約屬性 | 為您的EMR叢集及其下ECS執行個體修改自動續約的屬性，即配置自動續約的開啟/關閉。 |
叢集範本
|
API |
標題 |
API概述 |
| CreateApiTemplate | 建立API模板 | 建立一個預定義的API模板，該模板包含了API的基本結構、請求方式、URL路徑、請求參數和響應格式等資訊。 |
| UpdateApiTemplate | 更新API模板 | 更新API模板。 |
| ListApiTemplates | 查看API模板列表 | 查看API模板列表。 |
| GetApiTemplate | 查看API模板內容 | 擷取特定API模板的詳細配置資訊。 |
| DeleteApiTemplate | 刪除API模板 | 刪除指定的API模板。 |
| RunApiTemplate | 調用API模板 | 調用 API 模板。 |
節點群組
|
API |
標題 |
API概述 |
| CreateNodeGroup | 建立節點群組 | 建立節點群組。 |
| ListNodeGroups | 查詢節點群組 | 查詢EMR叢集節點群組列表。 |
| GetNodeGroup | 擷取節點群組 | 擷取節點群組詳情。 |
| IncreaseNodes | 擴容 | 對目標節點群組執行擴容操作。 |
| DecreaseNodes | 縮容 | 對目標節點群組執行縮容操作。 |
| ListNodes | 查詢節點 | 查詢EMR叢集節點列表。 |
彈性伸縮
|
API |
標題 |
API概述 |
| PutAutoScalingPolicy | 建立自訂Auto Scaling策略 | 建立自訂Auto Scaling策略。 |
| GetAutoScalingPolicy | 查看自訂Auto Scaling策略 | 查看自訂Auto Scaling策略。 |
| GetManagedScalingPolicy | 查看託管Auto Scaling策略 | 查看託管伸縮策略內容。 |
| RemoveAutoScalingPolicy | 刪除Auto Scaling策略 | 刪除Auto Scaling策略。 |
| ListAutoScalingActivities | 查詢Auto Scaling活動 | 查詢Auto Scaling活動列表。 |
| GetAutoScalingActivity | 擷取Auto Scaling活動 | 擷取Auto Scaling活動詳情。 |
應用
|
API |
標題 |
API概述 |
| ListApplications | 查詢應用列表 | 查詢應用列表。 |
| GetApplication | 擷取應用詳情 | 擷取應用詳情。 |
| RunApplicationAction | 執行應用操作 | 本介面用於對叢集安裝的應用執行啟動，停止等管理操作。 |
| ListApplicationConfigs | 查詢應用配置 | 查詢應用配置。 |
| UpdateApplicationConfigs | 更新應用配置 | 更新應用配置。 |
| ListComponents | 查詢組件列表 | 查詢組件列表。 |
| ListComponentInstances | 查詢組件執行個體列表 | 查詢組件執行個體列表。 |
操作
|
API |
標題 |
API概述 |
| GetOperation | 擷取操作 | 擷取一個非同步作業詳情。 |
資源群組
|
API |
標題 |
API概述 |
| JoinResourceGroup | 加入資源群組 | 將一個EMR資源加入目標資源群組。一個資源只能屬於一個資源群組。 |
標籤
|
API |
標題 |
API概述 |
| TagResources | 打標籤 | 為指定的EMR叢集綁定標籤。 |
| UntagResources | 刪標籤 | 為指定的EMR叢集列統一解除綁定標籤。解除綁定後，如果該標籤沒有綁定其他任何資源，該標籤會被自動刪除。 |
| ListTagResources | 查詢標籤 | 查詢EMR叢集綁定的標籤列表。 |
指令碼
|
API |
標題 |
API概述 |
| CreateScript | 建立指令碼 | 建立引導指令碼或者普通叢集指令碼。 |
| ListScripts | 查詢指令碼 | 查詢EMR叢集引導指令碼或普通指令碼。 |
| UpdateScript | 更新指令碼 | 更新引導指令碼或者普通指令碼。 |
| DeleteScript | 刪除指令碼 | 刪除引導指令碼或者普通指令碼。 |
監控診斷
|
API |
標題 |
API概述 |
| ListDoctorHiveDatabases | 批量擷取 Hive 庫資訊 | 批量擷取 Hive 庫維度分析結果。 |
| GetDoctorHiveDatabase | 擷取Hive庫資訊 | 擷取 Hive 庫維度分析結果。 |
| GetDoctorHiveCluster | 擷取 Hive 叢集資訊 | 擷取 Hive 叢集維度分析結果。 |
| ListDoctorHiveTables | 批量擷取Hive表分析結果 | 通過EMR Doctor批量擷取Hive表分析結果。 |
| GetDoctorHiveTable | 擷取Hive表分析結果 | 通過EMR Doctor擷取叢集Hive特定表分析結果。 |
| ListDoctorHDFSUGI | 批量擷取屬主或屬組HDFS分析結果 | 通過EMR Doctor批量擷取屬主或者屬組的HDFS分析結果。 |
| ListDoctorHBaseTables | 批量擷取 HBase Table 資訊 | 批量擷取 HBase Table 資訊。 |
| ListDoctorHBaseRegionServers | 批量擷取 HBase ReagionServer 資訊 | 批量擷取 HBase ReagionServer 資訊。 |
| GetDoctorHBaseTable | 擷取 HBase Table 資訊 | 擷取 HBase Table 資訊。 |
| GetDoctorHBaseRegionServer | 擷取 HBase ReagionServer 資訊 | 擷取 HBase ReagionServer 資訊。 |
| GetDoctorHBaseRegion | 擷取 HBase Region 資訊 | 擷取 HBase Region 資訊。 |
| GetDoctorHBaseCluster | 擷取 HBase 叢集資訊 | 擷取 HBase 叢集維度指標資訊。 |
| GetDoctorHDFSDirectory | 擷取HDFS特定目錄分析結果 | 通過EMR Doctor擷取叢集HDFS特定目錄資料分析結果，目錄不超過5級。 |
| ListDoctorJobsStats | 批量擷取任務運行摘要資料 | 通過EMR Doctor批量擷取任務基本運行匯總資訊。 |
| ListDoctorReports | 批量擷取叢集報告 | 批量擷取 EMR Doctor 整體分析結果報告。 |
| GetDoctorReportComponentSummary | 擷取指定組件報告 | 擷取 EMR Doctor 指定組件分析結果報告。 |
| ListDoctorJobs | 批量擷取任務運行結果 | 通過EMR Doctor批量擷取任務基本運行資訊。 |
| ListDoctorComputeSummary | 批量擷取叢集資源使用結果 | 通過EMR Doctor根據過濾條件批量擷取叢集資源使用方式。 |
| GetDoctorComputeSummary | 擷取叢集單個資源使用結果 | 通過EMR Doctor擷取叢集單個資源使用結果。 |
| GetDoctorJob | 擷取單個任務運行結果 | 通過EMR Doctor擷取任務基本運行資訊。 |
| ListDoctorApplications | 批量擷取任務分析結果 | 通過EMR Doctor擷取批量任務分析結果。 |
| ListDoctorHDFSDirectories | 批次獲取HDFS目錄分析結果 | 透過EMR Doctor批次獲取特定目錄分析結果，目錄不超過5級。 |
| GetDoctorHDFSCluster | 擷取HDFS分析結果 | 通過EMR Doctor擷取叢集HDFS資料分析結果。 |
| GetDoctorApplication | 擷取單個任務分析結果 | 通過EMR Doctor擷取任務分析資訊。 |
OpenLDAP使用者管理
|
API |
標題 |
API概述 |
| CreateUsers | 大量建立使用者 | 大量建立使用者 |
| DeleteUsers | 大量刪除使用者 | 大量刪除使用者。 |
| UpdateUserAttribute | 更新使用者資訊 | 更新使用者資訊。 |
| ListUsers | 查詢使用者列表 | 查詢使用者。 |
其他
|
API |
標題 |
API概述 |
| ExportApplicationConfigs | 匯出服務配置 | 匯出叢集指定服務配置 |
Others
|
API |
標題 |
API概述 |
| DeleteNodeGroup | 刪除節點群組 | 刪除已建立的叢集節點群組。 |
| UpdateNodeGroupAttributes | 更新叢集節點組屬性 | 更新節點組屬性。 |