すべてのプロダクト
Search
ドキュメントセンター

:RunSyncCommand

最終更新日:Mar 23, 2026

1 台以上の Cloud Phone インスタンスで同期コマンドを実行し、実行結果を返します。

操作説明

RunSyncCommand API は、通常数ミリ秒以内に結果を返す短時間実行コマンド向けに設計されています。数秒以上かかる長時間実行コマンドの場合は、非同期の RunCommand API をご使用ください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

POST  HTTP/1.1

リクエストパラメーター

パラメーター

必須 / 任意

説明

InstanceIds

array

任意

Cloud Phone インスタンス ID の配列です。1 回のリクエストで最大 50 台のインスタンスを指定できます。

string

任意

Cloud Phone インスタンス ID です。

acp-5hh431emkt6u*****

CommandContent

string

任意

実行するコマンドの内容です。

ls

WaitTime

integer

任意

コマンド実行のタイムアウト値(ミリ秒単位)です。有効範囲:500~3000。デフォルト値:1000。

1000

ContentEncoding

string

任意

コマンド内容のエンコーディング方式です。有効なオプション以外の値を指定した場合、システムはデフォルト値である PlainText を使用します。

列挙値:

  • Base64 :

    コンテンツが Base64 エンコーディングされています。

  • PlainText :

    コンテンツはエンコーディングされておらず、プレーンテキストとして送信されます。[デフォルト]

PlainText

レスポンスフィールド

フィールド

説明

object

応答オブジェクトです。

RequestId

string

リクエスト ID です。

5C5CEF0A-D6E1-58D3-8750-67DB4F82****

TotalCount

string

合計件数です。

31

Data

array<object>

各インスタンスの実行結果を含むオブジェクトの配列です。

object

1 台のインスタンスに対する実行結果です。

InvocationId

string

呼び出し ID です。

t-15775dc8****

StartTime

string

コマンド実行開始時刻です。

2022-10-11T08:53:32Z

FinishTime

string

コマンド実行終了時刻です。

2022-08-11 17:45:03

Output

string

コマンド出力です。

success

InstanceId

string

コマンドが実行されたインスタンスの ID です。

acp-uto81vfd8t8z****

InvocationStatus

string

コマンド実行ステータスです。

RUNNING

成功レスポンス

JSONJSON

{
  "RequestId": "5C5CEF0A-D6E1-58D3-8750-67DB4F82****",
  "TotalCount": "31",
  "Data": [
    {
      "InvocationId": "t-15775dc8****",
      "StartTime": "2022-10-11T08:53:32Z",
      "FinishTime": "2022-08-11 17:45:03",
      "Output": "success",
      "InstanceId": "acp-uto81vfd8t8z****",
      "InvocationStatus": "RUNNING"
    }
  ]
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。