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

Elastic Compute Service:コマンドの作成

最終更新日:Aug 21, 2026

Cloud Assistant コマンドを使用すると、Elastic Compute Service (ECS) インスタンスで定型的なタスクを迅速に実行できます。たとえば、自動 O&M スクリプトの実行、プロセスのポーリング、ユーザーパスワードのリセット、ソフトウェアのインストールまたはアンインストール、アプリケーションの更新、パッチのインストールなどが可能です。コマンドは、Windows PowerShell スクリプト、Windows Bat スクリプト、または Linux Shell スクリプトのいずれかで記述でき、変数値を設定できるカスタムパラメーターをサポートしています。

制限事項

リソース 制限
リージョンあたりのコマンド数 500~50,000 (アカウントごとのクォータ。ECS の使用状況に応じて増加することがあります)
Base64 でエンコードされたスクリプトの最大サイズ 18 KB (コマンドを即時実行する場合は 24 KB)

クォータの確認または引き上げについては、「クォータの管理」をご参照ください。承認される可能性を高めるため、リクエストには詳細な理由を記載してください。

操作手順

ECS コンソールでのコマンド作成

  1. ECS Cloud Assistant ページに移動します。

  2. 上部メニューで、リージョンとリソースグループを選択します。

    コマンドをリソースグループに割り当てた後、リソースグループレベルでコマンドのアクセス許可を管理できます。そのリソースグループに必要なアクセスポリシーを追加してください。Cloud Assistant コマンドに適用されるアクセスポリシーおよびリソースグループの認可については、「Cloud Assistant コマンド固有のカスタムポリシーサンプル」および「リソースをリソースグループに分類し、リソースグループにアクセス許可を付与する」をご参照ください。
  3. [ECS Cloud Assistant] ページで、[コマンドの作成/実行] をクリックします。

  4. [コマンド情報] セクションで、コマンドを設定します。 コマンドタイプ:ターゲットインスタンスの OS に一致するタイプを選択します。 コマンド内容:コマンドを入力または貼り付けます。 保存する前に、構文、ロジック、アルゴリズムを確認してください。 例 — Linux インスタンスのファイルを /backup にアーカイブする場合:

    • [固定間隔で実行]: rate 式を使用して間隔 (60 秒~7 日) を設定します。間隔は、ある実行が開始されてから次の実行が開始されるまでの時間であり、実行時間とは異なります。たとえば、間隔が 5 分で実行に 2 分かかる場合、次の実行は、前回の実行が終了した 3 分後に開始されます。最初の実行は、タスク作成後、設定した間隔が経過してから開始されます。 > [注意:] 間隔は、コマンドのタイムアウト期間より長くする必要があります。

    • [時刻ベースのスケジュール Cron 式で実行]:Cron 式 (秒単位で正確) とタイムゾーンを指定します。最小間隔:10 秒 (タイムアウト期間を超える必要があります)。例:0 0 12 ? * WED 2022 と (GMT+08:00) Asia/Shanghai を指定すると、2022 年の毎週水曜日の 12:00:00 に実行されます。「Cron 式」をご参照ください。

    実行計画

    オプション 動作
    [事前チェックのみ] コマンドを適用せずに、リクエストの事前チェックを実行します。事前チェックでは、リクエストパラメーター、インスタンスの実行環境、および Cloud Assistant Agent のステータスをチェックします。
    [スケジュールに基づいて実行] コマンドをスケジュールされたタスクとして実行します。以下のオプションをご参照ください。

    その他のパラメーター

    パラメーター 説明
    [コマンド名] コマンドの名前です。
    [コマンドの説明] コマンドの目的の説明です。
    [ユーザー名] コマンドを実行する OS ユーザーです。デフォルト:root (Linux)、system (Windows)。必要最小限の権限を使用してください。「一般ユーザーとして Cloud Assistant コマンドを実行する」をご参照ください。
    [実行パス] インスタンス上でスクリプトが実行されるディレクトリです。デフォルト値:Linux の場合は /root、Windows の場合は C:\Windows\system32。スクリプトが意図したディレクトリで実行されるようにするには、スクリプトの冒頭に cd コマンドを追加してください。
    [タイムアウト] 最大実行時間です。有効な値:10~86,400 秒 (24 時間)。デフォルト値:60 秒。10 未満の値は 10 に設定されます。
    [タスク停止モード]

    タスクを停止したときにタスクがどのように終了するかを指定します。

    • [スクリプトプロセス]:スクリプトプロセスを終了します。

    • [プロセスツリー]:プロセスツリー (スクリプトプロセスとそれが作成したすべての子プロセス) を終了します。

    [コマンド内容]:[パラメーターを使用] をオンにできます。Base64 でエンコードした後、コマンド内容は 18 KB を超えてはなりません。ただし、コマンドを即時実行する ([実行] を選択する) 場合は、上限が 24 KB になります。

    カスタムパラメーター:{{parameter}} 形式でパラメーターを定義し、手動で値を割り当てます。カスタムパラメーターは動的な値をサポートし、1 つの値を複数の場所で再利用できます。

    組み込みパラメーター:Cloud Assistant は、実行時に自動的に置き換えられる組み込みパラメーターを提供しており、手動での割り当ては不要です。たとえば、リージョン ID の {{ACS::RegionId}} やインスタンス ID の {{ACS::InstanceId}} などがあります。

    #!/bin/bash
    # 例
    # {{name}} はカスタムパラメーターです。コマンド内容の記述が完了したら、値を割り当ててください。
    echo {{name}}
    
    # {{ACS::RegionId}} は組み込みパラメーターであり、手動での割り当ては不要です。
    echo {{ACS::RegionId}}
  5. [インスタンスの選択] または [マネージドインスタンスの選択] で、ターゲットインスタンスを選択します。複数のインスタンスを選択できますが、一度に最大 100 台までです。

  6. 保存 をクリックします。

Alibaba Cloud CLI によるコマンドの作成

リクエスト例

CreateCommand を呼び出してコマンドを作成します。次の例では、Linux インスタンスで OS を更新する update という名前のコマンドを作成します。

aliyun ecs CreateCommand --RegionId 'cn-hangzhou' \
--CommandContent 'eXVtIHVwZGF0ZSAteQ==' \
--Type 'RunShellScript' \
--Name 'update' \
--Description 'update' \
--output cols=CommandId
単一引用符内の値は、実際の値に置き換えてください。

次の表に、主要なパラメーターを示します。すべてのパラメーターについては、「CreateCommand」をご参照ください。

パラメーター 例 説明
RegionId cn-hangzhou リージョンです。
Name update コマンド名です。
Type RunShellScript コマンドタイプ:RunShellScript (Linux Shell)、RunBatScript (Windows Bat)、または RunPowerShellScript (Windows PowerShell)
CommandContent eXVtIHVwZGF0ZSAteQ== Base64 でエンコードされたコマンド内容です。
Description update コマンドの説明です。

レスポンス例

CommandId
---------
c-hz018qng4on****

次のステップ

コマンドを作成すると、マイ コマンド タブでその詳細を表示できます。特定のインスタンスでコマンドを実行するには、「コマンドを実行する」をご参照ください。

コマンドでパラメーターを使用する場合は、コマンドの実行時にコマンドパラメーター列にパラメーター値を入力します。