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

Elastic Compute Service:既存の Cloud Assistant コマンドを実行する

最終更新日:Jul 05, 2025

Cloud Assistant コマンドを作成した後、1 つ以上の Elastic Compute Service (ECS) インスタンスでコマンドを実行できます。複数インスタンスでのコマンドの実行状況と結果は、互いに影響しません。

前提条件

ECS インスタンスで Cloud Assistant コマンドを実行する前に、インスタンスが以下の要件を満たしていることを確認してください。

  • インスタンスが [実行中] 状態である。

  • Cloud Assistant Agent がインスタンスにインストールされている。詳細については、「Cloud Assistant Agent をインストールする」をご参照ください。

    スケジュールされたタスクが期待どおりに実行されるようにするには、Cloud Assistant Agent のバージョンが以下のバージョン以降であることを確認してください。スケジュールされたタスクは、特定の間隔でコマンドを実行したり、特定の時間に 1 回だけコマンドを実行したり、特定の年またはタイムゾーンを持つ cron 式で指定されたスケジュールに基づいてコマンドを実行したりできます。

    • Linux: 2.2.3.282

    • Windows: 2.1.3.282

    ClientNeedUpgrade エラーコードが返された場合は、Cloud Assistant Agent を最新バージョンに更新してください。詳細については、「Cloud Assistant Agent のアップグレードまたはアップグレードの無効化」をご参照ください。

背景情報

  • API 操作を呼び出して、1 回のリクエストで最大 100 個のインスタンスでコマンドを実行できます。「コマンド実行でサポートされるインスタンスの最大数」というクォータは、コマンドが 1 回の実行で実行できるインスタンスの最大数を指定します。クォータの増加を申請できます。リソースクォータの表示方法と増加方法については、「ECS クォータを管理する」をご参照ください。

  • ECS コンソールでコマンドを実行するために 100 個を超えるインスタンスを選択すると、システムはバッチでインスタンス上でコマンドを実行します。

手順

ECS コンソールでコマンドを実行する

  1. ECS コンソール - ECS Cloud Assistant に移動します。

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

  3. [マイコマンド] タブをクリックし、実行する Cloud Assistant コマンドを見つけ、[アクション] 列の [実行] をクリックします。

  4. [コマンドの実行] パネルで、コマンドのパラメーターを指定します。

    1. [コマンド情報] セクションで、コマンドの内容を確認し、パラメーターを設定します。次の表にパラメーターを示します。

      パラメーター

      説明

      [コマンドコンテンツ]

      [コマンドコンテンツの表示] をクリックして、コマンドコンテンツを表示します。

      [実行プラン]

      コマンドを実行するタイミングのプランを選択します。

      • [即時実行]: コマンドはすぐに実行されます。

      • [システムの次回起動後]: コマンドは、関連付けられているインスタンスが次回起動されたときに実行されます。

      • [システム起動ごと]: コマンドは、関連付けられているインスタンスが起動されるたびに実行されます。

      • [ドライランのみ実行]: システムはドライランのみを実行し、実際のコマンドは実行しません。システムは、リクエストパラメーター、インスタンスの実行環境、Cloud Assistant Agent のステータスを確認します。

      • [スケジュールに従って実行]: コマンドは、特定の間隔、特定の時間、またはスケジュールに従って実行されます。次の実行スケジュールオプションが利用可能です。

        • [一定間隔で実行]: レート式を使用して、コマンドを実行する間隔を指定します。間隔は秒、分、時間、または日で指定できます。このオプションは、コマンド実行タスクを一定の間隔で実行する場合に適しています。

          説明

          間隔を指定する場合は、次の制限事項に注意してください。

          • 指定できる間隔は 60 秒から 7 日までで、スケジュールされたタスクのタイムアウト期間よりも長くする必要があります。

          • 間隔は、2 回の連続した実行の間に経過する時間です。間隔は、コマンドを 1 回実行するために必要な時間とは無関係です。たとえば、間隔を 5 分に設定し、コマンドの実行に 2 分かかるとします。コマンドが実行されるたびに、システムはコマンドを再実行する前に 3 分間待機します。

          • タスクを作成した後、タスクはすぐに実行されません。たとえば、間隔を 5 分に設定し、コマンドを実行するタスクを作成します。タスクは作成されてから 5 分後に実行されます。

        • [指定した時間に 1 回だけ実行]: 時刻とタイムゾーンを指定して、コマンドを 1 回だけ実行します。

          たとえば、[実行時間] パラメーターを [2022 年 5 月 17 日 17:30:50] に、[タイムゾーン] パラメーターを [(GMT+08:00) Asia/Shanghai] に設定した場合、コマンドは 2022 年 5 月 17 日 17:30:50 (UTC+8) に 1 回だけ実行されました。

        • [クロックベースのスケジュール Cron 式で実行]: cron 式を使用して、コマンドを実行するスケジュールを指定します。秒、分、時間、日、月、曜日、または年に正確なスケジュールを指定し、[タイムゾーン] ドロップダウンリストからタイムゾーンを選択します。システムは cron 式とタイムゾーンに基づいてスケジュールを計算し、スケジュールどおりにコマンドを実行します。このオプションは柔軟性を提供し、スケジュールに従ってコマンドタスクを実行する場合に適しています。 cron 式の詳細については、「Cron 式」をご参照ください。

          説明

          最小間隔は 10 秒以上で、スケジュールされた実行のタイムアウト期間よりも短くすることはできません。

          たとえば、[実行頻度] パラメーターを [0 0 12 ? * WED 2022] に、[タイムゾーン] パラメーターを [(GMT+08:00) Asia/Shanghai] に設定した場合、システムは 2022 年の毎週水曜日 12:00:00 (UTC+8) にコマンドを実行します。

      [ユーザー名]

      ECS インスタンスでコマンドを実行するために使用するユーザー名を指定します。

      セキュリティ上の理由から、最小権限の原則に基づいて、一般ユーザーとして Cloud Assistant コマンドを実行することをお勧めします。詳細については、「一般ユーザーとして Cloud Assistant コマンドを実行する」をご参照ください。

      デフォルトでは、Cloud Assistant コマンドは、Linux インスタンスでは root ユーザー、Windows インスタンスではシステムユーザーによって実行されます。

      [タイムアウト]

      インスタンスでコマンドを実行するタスクの [タイムアウト期間] を指定します。コマンドタスクがタイムアウトすると、Cloud Assistant はタスクプロセスを強制終了します。

      単位: 秒。デフォルトでは、このパラメーターは、コマンドに指定した [タイムアウト] の値に設定されます。

      説明

      このタイムアウト期間は、コマンドタスクにのみ適用されます。コマンドタスクのタイムアウト期間を変更しても、コマンドのタイムアウト期間は影響を受けません。

      [タグ]

      [タグキー][タグ値] を指定して、コマンドタスクにタグを追加します。

    2. [インスタンスの選択] セクションと [マネージドインスタンスの選択] セクションで、1 つ以上のインスタンスを選択します。

      複数のインスタンスがある場合は、インスタンス ID、名前、またはタグでコマンドを実行するインスタンスを検索し、Cloud Assistant Agent のステータスで結果をフィルタリングできます。

      説明

      マネージドインスタンスとは、Alibaba Cloud によって提供されていないが、Cloud Assistant によって管理されているインスタンスです。詳細については、「Alibaba Cloud マネージドインスタンス」をご参照ください。

  5. [実行] をクリックします。

