All Products
Search

This Product

    Cloud Phone:RunCommand

    Document Center

    Cloud Phone:RunCommand

    Last Updated:Apr 17, 2026

    Runs a command on one or more cloud phone instances.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    InstanceIds

    array

    No

    A list of instance IDs. You can specify up to 50 instances per request.

    string

    No

    The instance ID.

    acp-7b15ex96****
    CommandContent

    string

    No

    The content of the command.

    ls
    Timeout

    integer

    No

    The execution timeout in seconds. The command times out if it does not complete within this period. Defaults to 60 seconds.

    60
    AgentType

    string

    No

    The channel type for running the command.

    Valid values:

    • EdsAgent :

      The EdsAgent channel.

    • CloudAssistant :

      Cloud Assistant.

    EdsAgent
    ContentEncoding

    string

    No

    The encoding method for the command content (CommandContent). This value is not case-sensitive.

    Note

    An invalid value defaults to PlainText.

    Valid values:

    • Base64 :

      The content is Base64-encoded.

    • PlainText :

      The content is unencoded plaintext. This is the default.

    PlainText

    Response elements

    Element

    Type

    Description

    Example

    object

    The response parameters.

    RequestId

    string

    The request ID.

    440D7342-5E7C-B2DB-D0B4EAC2BDF1****
    InvokeId

    string

    The command execution ID. Use this ID to query the execution result.

    t-gov2ujrk32v4****
    TaskId

    string

    RunCommandInfos

    array<object>

    object

    InvokeId

    string

    InstanceId

    string

    ChildTaskId

    string

    Examples

    Success response

    JSON format

    {
  "RequestId": "440D7342-5E7C-B2DB-D0B4EAC2BDF1****",
  "InvokeId": "t-gov2ujrk32v4****",
  "TaskId": "",
  "RunCommandInfos": [
    {
      "InvokeId": "",
      "InstanceId": "",
      "ChildTaskId": ""
    }
  ]
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.