すべてのプロダクト
Search

このプロダクト

    Elastic High Performance Computing:CreateJob

    ドキュメントセンター

    Elastic High Performance Computing:CreateJob

    最終更新日:Sep 07, 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

    *すべてのリソース。

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ClusterId

    string

    必須

    クラスターの ID。

    ListClusters を呼び出してクラスターの ID を照会できます。

    ehpc-hz-FYUr32****
    JobName

    string

    任意

    ジョブ名。

    TestJob
    JobSpec

    object

    任意

    ジョブの構成情報。

    CommandLine

    string

    必須

    ジョブを実行するためのコマンドまたはスクリプト。コマンドを指定する場合は、/bin/ping のように完全なパスを指定します。

    スクリプトを使用してジョブを実行する場合、スクリプトには実行権限が必要です。クラスターは、ユーザーのホームディレクトリ (~/) をデフォルトのスクリプトパスとして使用します。スクリプトがこのディレクトリにない場合は、/home/xxx/job.sh のように、このパラメーターに完全なパスを指定します。この場合、スクリプトで CPU やメモリなどのリソース要件が指定されていると、ジョブはスクリプトで指定されたリソースを使用します。Resources パラメーターでリソース要件を指定しないでください。指定すると、ジョブが失敗する可能性があります。

    コマンドラインコマンドを使用してジョブを直接実行する場合は、-- /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 は、ジョブキューに 2、4、6 の番号が付けられた 3 つのサブジョブが含まれることを示します。

    1-5:2
    Variables

    string

    任意

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

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

    string

    任意

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

    /bin/sleep 10
    WallTime

    string

    任意

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

    360:48:50
    Resources

    object

    任意

    ジョブに必須のリソース構成。

    Nodes

    integer

    任意

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

    2
    Cores

    integer

    任意

    ジョブの計算ノードごとに割り当てる CPU コアの数。

    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. 指定されたパラメーター %s が無効です。
    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. ECS API 呼び出しが失敗しました。
    406 AgentError The agent service request failed: %s 操作が成功しませんでした: %s。
    406 AgentError.Job.SubmitFailure Failed to submit jobs: %s ジョブの送信に失敗しました: {%s}
    406 AgentError.Job.DeleteFailure Failed to delete job: %s ジョブの削除に失敗しました: {}
    406 AgentError.Job.InvalidContainerType Unsupported container type: %s. 無効なコンテナタイプです: %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. ジョブの停止に失敗しました: {}

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

    変更履歴

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