さくらクラウド高火力 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":[]
}
ダッシュボードからも実行を確認します。
引き続き、API から docker/getting-started を起動してみます。





