You need to enable JavaScript to run this app.
导航

RunApplicationAction - 执行应用操作

最近更新时间2024.01.22 15:54:50

首次发布时间2024.01.22 15:54:50

执行应用操作

使用说明

调用 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, //安装
UNINSTALL, //卸载
START, //启动
RESTART, //重启
ROLLING_RESTART, //滚动重启
STOP, //停止
REBALANCE, //再平衡
REFRESHQUEUE, //刷新队列
DECOMMISSION_COMPONENT, //下线组件
RECOMMISSION_COMPONENT; //上线组件

操作名称

CommandParams
Array of CommandParam

[{
"Key":"hostNames",
"Value":"['''master-1-1.emr-xxx''']"
}]

操作参数

Remark
String

test

操作备注

ClientToken
String

xxxxx

调用方生成的唯一标识这次请求的标识,用来保证幂等

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数
类型
示例值
描述
ClusterId
String

emr-xxx

集群ID

OperationId
String

xxx

集群操作ID

请求示例

{
    "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
    }   
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

HttpCode
错误码
错误信息
说明
400
InvalidClusterId
cluster id {clusterId} not found

集群不存在

400
InvalidRequest
Access Denied {clusterId}

对该集群没有权限

400
IllegalOperationForCluster
The cluster id {clusterId} does not support the operation

非法操作,该集群不支持该操作