API docs by Redocly

高火力 DOK APIドキュメント (1.0.0)

Download OpenAPI specification:Download

License: CC BY-ND-4.0 (Creative Commons Attribution No Derivatives 4.0 International)

はじめに

「高火力 DOK」が提供するAPIの利用方法を公開しています。 「高火力 DOK」自体の説明についてはマニュアルをご覧ください。

APIご利用の前に

本APIの利用には、さくらのクラウドの APIキー が必要です。 APIキーの発行についてはマニュアルをご覧ください。

APIキーの「アクセストークン」をユーザーID、「アクセストークンシークレット」をパスワードとした Basic認証 で本APIをご利用ください。

認証

認証関連のAPIです。

クラウドアカウント情報の取得

APIキーに紐づく、さくらのクラウドのアカウント情報を取得します。

Authorizations:
BasicAuth

Responses

Response samples

Content type
application/json
{
  • "user": { },
  • "member": {
    },
  • "account": {
    }
}

利用規約への同意

利用規約に同意します。 必ず内容を熟読の上、同意できる場合のみ本APIをコールしてください。

同意するまで（本APIをコールするまで）、本サービスの各種操作は行えません。

Authorizations:
BasicAuth

Responses

コンテナーレジストリー

コンテナーレジストリーの認証情報に関するAPIです。

コンテナーレジストリー認証情報の一覧を取得

「認証情報登録API」で登録した認証情報の一覧を取得します。

Authorizations:
BasicAuth

Responses

Response samples

Content type
application/json
{
  • "meta": {
    },
  • "results": [
    ]
}

コンテナーレジストリーの認証情報を登録

認証が必要なコンテナーレジストリーの、認証情報を登録します。

プライベートなレジストリーに格納したコンテナーイメージを実行する場合、事前にこのAPIで認証情報を登録してください。 公開レジストリーのイメージを実行する場合は本操作は不要です。

Authorizations:
BasicAuth
Request Body schema: application/json
required
hostname
required
string
username
required
string
password
required
string

Responses

Request samples

Content type
application/json
{
  • "hostname": "example.sakuracr.jp",
  • "username": "user01",
  • "password": "p@ssw0rd"
}

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "created_at": "2024-10-10T13:50:40.250+09:00",
  • "updated_at": "2024-10-10T13:50:40.250+09:00",
  • "hostname": "example.sakuracr.jp",
  • "username": "user01"
}

コンテナーレジストリーの認証情報を取得

指定IDのコンテナーレジストリーの認証情報を取得します。

Authorizations:
BasicAuth
path Parameters
registryId
required
string <uuid>

レジストリーID（登録APIのレスポンス内の id フィールド）

Responses

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "created_at": "2024-10-10T13:50:40.250+09:00",
  • "updated_at": "2024-10-10T13:50:40.250+09:00",
  • "hostname": "example.sakuracr.jp",
  • "username": "user01"
}

コンテナーレジストリーの認証情報を抹消

登録された認証情報を抹消します。 本APIの呼び出し後は、同じレジストリーIDは本サービスで使えなくなります。

Authorizations:
BasicAuth
path Parameters
registryId
required
string <uuid>

レジストリーID（登録APIのレスポンス内の id フィールド）

Responses

コンテナーレジストリーの認証情報を更新

登録済みの認証情報を変更します。 登録時に間違えた場合や、コンテナーレジストリーのパスワードを変更した場合などにお使いください。

Authorizations:
BasicAuth
path Parameters
registryId
required
string <uuid>

レジストリーID（登録APIのレスポンス内の id フィールド）

Request Body schema: application/json
required
hostname
required
string
username
required
string
password
required
string

Responses

Request samples

Content type
application/json
{
  • "hostname": "example.sakuracr.jp",
  • "username": "user01",
  • "password": "p@ssw0rd"
}

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "created_at": "2024-10-10T13:50:40.250+09:00",
  • "updated_at": "2024-10-10T13:50:40.250+09:00",
  • "hostname": "example.sakuracr.jp",
  • "username": "user01"
}

タスク

タスクの実行に関するAPIです。

タスクの一覧を取得

登録済みのタスクの一覧情報を取得します。

Authorizations:
BasicAuth
query Parameters
page
integer
Default: 1

ページ番号（1 origin）

page_size
integer
Default: 100

1ページのサイズ

status
string (TaskStatus)
Enum: "waiting" "running" "error" "done" "aborted" "canceled"

ステータスでの絞り込み

tag
string
Example: tag=tag1

タグでの絞り込み

Responses

Response samples

Content type
application/json
{
  • "meta": {
    },
  • "results": [
    ]
}

タスクの登録

新しいタスクを登録します。 タスク実行の詳細についてはマニュアルをご覧ください。

