さくらクラウド高火力 API
API から docker/getting-started 起動
引き続き、API から docker/getting-started を起動してみます。
高火力 DOK ダッシュボードからの起動については
さくら 高火力 DOK で docker/getting-started 起動
で説明しました。
今回は、API から起動します。
さくら DOK API getting-started 起動タスク作成
さくらクラウド高火力 DOK API を使用して docker/getting-started を起動するタスクを作成します。
さくらクラウド高火力 API--API からタスク一覧取得--ubuntu printenv 実行タスク
タスクの登録
+ "containers": [・・・], のあたりの「+」をクリックしてください。
が参考になります。
概要は
curl -u "{アクセストークン}:{アクセストークンシークレット}" \
-X POST \
-H "Content-Type: application/json" \
-d
'{
"Name": "getting-started-api",
"Image": "docker/getting-started",
"plan": "v100-32gb",
"http": {
"port": 80,
"path": "/"
}'
のようになります。
もう少し説明を加えます。
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": "getting-started-api",
名前は getting-started-api としました。
適当です。
"containers" の中にはタスク詳細を記入します。
・"image": "docker/getting-started:latest",
ubuntu イメージの最新版を使います。
・"plan": "v100-32gb"
プランは "v100-32gb" にしました。
・"http":
getting-started がリッスンしているポートは 80 です。
外部からアクセスする際のベースとなる HTTP パス(文字列、通常は "/")を指定します。
まとめると下記のようになります。
$ curl -u "$SACS_TK:$SACS_S" \
-X POST "$ISI_URL_T" \
-H "Content-Type: application/json" \
-d '{
"name": "getting-started-api",
"containers": [
{
"image": "docker/getting-started:latest",
"plan": "v100-32gb",
"http": {
"port": 80,
"path": "/"
}
}
]
}'
実行してみます。
[結果]
{"id":"fd42d8a3-ce91-4be6-a22b-81b67e1ac55c",
"created_at":"2026-11-02T18:34:20.630790+09:00",
"updated_at":"2026-11-02T18:34:20.630806+09:00",
"canceled_at":null,
"name":"getting-started-api",
"http_uri":null,
"containers":[{
"index":0,
"registry":null,
"image":"docker\/getting-started:latest",
"command":[],
"entrypoint":[],
"environment":[],
"http":{"port":80,"path":"\/"},
"ssh":null,
"mountpoints":[],
"plan":"v100-32gb",
"start_at":null,
"stop_at":null,
"execution_seconds":null,
"exit_code":null}],
"status":"waiting",
上手く動作しました。
ところが結果を参照する URL が API からは分かりません。
仕方がないので、高火力 DOK ダッシュボードに入り、
「HTTP URL 詳細」をクリックして、
https://fd42d8a3-ce91-4be6-a22b-81b67e1ac55c.
0b5a260e-65ad-4895-b680-13dad888f597.
container.sakurausercontent.com
を表示させ、これをブラウザの URL 欄に入力することにより最終確認をしました。
よく見ると赤字部分は id の値です。
container.sakurausercontent.com
は固定値のようです。
赤・青字部分は DOK を起動するたびに代わります。
ただ、青字部分(トークン)は、API から知る方法もあるようです。
HTTP URL トークン調査
HTTP URL トークンを調査します。
トークンは
https://secure.sakura.ad.jp/cloud/zone/is1a/ api/managed-container/1.0/tasks/{taskId}/
から取得できるようです。
{taskId} は今回は
fd42d8a3-ce91-4be6-a22b-81b67e1ac55c
です。
下記のように GET 文を作成します。
[HTTP URL 取得/原形]
yamada@yama:~$ curl -u "$SACS_TK:$SACS_S" \
-X GET https://secure.sakura.ad.jp/cloud/zone/is1a/api/managed-container/1.0/tasks/fd42d8a3-ce91-4be6-a22b-81b67e1ac55c/ \
-H "Content-Type: application/json"
[結果]
{"id":"fd42d8a3-ce91-4be6-a22b-81b67e1ac55c",
"created_at":"2026-11-03T17:26:11.169465+09:00",
"updated_at":"2026-11-03T17:26:11.169485+09:00",
"canceled_at":null,
"name":"getting-started-api",
"http_uri":
"https:\/\/fd42d8a3-ce91-4be6-a22b-81b67e1ac55c.0b5a260e-65ad-4895-b680-13dad888f597.container.sakurausercontent.com",
"containers":[{"index":0,
"registry":null,
"image":"docker\/getting-started:latest",
"command":[],
"entrypoint":[],
"environment":[],
"http":{"port":80,"path":"\/"},
"ssh":null,
"mountpoints":[],
"plan":"v100-32gb",
"start_at":"2026-11-03T17:26:22+09:00",
"stop_at":null,
"execution_seconds":null,
"exit_code":null}],
"status":"running",
"error_message":"",
"execution_time_limit_sec":1728000,
"artifact":null,
"tags":[]}
すると "http_uri": のところに
https:\/\/
fd42d8a3-ce91-4be6-a22b-81b67e1ac55c.
0b5a260e-65ad-4895-b680-13dad888f597.
container.sakurausercontent.com
と表示されますので、
「\」の2文字を削除し、ブラウザの URL 欄に入力することにより getting-started を確認することができます。
HTTP URL 取得/簡単に
環境変数を使うともっと簡単に書くことができます。
$ curl -u "$SACS_TK:$SACS_S" \
-H "Content-Type: application/json" \
-X GET "$ISI_URL_T"/fd42d8a3-ce91-4be6-a22b-81b67e1ac55c/
| jq -r '.http_uri'
jq はコマンドライン上で JSON データを抽出できるコマンドラインです。
-r オプションを付けると引用符を外してプレーンな文字列で出力します。
これで、URL 部分のみを出力することができます。
yamada@yama:~$ curl -u "$SACS_TK:$SACS_S" \
-H "Content-Type: application/json" \
-X GET "$ISI_URL_T"/fd42d8a3-ce91-4be6-a22b-81b67e1ac55c/ | jq -r '.http_uri'
[結果]
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 721 100 721 0 0 2652 0 --:--:-- --:--:-- --:--:-- 2660
https://fd42d8a3-ce91-4be6-a22b-81b67e1ac55c.
0b5a260e-65ad-4895-b680-13dad888f597.
container.sakurausercontent.com
と表示されますので、ブラウザの URL 欄にこの赤字部分を入力すれば getting-started を確認することができます。
getting-started 中断
最後に getting-started を API から中断(キャンセル)します。
https://secure.sakura.ad.jp/cloud/zone/is1a/api/managed-container/1.0/tasks/{taskId}/cancel/
に入って行います。
具体的には環境変数を使って
"$ISI_URL_T"/fd42d8a3-ce91-4be6-a22b-81b67e1ac55c/cancel/
と書くことができます。
要するに cancel フォルダに POST すれば良いようです。
まとめると下記のようになります。
yamada@yama:~$ curl -u "$SACS_TK:$SACS_S" \
-H "Content-Type: application/json" \
-X POST "$ISI_URL_T"/fd42d8a3-ce91-4be6-a22b-81b67e1ac55c/cancel/
[結果]
{"id":"fd42d8a3-ce91-4be6-a22b-81b67e1ac55c",
"created_at":"2026-11-03T18:03:55.410020+09:00",
"updated_at":"2026-11-03T18:03:55.410039+09:00",
"canceled_at":"2026-11-03T18:05:58.865461+09:00",
"name":"getting-started-api",
"http_uri":null,"
containers":[{"index":0,
"registry":null,
"image":"docker\/getting-started:latest",
"command":[],
"entrypoint":[],
"environment":[],
"http":{"port":80,
"path":"\/"},"ssh":null,
"mountpoints":[],
"plan":"v100-32gb",
"start_at":"2026-11-03T18:04:09+09:00",
"stop_at":null,
"execution_seconds":null,
"exit_code":null}],
"status":"canceled",
"error_message":"",
"execution_time_limit_sec":1728000,
"artifact":null,"tags":[]}
タスク id 取得
ここまで見てくると手っとりばやくタスク id だけを取得したいですよね。
タスク起動の時に、後ろに
| jq -r '.id'
を追加入力すると余計な情報が削除され id だけを取得することができます。
yamada@yama:~$ curl -u "$SACS_TK:$SACS_S" \
-X POST "$ISI_URL_T" \
-H "Content-Type: application/json" \
-d '{
"name": "getting-started-api",
"containers": [
{
"image": "docker/getting-started:latest",
"plan": "v100-32gb",
"http": {
"port": 80,
"path": "/"
}
}
]
}' | jq -r '.id'
[結果]
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 827 100 585 100 242 142 58 0:00:04 0:00:04 --:--:-- 201
fd42d8a3-ce91-4be6-a22b-81b67e1ac55c
タスク id 取得Ⅱ
さらにもうひと頑張り、タスクを起動して id を $ID1 に取得します。
これができれば、HTTP URL 取得や中断が簡単にできるはずです。
yamada@yama:~$ ID1=$(curl -u "$SACS_TK:$SACS_S" \
-X POST "$ISI_URL_T" \
-H "Content-Type: application/json" \
-d '{
"name": "getting-started-api",
"containers": [
{
"image": "docker/getting-started:latest",
"plan": "v100-32gb",
"http": {
"port": 80,
"path": "/"
}
}
]
}' | jq -r '.id')
# タスクが起動され タスク ID が $ID1 に保存されました
# [結果]
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 826 100 585 100 241 2112 870 --:--:-- --:--:-- --:--:-- 2981
# [確認]
yamada@yama:~$ echo "$ID1"
fd42d8a3-ce91-4be6-a22b-81b67e1ac55c
# HTTP URL 取得
yamada@yama:~$ curl -u "$SACS_TK:$SACS_S" \
-H "Content-Type: application/json" \
-X GET "$ISI_URL_T"/$ID1/
| jq -r '.http_uri'
# 中断(キャンセル)
yamada@yama:~$ curl -u "$SACS_TK:$SACS_S" \
-H "Content-Type: application/json" \
-X POST "$ISI_URL_T"/$ID1/cancel/
かなりシンプルになりました。
以上で、API から docker/getting-started 起動についての説明は終わりです。





