さくらクラウド高火力 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 起動についての説明は終わりです。


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


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