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

Elastic Compute Service:コマンドの作成

最終更新日:May 16, 2026

ECS インスタンスにログインせずに、運用管理 (O&M) タスクを自動化するための再利用可能なクラウドアシスタントコマンドを作成します。

サポートされているコマンドタイプ:

OS サポートされるタイプ
Linux Shell、Python、Perl
Windows Bat、PowerShell

制限事項

リソース 制限
リージョンあたりのコマンド数 500~50,000(アカウントごとのクォータ。ECS の使用量に応じて増加する場合があります)
Base64 エンコード済みスクリプトの最大サイズ 18 KB
コマンドあたりのカスタムパラメーター数 20

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

前提条件

以下の条件を満たしていることを確認してください。

  • ECS へのアクセス権を持つ Alibaba Cloud アカウント。

  • (任意)RAM を使用してリソースグループレベルでコマンドの権限を管理するためのリソースグループ。

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

重要

AccessKey ペア、パスワード、認証コードなどの機密情報をプレーンテキストでコマンドに含めないでください。{{key}} 形式のカスタムパラメーターを使用し、実行時に値を指定してください。

  1. ECS クラウドアシスタントページに移動します。

  2. 上部のナビゲーションバーで、リージョンとリソースグループを選択します。

    リソースグループを使用すると、RAM ポリシーでコマンドの権限を管理できます。「クラウドアシスタントのコマンド固有のカスタム権限ポリシーのサンプル」および「リソースをリソースグループに分類し、リソースグループに権限を付与する」をご参照ください。

    Region

  3. ECS クラウドアシスタント ページで、[コマンドの作成/実行] をクリックします。

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

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

    • 指定時刻に 1 回のみ実行:日付、時刻、タイムゾーンを設定します。例:2022 年 5 月 17 日 17:30:50(GMT+08:00) Asia/Shanghai

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

    バージョン要件: - `{{ACS::InstanceId}}` および `{{ACS::InstanceName}}`: 各ターゲットインスタンスは、上記の最小のクラウドアシスタントエージェントバージョンを実行している必要があります。 - `{{ACS::InvokeId}}`: 上記の最小のエージェントバージョンが必要です。 - `{{ACS::CommandId}}`: RunCommand を呼び出す場合、上記の最小のエージェントバージョンが必要です。アップグレードするには、「クラウドアシスタントエージェントのインストール」をご参照ください。

    コマンドソース

    オプション 説明
    コマンド内容を入力 新しいコマンドを作成します。
    保存済みコマンドを選択 既存の保存済みコマンドを使用します。
    パラメーター 説明 最小クラウドアシスタントエージェントバージョン
    {{ACS::RegionId}} リージョン ID
    {{ACS::AccountId}} Alibaba Cloud アカウント UID
    {{ACS::InstanceId}} インスタンス ID Linux >= 2.2.3.309、Windows >= 2.1.3.309
    {{ACS::InstanceName}} インスタンス名 Linux >= 2.2.3.344、Windows >= 2.1.3.344
    {{ACS::InvokeId}} コマンドタスク ID Linux >= 2.2.3.309、Windows >= 2.1.3.309
    {{ACS::CommandId}} コマンド ID Linux >= 2.2.3.309、Windows >= 2.1.3.309

    実行プラン

    オプション 動作
    即時実行 [実行] または [実行して保存] をクリックした時点で実行されます。
    次回システム起動時 関連付けられたインスタンスが次に起動したときに実行されます。
    システム起動ごと 関連付けられたインスタンスが起動するたびに実行されます。
    スケジュールに従って実行 定義されたスケジュールに従って実行されます。以下のオプションをご参照ください。

    その他のパラメーター

    パラメーター 説明
    コマンド名 コマンドの名前です。
    コマンドの説明 コマンドの目的に関する説明です。
    ユーザー名 コマンドを実行する OS ユーザーです。デフォルト:root(Linux)、system(Windows)。必要な最小限の権限を使用してください。詳細については、「一般ユーザとしてクラウドアシスタントコマンドを実行する」をご参照ください。
    実行パス 作業ディレクトリです。デフォルト:/home(Linux)、C:\Windows\system32(Windows)。
    タイムアウト 最大実行時間(秒単位)です。デフォルト:60。最小値:10(10 未満の値は自動的に 10 に設定されます)。
    タグ 分類用のキーと値のペアです。[実行して保存] を選択すると、コマンドと実行タスクの両方にタグが適用されます。[実行] を選択すると、コマンドにのみタグが適用されます。
    #!/bin/bash
    OF=/backup/my-backup-$(date +%Y%m%d).tgz
    tar -cf $OF {{file}}

    {{file}} はカスタムパラメーターです。実行時に設定します (例: /app/usrcredential)。詳細については、「ECS インスタンスのシステム構成を表示する」をご参照ください。パラメーターの使用 [Use Parameters] をオンにして、{{key}} 形式でカスタムパラメーターを定義します。コマンドごとに最大 20 個のカスタムパラメーターを使用できます。クラウドアシスタントには、実行時に解決される組み込みの環境パラメータも用意されています。[Run on Schedule] オプション:

  5. [インスタンスの選択] および [マネージドインスタンスの選択] で、ターゲットインスタンスを選択します。

    マネージドインスタンスとは、クラウドアシスタントによって管理される ECS 以外のサーバーです。詳細については、「Alibaba Cloud マネージドインスタンス」をご参照ください。
  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
シングルクォーテーション内の値を実際の値に置き換えてください。

主なパラメーター:

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

すべてのパラメーターのリファレンスについては、「CreateCommand」をご参照ください。

応答の例:

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

次のステップ

コマンドを作成後、[マイコマンド] タブで確認できます。特定のインスタンスで実行する方法については、「コマンドの実行」をご参照ください。

[パラメーターを使用] を有効にした場合は、コマンド実行時に [コマンドパラメーター] にパラメーターの値を入力してください。