すべてのプロダクト
Search

このプロダクト

    Elastic Desktop Service:RunCommand

    ドキュメントセンター

    Elastic Desktop Service:RunCommand

    最終更新日:May 12, 2026

    Windows を実行する 1 台以上のクラウドコンピューターで、PowerShell スクリプトまたは Bat スクリプトを実行します。

    今すぐお試しください

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

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ecd:RunCommand

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    リージョン ID です。

    cn-hangzhou
    Type

    string

    必須

    スクリプトのタイプです。

    列挙値:

    • RunPowerShellScript :

      PowerShell スクリプトを実行します。

    • RunBatScript :

      Bat スクリプトを実行します。

    RunPowerShellScript
    CommandContent

    string

    必須

    プレーンテキスト形式または Base64 エンコード形式のスクリプトコンテンツ。
    Base64 エンコード形式のスクリプトコンテンツは 16 KB を超えることはできません。

    説明

    スクリプトコンテンツが Base64 エンコード形式の場合は、ContentEncoding パラメーターを Base64 に設定する必要があります。

    ipconfig
    Timeout

    integer

    任意

    スクリプトの実行タイムアウト時間 (秒単位) です。デフォルト値：300
    プロセスの競合、モジュールの欠落、Cloud Assistant クライアントが利用できないなどの問題によってスクリプトを実行できない場合、コマンドはタイムアウトします。コマンドがタイムアウトすると、システムはスクリプトプロセスを強制終了します。

    3600
    ContentEncoding

    string

    任意

    スクリプトコンテンツのエンコード方式です。

    説明

    有効な列挙値以外の値を指定した場合、システムはデフォルトで PlainText に設定されます。

    列挙値:

    • Base64 :

      Base64 エンコーディング

    • PlainText :

      コンテンツはプレーンテキストであり、エンコードされていません (デフォルト)。

    Base64
    DesktopId

    array

    必須

    スクリプトを実行するクラウドコンピューターの ID。最大 50 個の ID を指定できます。
    指定されたクラウドコンピューターの少なくとも 1 台でスクリプトが実行されれば、API 呼び出しは成功したと見なされます。すべてのクラウドコンピューターでスクリプトが失敗した場合にのみ、呼び出しは失敗します。

    string

    任意

    クラウドコンピューター ID。

    ecd-7w78ozhjcwa3u****
    EndUserId

    string

    任意

    このパラメーターを指定すると、指定されたエンドユーザーの権限でコマンドが実行されます。

    説明

    このユーザーは、クラウドコンピューターでのセッション履歴がある必要があります。つまり、クラウドコンピューターの起動後にユーザーがログインし、そのセッションが別のユーザーに引き継がれていない必要があります。このパラメーターは、Linux クラウドコンピューターではサポートされていません。

    alice
    CommandRole

    string

    任意

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスオブジェクトです。

    InvokeId

    string

    スクリプトの実行 ID です。この ID を DescribeInvocations API と併用して、スクリプトの実行ステータスを照会できます。

    t-hz01qgsqj2n****
    RequestId

    string

    リクエスト ID です。

    1CBAFFAB-B697-4049-A9B1-67E1FC5F****

    例

    成功レスポンス

    JSONJSON

    {
  "InvokeId": "t-hz01qgsqj2n****",
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****"
}

    エラーコード

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

    変更履歴

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