执行应用操作
调用 RunApplicationAction,对一个 E-MapReduce(EMR)集群中的各类服务进行重启等操作。
已拥有火山引擎账号并开通 EMR 权限
请求方式:POST
请求地址:https://open.volcengineapi.com/?Version=2023-08-15&Action=RunApplicationAction
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | RunApplicationAction | 要执行的操作,取值:RunApplicationAction。 |
Version | String | 是 | 2023-08-15 | API的版本,取值:2023-08-15。 |
ClusterId | String | 是 | emr-xxx | 集群ID |
ApplicationName | String | 是 | HDFS | 应用名称 |
componentName | String | 否 | NAMENODE | 组件名称 |
ActionName | String | 是 | INSTALL, //安装 | 操作名称 |
CommandParams | Array of Object | 否 | [{ | 操作参数 |
Remark | String | 是 | test | 操作备注 |
ClientToken | String | 否 | xxxxx | 调用方生成的唯一标识这次请求的标识,用来保证幂等 |
下表仅列出本接口特有的返回参数。更多信息请参见返回结构
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
ClusterId | String | emr-xxx | 集群ID |
OperationId | String | xxx | 集群操作ID |
ResultData | Object | null | 结果数据 |
{ "ClusterId":"emr-xxx", "ApplicationName":"HDFS", "ComponentName":"NAMENODE", "ActionName":"RESTART", "CommandParams":[{ "Key":"hostNames", "Value":"['\''master-1-1.emr-xxx'\'']" }], "Remark":"openapi重启spark服务测试" }
{ "ResponseMetadata": { "RequestId": "202312042119240BF21498512872xxx", "Action": "RunApplicationAction", "Version": "2023-08-15", "Service": "emr", "Region": "cn-beijing", "Error": null, "Deprecated": false }, "Result": { "OperateId": "xxx", "ClusterId": "emr-xxx", "ResultData": null } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 说明 |
---|---|---|
400 | IllegalOperationForCluster | 非法操作,该集群不支持该操作 |
400 | InvalidClusterId | 集群不存在 |
400 | InvalidRequest | 对该集群没有权限 |