API 標準および多言語対応の SDK
本製品 (Emr/2021-03-20) の API は、RPC 標準に準拠した OpenAPI 仕様を採用しています。Alibaba Cloud には主要なプログラミング言語に対応した SDK が用意され、リクエスト署名のような手間がかかる手順を省略できます。そのため、開発者は HTTP 通信の詳細を意識することなく、各言語の構文で API を呼び出すことが可能になります。
カスタム署名
署名のカスタマイズが必要な場合、「署名メカニズム」を参照してリクエストに手動で署名できます。手動署名プロセスは非常に煩雑で、通常はおよそ 5 営業日かかります。詳細については、DingTalk サポート窓口 (グループチャット ID：147535001692) までお問い合わせください。
はじめに
Alibaba Cloud アカウント (root ユーザー) は最高レベルの管理権限を持ち、その AccessKey ペアが悪用されると、関連するすべてのリソースが不正にアクセスされ、重大なセキュリティリスクを引き起こす可能性があります。そのため、必要な場合以外は、Alibaba Cloud アカウントを使用しないでください。その代わりに、API のみでのアクセスを許可された Resource Access Management (RAM) ユーザーを作成し、RAM ポリシーを設定することで、最小権限の原則 (PoLP) を徹底してください。
API セキュリティを確保するには、以下を作成し、設定する必要があります。
RAM ユーザー
RAM ユーザー用の AccessKey ペア
基本
|
API |
タイトル |
説明 |
| ListReleaseVersions | ListReleaseVersions | E-MapReduce (EMR) のメジャーバージョンを照会します。 |
| ListInstanceTypes | ListInstanceTypes | EMR インスタンスタイプのリストを取得します。 |
クラスター
|
API |
タイトル |
説明 |
| RunCluster | RunCluster | 従量課金またはサブスクリプションのクラスターを作成します。 |
| CreateCluster | CreateCluster | 従量課金またはサブスクリプションのクラスターを作成します。 |
| GetCluster | GetCluster | クラスターの詳細を取得します。 |
| UpdateClusterAttribute | UpdateClusterAttribute | クラスターの属性を更新します。 |
| ListClusters | ListClusters | EMR クラスターを一覧表示します。 |
| DeleteCluster | DeleteCluster | 従量課金クラスターを削除します。 |
| GetClusterCloneMeta | GetClusterCloneMeta | E-MapReduce (EMR) クラスターのクローンメタデータを取得します。このメタデータを使用すると、CreateCluster 操作を呼び出してクラスターを迅速に作成できます。 |
| UpdateClusterAutoRenew | UpdateClusterAutoRenew | EMR クラスターとその Elastic Compute Service (ECS) インスタンスの自動更新を有効または無効にします。 |
クラスターテンプレート
|
API |
タイトル |
説明 |
| CreateApiTemplate | CreateApiTemplate | 事前定義された API 操作テンプレートを作成します。このテンプレートには、基本構造、リクエストメソッド、URL パス、リクエストパラメーター、応答フォーマットなど、API 操作に関する情報が含まれます。 |
| UpdateApiTemplate | UpdateApiTemplate | API 操作テンプレートを更新します。 |
| ListApiTemplates | ListApiTemplates | API テンプレートを一覧表示します。 |
| GetApiTemplate | GetApiTemplate | API 操作テンプレートの詳細な構成情報を照会します。 |
| DeleteApiTemplate | DeleteApiTemplate | API 操作テンプレートを削除します。 |
| RunApiTemplate | RunApiTemplate | API テンプレートを実行します。 |
ノードグループ
|
API |
タイトル |
説明 |
| CreateNodeGroup | CreateNodeGroup | ノードグループを作成します。 |
| ListNodeGroups | ListNodeGroups | EMR クラスターのノードグループをクエリします。 |
| GetNodeGroup | GetNodeGroup | この操作を呼び出して、ノードグループの詳細を取得できます。 |
| IncreaseNodes | IncreaseNodes | ターゲットノードグループをスケールアウトします。 |
| DecreaseNodes | DecreaseNodes | ターゲットノードグループをスケールインします。 |
| ListNodes | ListNodes | EMR クラスターのノードリストを照会します。 |
auto scaling
|
API |
タイトル |
説明 |
| PutAutoScalingPolicy | PutAutoScalingPolicy | カスタム Auto Scaling ポリシーを作成します。 |
| GetAutoScalingPolicy | GetAutoScalingPolicy | カスタム Auto Scaling ポリシーの詳細を取得します。 |
| GetManagedScalingPolicy | GetManagedScalingPolicy | マネージドスケーリングポリシーの詳細を取得します。 |
| RemoveAutoScalingPolicy | RemoveAutoScalingPolicy | オートスケーリングポリシーを削除します。 |
| ListAutoScalingActivities | ListAutoScalingActivities | Auto Scaling のアクティビティを一覧表示します。 |
| GetAutoScalingActivity | GetAutoScalingActivity | Auto Scaling アクティビティの詳細を取得します。 |
アプリケーション
|
API |
タイトル |
説明 |
| ListApplications | ListApplications | アプリケーションのリストを照会します。 |
| GetApplication | GetApplication | アプリケーションの詳細を取得します。 |
| RunApplicationAction | RunApplicationAction | クラスターにデプロイされたサービスを管理します。たとえば、この操作を呼び出して、サービスの開始または停止ができます。 |
| ListApplicationConfigs | ListApplicationConfigs | アプリケーションの構成を照会します。 |
| UpdateApplicationConfigs | UpdateApplicationConfigs | アプリケーションの構成を更新します。 |
| ListComponents | ListComponents | コンポーネントのリストを取得します。 |
| ListComponentInstances | ListComponentInstances | コンポーネントインスタンスのリストを取得します。 |
操作
|
API |
タイトル |
説明 |
| GetOperation | GetOperation | 非同期操作の詳細を取得します。 |
リソースグループ
|
API |
タイトル |
説明 |
| JoinResourceGroup | JoinResourceGroup | EMR リソースをリソースグループに追加します。1 つのリソースは 1 つのリソースグループにのみ所属できます。 |
タグ
|
API |
タイトル |
説明 |
| TagResources | TagResources | 指定された EMR クラスターにタグをバインドします。 |
| UntagResources | UntagResources | EMR クラスター内の指定されたリソースからタグを解除します。タグが他のリソースにバインドされていない場合、そのタグは自動的に削除されます。 |
| ListTagResources | ListTagResources | E-MapReduce (EMR) クラスターにアタッチされているタグを照会します。 |
スクリプト
|
API |
タイトル |
説明 |
| CreateScript | CreateScript | ブートストラップスクリプトまたは通常のクラスタースクリプトを作成します。 |
| ListScripts | ListScripts | EMR クラスターのブートストラップスクリプトまたは通常のスクリプトをクエリします。 |
| UpdateScript | UpdateScript | E-MapReduce (EMR) クラスターのブートストラップアクションまたは一般的なスクリプトを更新します。 |
| DeleteScript | DeleteScript | E-MapReduce (EMR) クラスターのブートストラップアクションまたは共通スクリプトを削除します。 |
モニタリングと診断
|
API |
タイトル |
説明 |
| ListDoctorHiveDatabases | ListDoctorHiveDatabases | 複数の Hive データベースの分析結果を一度に取得します。 |
| GetDoctorHiveDatabase | GetDoctorHiveDatabase | Hive データベースの分析結果を取得します。 |
| GetDoctorHiveCluster | GetDoctorHiveCluster | Hive クラスターの分析結果を取得します。 |
| ListDoctorHiveTables | ListDoctorHiveTables | E-MapReduce (EMR) Doctor で、複数の Hive テーブルの分析結果を一度に取得します。 |
| GetDoctorHiveTable | GetDoctorHiveTable | E-MapReduce (EMR) Doctor 上のクラスター内の特定の Hive テーブルの分析結果を取得します。 |
| ListDoctorHDFSUGI | ListDoctorHDFSUGI | E-MapReduce (EMR) Doctor で、複数のオーナーまたはグループの Hadoop 分散ファイルシステム (HDFS) ストレージリソースの分析結果を一度に取得します。 |
| ListDoctorHBaseTables | ListDoctorHBaseTables | 複数の HBase テーブルの情報を一度に取得します。 |
| ListDoctorHBaseRegionServers | ListDoctorHBaseRegionServers | 複数の HBase リージョンサーバーの情報を一度に取得します。 |
| GetDoctorHBaseTable | GetDoctorHBaseTable | HBase テーブルの情報を取得します。 |
| GetDoctorHBaseRegionServer | GetDoctorHBaseRegionServer | HBase リージョンサーバーに関する情報を取得します。 |
| GetDoctorHBaseRegion | GetDoctorHBaseRegion | HBase リージョンの情報を取得します。 |
| GetDoctorHBaseCluster | GetDoctorHBaseCluster | HBase クラスターのメトリックを取得します。 |
| GetDoctorHDFSDirectory | GetDoctorHDFSDirectory | クラスターの特定の Hadoop 分散ファイルシステム (HDFS) ディレクトリの分析結果を取得します。ディレクトリの深さは 5 以下である必要があります。 |
| ListDoctorJobsStats | ListDoctorJobsStats | E-MapReduce (EMR) Doctor で、複数のジョブの基本的な実行情報の概要を一度に取得します。 |
| ListDoctorReports | ListDoctorReports | E-MapReduce (EMR) Doctor の全体的な分析結果レポートを一度に取得します。 |
| GetDoctorReportComponentSummary | GetDoctorReportComponentSummary | EMR Doctor から指定されたコンポーネントの分析結果レポートを取得します。 |
| ListDoctorJobs | ListDoctorJobs | E-MapReduce (EMR) Doctor で、複数のジョブの基本的な実行情報を一度に取得します。 |
| ListDoctorComputeSummary | ListDoctorComputeSummary | E-MapReduce (EMR) Doctor で、クラスター内のリソースタイプ別のリソース使用量に関する情報を取得します。 |
| GetDoctorComputeSummary | GetDoctorComputeSummary | E-MapReduce (EMR) Doctor 上のクラスターにおけるリソース使用量に関する情報を取得します。 |
| GetDoctorJob | GetDoctorJob | E-MapReduce (EMR) Doctor 上のジョブに関する基本的な実行情報を取得します。 |
| ListDoctorApplications | ListDoctorApplications | E-MapReduce (EMR) Doctor で複数のジョブの分析結果を取得します。 |
| ListDoctorHDFSDirectories | ListDoctorHDFSDirectories | EMR Doctor を使用して、特定のディレクトリのバッチ分析結果を取得します。ディレクトリの深さは 5 レベルを超えることはできません。 |
| GetDoctorHDFSCluster | GetDoctorHDFSCluster | E-MapReduce (EMR) Doctor で、クラスターの Hadoop 分散ファイルシステム (HDFS) ストレージリソースの分析結果を取得します。 |
| GetDoctorApplication | GetDoctorApplication | E-MapReduce (EMR) Doctor のジョブ分析情報を取得します。 |
OpenLDAP ユーザー管理
|
API |
タイトル |
説明 |
| CreateUsers | CreateUsers | ユーザーをバッチで作成します。 |
| DeleteUsers | DeleteUsers | 複数のユーザーを一度に削除します。 |
| UpdateUserAttribute | UpdateUserAttribute | ユーザーに関する情報を更新します。 |
| ListUsers | ListUsers | ユーザーをクエリします。 |
その他
|
API |
タイトル |
説明 |
| ExportApplicationConfigs | ExportApplicationConfigs | クラスター内の指定されたサービスの構成をエクスポートします。 |
Others
|
API |
タイトル |
説明 |
| DeleteNodeGroup | ノードグループを削除します | 作成済みのクラスターノードグループを削除します。 |
| UpdateNodeGroupAttributes | クラスターノードグループの属性を更新します | ノードグループの属性を更新します。 |