인스턴스 개요
한 번에 하나의 Mac VM을 직접 띄우고, 정지하고, 지우는 API. 잡이 아니라 환경 자체를 다룹니다.
아직 호출할 수 없습니다. 아래 계약은 공개 Go SDK와 통합 패키지가 이미 쓰는 계약이라 확정되어 있지만, 서버 구현은 만드는 중입니다. 호출할 수 있게 되면 변경 기록에 공지합니다.
인스턴스는 요청에 따라 만들어지는 macOS 가상 머신 하나입니다. 잡 실행과 같은 하드웨어·같은 이미지를 쓰지만 수명은 직접 관리합니다. stop은 디스크에 저장(save)하고 start는 복원(restore)하며, 정지 상태에서는 컴퓨트 과금이 없습니다.
상태
| 상태 | 의미 |
|---|---|
| queued | 요청을 받았고 배치를 기다립니다. |
| creating | VM을 만드는 중입니다. |
| running | SSH로 접속할 수 있습니다. |
| stopped | 저장본만 남아 있습니다. 컴퓨트 과금 없음. |
| deleting / deleted | 삭제 중이거나 삭제되었습니다. |
| failed | 실패했습니다. status_reason에 이유가 있습니다. |
컬렉션 응답은 {"total":N,"instances":[…]}에 page·page_size가 붙고, 오류는 {"message":"…"} 한 가지 모양입니다. 인스턴스 필드는 id, name, image, region, type, status, status_reason, created_at, updated_at입니다.
CI 잡이 만든 인스턴스
GitHub Actions 잡이 쓰는 러너 VM도 같은 목록에 읽기 전용으로 보입니다. start·stop은 409, DELETE는 403이며, 멈추려면 잡을 취소하세요.