すべてのプロダクト
Search

このプロダクト

    Elastic High Performance Computing:CreateJob

    ドキュメントセンター

    Elastic High Performance Computing:CreateJob

    最終更新日:Feb 25, 2026

    クラスターのジョブを作成します。

    操作説明

    この操作を呼び出す前に、Elastic High Performance Computing (E-HPC) の課金と料金についてご理解いただく必要があります。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ehpc:CreateJob

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ClusterId

    string

    必須

    クラスター ID。

    「ListClusters」操作を呼び出して、クラスター ID を照会できます。

    ehpc-hz-FYUr32****
    JobName

    string

    任意

    ジョブ名。

    TestJob
    JobSpec

    object

    任意

    ジョブの構成。

    CommandLine

    string

    必須

    ジョブの実行に使用するコマンドまたはスクリプト。 コマンドを使用する場合は、コマンドの完全なパス (例： `/bin/ping`) を指定する必要があります。

    スクリプトを使用する場合は、そのスクリプトに対する実行権限が必要です。 デフォルトでは、クラスター側でユーザーのルートディレクトリ (`~/`) がデフォルトのスクリプトパスとして使用されます。 スクリプトがこのディレクトリにない場合は、本パラメーターで完全なパス (例： `/home/testuser/job.sh`) を指定する必要があります。 このモードでは、CPU やメモリなどのリソース要件がスクリプト内で指定されている場合、ジョブはそのスクリプトで指定されたリソース要件に基づいて実行される点にご注意ください。 この場合、`Resource` パラメーターでリソース要件を指定しないでください。指定すると、ジョブの実行に失敗する可能性があります。

    CLI を使用してジョブを直接実行する場合は、コマンドの絶対パスを指定し、パスの前に 2 つのハイフンとスペース (`-- `) を追加する必要があります (例： `-- /bin/ping -c 10 localhost`)。

    /home/xxx/test.job
    RunasUser

    string

    任意

    ジョブをサブミットするクラスター側のユーザー。

    testuser
    RunasUserPassword

    string

    任意

    `RunasUser` パラメーターで指定されたユーザーのパスワード。

    xxx
    Priority

    string

    任意

    ジョブの優先度。

    1
    StdoutPath

    string

    任意

    ジョブの標準出力ファイルのパス。 完全なパスを指定する必要があります。

    /home/xxx/job.out
    StderrPath

    string

    任意

    ジョブの標準エラー出力ファイルのパス。 完全なパスを指定する必要があります。

    /home/xxx/job.err
    JobQueue

    string

    任意

    ジョブが属するキュー。

    comp
    ArrayRequest

    string

    任意

    キュー内のジョブ。

    フォーマット： X-Y:Z。 X は最小インデックス値、Y は最大インデックス値、Z はステップサイズです。 たとえば、2-7:2 は、3 つのジョブを実行する必要があり、それらのインデックス値が 2、4、6 であることを示します。

    1-5:2
    Variables

    string

    任意

    ジョブの環境変数。 値は JSON 配列形式の文字列です。 各配列メンバーは、`Name` と `Value` の 2 つのメンバーを含む JSON オブジェクトです。 `Name` は環境変数の名前を示し、`Value` は環境変数の値を示します。

    [{"Name":"x", "Value":"y"}]
    PostCmdLine

    string

    任意

    ジョブの後処理コマンド。

    /bin/sleep 10
    WallTime

    string

    任意

    ジョブの最大実行時間。 フォーマット： 時間:分:秒。 たとえば、01:00:00 は 1 時間を示します。

    360:48:50
    Resources

    object

    任意

    ジョブのリソース構成。

    Nodes

    integer

    任意

    ジョブに割り当てる計算ノード数。

    2
    Cores

    integer

    任意

    各計算ノードに割り当てる vCPU 数。

    2
    Memory

    string

    任意

    各計算ノードに割り当てるメモリサイズ。 メモリサイズは文字列形式です。 単位： MB または GB。

    4gb
    Gpus

    integer

    任意

    各計算ノードに割り当てる GPU 数。

    1

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスパラメーター。

    RequestId

    string

    リクエスト ID。

    A0A38A38-1565-555E-B597-E48A2E******
    JobId

    string

    ジョブ ID。

    Submitted batch job 10\n
    Success

    string

    リクエストが成功したかどうかを示します。

    true

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "A0A38A38-1565-555E-B597-E48A2E******",
  "JobId": "Submitted batch job 10\\n",
  "Success": "true"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParams The specified parameter %s is invalid.
    403 InvalidClusterStatus The operation failed due to invalid cluster status.
    404 ClusterNotFound The specified cluster does not exist.
    503 ServiceUnavailable The request has failed due to a temporary failure of the server
    406 EcsError An error occurred while calling the ECS API operation.
    406 AgentError The agent service request failed: %s
    406 AgentError.Job.SubmitFailure Failed to submit jobs: %s
    406 AgentError.Job.DeleteFailure Failed to delete job: %s
    406 AgentError.Job.InvalidContainerType Unsupported container type: %s.
    406 AgentError.Job.ListFailure Failed to list jobs: %s.
    406 AgentError.Job.RerunFailure Failed to run the job again: %s.
    406 AgentError.Job.StopFailure Failed to stop jobs: %s.

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

    変更履歴

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