さくらクラウド高火力 API

API からタスク一覧取得

引き続き、タスク一覧を取得します。
高火力 DOK APIドキュメント (1.0.0)--タスクの登録
が参考になります。
取得ですので
-X GET
取得 URL は $ISI_URL_T
https://secure.sakura.ad.jp/cloud/zone/is1a/api/managed-container/1.0/tasks/
HTTP ヘッダーは JSON なので
-H "Content-Type: application/json"
とします。
まとめると

curl -u "$SACS_TK:$SACS_S" \
  -H "Content-Type: application/json" \
  -X GET "$ISI_URL_T"

実行してみます。

 
yamada@yama:~$ curl -u "$SACS_TK:$SACS_S" \
  -H "Content-Type: application/json" \
  -X GET "$ISI_URL_T"
{"meta":{
"page":1,"page_size":100,"total_pages":1,"count":7,"next":null,"previous":null},
"results":[{
"id":"c07c****-****-****-****-****aae8efc2",
"created_at":"2026-10-29T17:56:02.879018+09:00",
"updated_at":"2026-10-29T17:56:28.804245+09:00",
"canceled_at":null,
"name":"example-task",
"http_uri":null,
"containers":[{
"index":0,
"registry":null,
"image":"ubuntu:latest",
"command":["printenv"],
"entrypoint":[],
"environment":{"EXAMPLE_ENV":"example"},
"http":null,"ssh":null,"mountpoints":[],
"plan":"v100-32gb",
"start_at":"2026-10-29T17:56:14+09:00",
"stop_at":"2026-10-29T17:56:14+09:00",
"execution_seconds":1,
"exit_code":0}],
"status":"done",
"error_message":"",
"execution_time_limit_sec":1728000,
"artifact":null,
"tags":[]},
{"id":"e278****-****-****-****-****23780761",
"created_at":"2026-10-20T15:15:26.440737+09:00",
"updated_at":"2026-10-20T15:17:44.209012+09:00",
"canceled_at":"2026-10-20T15:17:36.803908+09:00",
"name":"d-tuto",
後略・・・・

なにやら沢山タスク情報が表示されたら OK です。

ubuntu printenv 実行タスク

ubuntu を起動し printenv を実行するタスクを API を使って作成します。
高火力DOKでAPIを使ってタスクを実行する
が参考になります。

curl -u

SAKURA_ACCESS_TOKEN と $SAKURA_ACCESS_TOKEN_SECRET
を設定します。
これはすでに、環境変数として
$SACS_TK と $SACS_S
に設定済です。
curl -u "$SACS_TK:$SACS_S"

curl -X

タスクを設定するのですから POST を使います。
URL は
https://secure.sakura.ad.jp/ cloud/zone/is1a/api/managed-container/1.0/tasks/
です。
これはすでに、
環境変数 "$ISI_URL_T"
として設定済です。
-X POST "$ISI_URL_T"

curl -H

HTTP ヘッダーを追加します。
レスポンスは JSON なので基本的には
-H "Content-Type: application/json"
とします。

curl -d

POST リクエストで送信するデータ内容です。
・"name": "example-task",
名前は example-task としました。
適当です。
"containers" の中にはタスク詳細を記入します。
・"image": "ubuntu:latest",
ubuntu イメージの最新版を使います。
・"command": ["printenv"],
起動したら実行するコマンドを指定します。
・"environment": {"EXAMPLE_ENV": "example"}
環境変数 "EXAMPLE_ENV" を "example"
としてみました。
・"plan": "v100-32gb"
プランは "v100-32gb" にしました。
まとめると下記のようになります。


curl -u "$SACS_TK:$SACS_S" \
  -X POST "$ISI_URL_T" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "example-task",
    "containers": [
      {
        "image": "ubuntu:latest",
        "command": ["printenv"],
        "environment": {
          "EXAMPLE_ENV": "example"
        },
        "plan": "v100-32gb"
      }
    ]
  }'

実行すると、printenv コマンドを実行した結果が下記のように表示されて処理が完了します。

{
  "id":"****5ed4-****-4b64-****-****aae8****",
  "created_at":"2026-10-29T17:56:02.879018+09:00",
  "updated_at":"2026-10-29T17:56:02.879043+09:00",
  "canceled_at":null,
  "name":"example-task",
  "http_uri":null,
  "containers":[
    {
      "index":0,
      "registry":null,
      "image":"ubuntu:latest",
      "command":[
      "printenv"],
      "entrypoint":[],
      "environment":{
        "EXAMPLE_ENV":"example"
      },
      "http":null,
      "ssh":null,
      "mountpoints":[],
      "plan":"v100-32gb",
      "start_at":null,
      "stop_at":null,
      "execution_seconds":null,
      "exit_code":null
    }
  ],
  "status":"waiting",
  "error_message":"",
  "execution_time_limit_sec":1728000,
  "artifact":null,
  "tags":[]
}

ダッシュボードからも実行を確認します。


  • ubuntu printenv 実行タスク確認

  • 引き続き、API から docker/getting-started を起動してみます。


  • API から docker/getting-started 起動 に進む
  • コンテナレジストリにイメージをビルド に戻る
  • さくら DOK Dockerfile nginx イメージで index.html 表示実行 に戻る
  • コンテナレジストリにイメージをビルド に戻る
  • Dockerfile nginx イメージで index.html 表示 に戻る
  • コンテナレジストリータスク作成まとめ に戻る
  • コンテナレジストリにイメージを保存 に戻る
  • さくらのクラウド 高火力 DOK コンテナレジストリ概要 に戻る
  • 70VPS に戻る


    Hiroo 散歩通り あだん
    あだん google 情報
    Hiroo Station
    イザカヤあだん
    Hiroo 散歩通り あだん
    あだん google 情報