클라우드에 만들 수 있는 kind

GET

/api/v1/stations/{station_id}/device-kinds

const url = 'https://dev.api.endueos.com/api/v1/stations/stn_01J9ZK3Q8M4XW7D2N5R6T0V1BC/device-kinds';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://dev.api.endueos.com/api/v1/stations/stn_01J9ZK3Q8M4XW7D2N5R6T0V1BC/device-kinds \
  --header 'Authorization: Bearer <token>'

이 Station 에서 virtual 로 띄울 수 있는 kind — VirtualDeviceKind 전부를 한 번씩, 만들 수 있는지와 그 이유를 함께. 공급자의 capabilities 를 짧게 캐시해 답한다 — 머신을 만들거나 깨우지 않는다. API 키로도 읽는다.

가이드 — 기기

인증

파라미터

경로 파라미터

station_id

필수

string

/^stn_[0-9A-HJKMNP-TV-Z]{26}$/

예시

stn_01J9ZK3Q8M4XW7D2N5R6T0V1BC

응답

200

성공.

application/json

object

data

필수

object

kinds

필수

VirtualDeviceKind 전부, 한 번씩.

Array<object>

이 Station 에서 virtual 로 띄울 수 있는 kind 하나 — 기기 추가 화면이 “클라우드에 만들기” 를 보일지 정한다.

object

kind

필수

Virtual 로 띄울 수 있는 종류 — 리소스 종류 전부다 (D-58: 모든 kind 가 “직접 설치” 와 “관리형 VM” 두 길로 생긴다). 기본 공급자: linux·chrome = fly(Fly Machines), android = vultr, mac·windows = aws(mac 은 EC2 Mac). 실제로 띄울 수 있는지는 환경의 컴퓨트 공급자가 정한다 — GET /stations/{station_id}/device-kinds.

string

허용 값: linux chrome android mac windows

available

필수

지금 만들 수 있다 — OS 설정이 허용하고, 그 kind 를 맡은 공급자가 띄울 수 있다고 알렸다.

boolean

reason

필수

Any of:

string
null

string

허용 값: kind_not_allowed no_provider provider_unavailable

provider

필수

Any of:

string
null

string

regions

필수

공급자가 알린 지역.

Array<string>

meta

필수

object

request_id

필수

string

timestamp

필수

string format: date-time

duration

서버 처리 시간(ms).

integer format: int32

예시

{
  "data": {
    "kinds": [
      {
        "kind": "linux",
        "reason": "kind_not_allowed"
      }
    ]
  }
}

401

인증이 없거나 무효다 — UNAUTHORIZED. 본문은 오류 봉투.

404

없거나 내 것이 아니다 — *_NOT_FOUND. 본문은 오류 봉투.

429

한도를 넘었다 — Retry-After 초 뒤에 다시. 본문은 오류 봉투.

500

서버 오류 — INTERNAL_ERROR. 본문은 오류 봉투.

503

의존 서비스에 닿지 못했다 — 잠시 뒤 다시. 본문은 오류 봉투.