ovahub操作承認チャレンジを作成
/api/v1/servers/:id/challenge
AI によるサービス終了や再インストールに必要な、1 回限りのウォレット承認を準備します。チャレンジの作成では操作は実行されません。
呼び出す前に
組織、サーバー、影響、対象 OS、有効期限を確認してから、返されたメッセージをそのままローカルで署名してください。人間のユーザーのトークンにはウォレット承認は不要です。
API のフィールド名、型、コードはすべての言語で共通です。
リクエスト例
curl "https://tovahub.com/api/v1/servers/507f1f77bcf86cd799439012/challenge" -X POST \
-H "Authorization: Bearer $TOVAHUB_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"action": "reinstall",
"requestKey": "docs_example_001",
"os": "debian12"
}'表示のみ。このページから API リクエストは送信されません。
パラメーター
idパス · 必須string
リソース ID。24 桁の16進数文字列です。対応する一覧エンドポイントが返すプラットフォーム ID を使用し、プロバイダーのインスタンス ID は使用しないでください。
actionJSON ボディ · 必須"terminate" | "reinstall"
承認する操作を正確に指定します。
requestKeyJSON ボディ · 必須string
8–100 文字。使用できるのは A–Z、a–z、0–9、アンダースコア、ハイフンです。同じ操作を再試行するときは、同じキーと完全に同じ入力を使用してください。
osJSON ボディ · 任意string
OS 識別子。標準の選択肢には debian12 と ubuntu24 があります。利用可否とライセンスは選択したプランに対して検証されます。サーバー操作とそのチャレンジでは、reinstall のみが os を受け付けます。
レスポンス
HTTP ステータス 200
terminate または reinstall の追加の AI ウォレットチャレンジを作成します。有効期間は 5 分で、操作は実行されません。
challengeIdstring (ObjectId)承認チャレンジの識別子。
messagestringローカルで署名する、変更してはいけない承認文の全文。
expiresAtstring (ISO 8601)承認の有効期限タイムスタンプ。
parametersobjectterminate では空。reinstall では {os:string,imageId:string|null}。
impactstring操作の影響についてサーバーが提供する説明。