Alibaba Cloud CLI を使用してコマンドを実行する

Alibaba Cloud CLI を使用してコマンドを実行する場合は、コンピューターに Alibaba Cloud CLI がインストールされていることを確認してください。 Alibaba Cloud CLI のインストール方法は、オペレーティングシステムによって異なります。さまざまなオペレーティングシステムに Alibaba Cloud CLI をインストールする方法については、以下のトピックを参照してください。

  1. (オプション) インスタンスのステータスを確認します。インスタンスが [実行中] (Running) 状態でない場合は、StartInstance 操作を呼び出してインスタンスを起動します。

    aliyun ecs StartInstance --InstanceId 'i-bp1f4f6o8lv0wqof****' 
    説明

    この例では、単一引用符 ('') で囲まれた値はパラメーターの値の例です。実際の条件に基づいて値を変更する必要があります。

    パラメーターの詳細については、「StartInstance」をご参照ください。

  2. (オプション) DescribeCloudAssistantStatus 操作を呼び出して、インスタンスに Cloud Assistant Agent がインストールされているかどうかを確認します。

    aliyun ecs DescribeCloudAssistantStatus --RegionId 'cn-hangzhou' \
    --InstanceId.1 'i-bp1f4f6o8lv0wqof****' 

    インスタンスに Cloud Assistant Agent がインストールされている場合、レスポンスの CloudAssistantStatus の値は true です。それ以外の場合は、InstallCloudAssistant 操作を呼び出して、インスタンスに Cloud Assistant Agent をインストールします。詳細については、「DescribeCloudAssistantStatus」および「InstallCloudAssistant」をご参照ください。

  3. InvokeCommand 操作を呼び出して、作成済みの Cloud Assistant コマンドを 1 つ以上のインスタンスで実行します。

    aliyun ecs InvokeCommand --RegionId 'cn-hangzhou' \
    --InstanceId.1 'i-bp1f4f6o8lv0wqof****' \
    --InstanceId.2 'i-bp137qu6142s3mhm****' \
    --CommandId 'c-hz018qp243j****'

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

    パラメーター

    説明

    RegionId

    cn-hangzhou

    リージョン ID。

    InstanceId.1

    i-bp1f4f6o8lv0wqof****

    コマンドを実行する最初のインスタンスの ID。

    InstanceId.2

    i-bp137qu6142s3mhm****

    コマンドを実行する 2 番目のインスタンスの ID。

    CommandId

    c-hz018qp243j****

    コマンド ID。