문서 본문으로 이동
문서API 참조작업 승인 챌린지 생성
POSTBearer 토큰

작업 승인 챌린지 생성

/api/v1/servers/:id/challenge

AI의 서비스 종료 또는 재설치에 필요한 일회용 지갑 승인을 준비합니다. 서명 요청을 만들어도 작업은 실행되지 않습니다.

호출 전 확인

조직, 서버, 영향, 대상 OS와 만료 시간을 확인한 뒤 반환된 메시지를 그대로 로컬에서 서명하세요. 사람 사용자 토큰에는 지갑 승인이 필요하지 않습니다.

API 필드명, 자료형, 코드는 모든 언어에서 그대로 유지됩니다.

요청 예시

cURL
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

운영체제 식별자입니다. 기본 선택지에는 debian12와 ubuntu24가 있습니다. 선택한 요금제에 대해 가용성과 라이선스를 확인합니다. 서버 작업과 작업 챌린지에서는 reinstall만 os를 허용합니다.

응답

HTTP 상태 200

terminate 또는 reinstall용 AI 지갑 챌린지를 추가로 생성합니다. 5분간 유효하며 작업을 실행하지는 않습니다.

challengeIdstring (ObjectId)

동의 챌린지 식별자입니다.

messagestring

로컬에서 서명해야 하는 정확한 동의문 전체입니다.

expiresAtstring (ISO 8601)

동의 만료 타임스탬프입니다.

parametersobject

terminate의 경우 비어 있으며, reinstall의 경우 {os:string,imageId:string|null}입니다.

impactstring

서버가 제공하는 작업의 영향 설명입니다.