Authorizations:
BasicAuth
Request Body schema: application/json
required
name
required
string
required
Array of objects (ContainerDefinition)
tags
required
Array of strings

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "containers": [
    ],
  • "tags": [
    ]
}

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "created_at": "2024-10-10T13:50:40.250+09:00",
  • "updated_at": "2024-10-10T13:50:40.250+09:00",
  • "canceled_at": "2024-10-10T13:50:40.250+09:00",
  • "containers": [
    ],
  • "status": "waiting",
  • "tags": [
    ],
  • "error_message": "invalid registry permission",
  • "artifact": {
    }
}

タスクの情報取得

登録したタスクの情報を取得します。

Authorizations:
BasicAuth
path Parameters
taskId
required
string <uuid>

タスクID（登録APIのレスポンス内の id フィールド）

Responses

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "created_at": "2024-10-10T13:50:40.250+09:00",
  • "updated_at": "2024-10-10T13:50:40.250+09:00",
  • "canceled_at": "2024-10-10T13:50:40.250+09:00",
  • "containers": [
    ],
  • "status": "waiting",
  • "tags": [
    ],
  • "error_message": "invalid registry permission",
  • "artifact": {
    }
}

タスクの情報削除

タスクの情報を削除します。 本APIの呼び出し後は、同じタスクIDは本サービスで使えなくなります。

注）本APIは、実行中のタスクをキャンセルするAPIではありません。 タスクをキャンセルしたい場合は、タスクのキャンセルAPIをコールしてください。

Authorizations:
BasicAuth
path Parameters
taskId
required
string <uuid>

Responses

タスクのキャンセル

実行中のタスクをキャンセルします。

Authorizations:
BasicAuth
path Parameters
taskId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "created_at": "2024-10-10T13:50:40.250+09:00",
  • "updated_at": "2024-10-10T13:50:40.250+09:00",
  • "canceled_at": "2024-10-10T13:50:40.250+09:00",
  • "containers": [
    ],
  • "status": "waiting",
  • "tags": [
    ],
  • "error_message": "invalid registry permission",
  • "artifact": {
    }
}

タスク関連ファイルのダウンロード用URL取得

タスクに関連するファイル（出力ファイル）のダウンロードURLを取得します。

Authorizations:
BasicAuth
path Parameters
taskId
required
string <uuid>
target
required
string
Value: "output"
query Parameters
filename
string
Example: filename=output.txt

指定するとContentDispositionヘッダにファイル名として指定されます

Responses

Response samples

Content type
application/json
{}

アーティファクト

アーティファクト（タスクの生成物）の操作に関するAPIです。

本APIでアーティファクトを操作するためには、タスク内で所定のディレクトリーにアーティファクトを保存いただく必要があります。 詳しくはSAKURA_ARTIFACT_DIR に関する説明を参照ください。

アーティファクト情報の一覧取得

アーティファクト情報の一覧を取得します。

Authorizations:
BasicAuth
query Parameters
page
integer
Default: 1

ページ番号

page_size
integer
Default: 100

1ページのサイズ

task
string <uuid>

指定するとタスクIDで絞り込みます

Responses

Response samples

Content type
application/json
{
  • "meta": {
    },
  • "results": [
    ]
}

アーティファクト情報を取得

アーティファクトの情報を取得します。

Authorizations:
BasicAuth
path Parameters
artifactId
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "task": "4879b8a6-fb3e-4a0d-aef8-b0ea469ac85c",
  • "created_at": "2024-10-10T13:50:40.250+09:00",
  • "deleted_at": "2024-10-10T13:50:40.250+09:00",
  • "filename": "artifact.tar.gz",
  • "size_bytes": 0
}

アーティファクトのダウンロードURL取得

アーティファクトのダウンロードURLを取得します。

Authorizations:
BasicAuth
path Parameters
artifactId
required
string <uuid>
query Parameters
filename
string
Example: filename=artifact.tar.gz

指定するとContentDispositionヘッダにファイル名として指定されます

Responses

Response samples

Content type
application/json
{}

プラン

GPUプランに関するAPIです。

GPUプランの一覧を取得

タスク実行時にご利用可能なGPUプランの一覧を取得します。 実行時には id の値をご指定ください。

Authorizations:
BasicAuth

Responses

Response samples

Content type
application/json
{
  • "meta": {
    },
  • "results": [
    ]
}

料金

料金および、お支払いに関するAPIです。

請求情報取得

指定年月の請求情報を取得します。

Authorizations:
BasicAuth
query Parameters
year
integer
Example: year=2024

取得対象の年

month
integer
Example: month=6

取得対象の月

Responses

Response samples

Content type
application/json
{
  • "meta": {
    },
  • "results": [
    ]
}

プラン別の単価一覧取得

指定年月のプラン別単価（実行時間1秒あたりの金額）一覧を取得します。

Authorizations:
BasicAuth
query Parameters
year
integer
Example: year=2024

取得対象の年

month
integer
Example: month=6

取得対象の月

Responses

Response samples

Content type
application/json
{
  • "meta": {
    },
  • "results": [
    ]
}