调用ExecContainerCommand在容器内部执行命令。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ExecContainerCommand

系统规定参数。取值:ExecContainerCommand。

RegionId String cn-hangzhou

实例所属的地域ID。

ContainerGroupId String eci-2zebxkiifulhl****

实例ID,即容器组ID。

ContainerName String nginx

容器名称。

Command String ["/bin/sh", "-c", "ls -a"]

要在容器内执行的命令序列。最多20个命令,单个命令最长256个字符。

执行多个命令时,字符串需按照JSON格式传入,例如:["/bin/sh", "-c", "ls -a"]

TTY Boolean false

是否开启交互。默认为false。

当Command为/bin/bash命令时,需要设置为true。

Stdin Boolean true

是否标准输入。默认为true。

Sync Boolean false

是否立即执行命令并同步返回结果。默认为false。

如果设置为true,TTY只能设置为false。

返回数据

名称 类型 示例值 描述
HttpUrl String https://eci.console.aliyun.com/terminal?param=X32a****

HTTP URL。在30秒内访问该地址可以进入到容器。更多信息,请参见使用并集成ECI Terminal

RequestId String 28B583A8-313D-4383-7817-B5A9F7E0****

请求ID,唯一标识。

SyncResponse String Hello

命令的返回结果。当Sync设置为true时返回该参数。

WebSocketUri String wss://eci-cn-shanghai.aliyun.com/exec/?s=ktHPx****

WebSocket URL。您可以利用WebSocket URL建立与容器的连接。

示例

请求示例

https://eci.aliyuncs.com/?Action=ExecContainerCommand
&RegionId=cn-hangzhou
&ContainerGroupId=eci-2zebxkiifulhl****
&ContainerName=nginx
&Command=ls
&<公共请求参数>

正常返回示例

XML格式

<ExecContainerCommandResponse>
      <RequestId>28B583A8-313D-4383-7817-B5A9F7E0****</RequestId>
      <WebSocketUri>wss://eci-cn-shanghai.aliyun.com/exec/?s=ktHPx****</WebSocketUri>
      <HttpUrl>https://eci.console.aliyun.com/terminal?param=X32a****</HttpUrl>
</ExecContainerCommandResponse>

JSON格式

{
	"RequestId": "28B583A8-313D-4383-7817-B5A9F7E0****",
	"WebSocketUri": "wss://eci-cn-shanghai.aliyun.com/exec/?s=ktHPx****",
	"HttpUrl": "https://eci.console.aliyun.com/terminal?param=X32a****"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParameter.ValueExceeded %s 参数值超过规定范围
400 IncorrectStatus %s 指定的实例状态不正确。

访问错误中心查看更多错误码。