API 개요

​

기본 URL 및 버전 관리

https://api.coreweave.com/v1/sandbox

​

인증

Authorization: Bearer [API-ACCESS-TOKEN]

• sandbox_admin: 러너를 생성, 조회, 업데이트, 삭제하고, 러너가 전달하는 정책을 설정합니다. 조회를 포함한 모든 관리형 러너 엔드포인트에 이 액션이 필요합니다. sandbox_user를 포함합니다. 레거시 v1beta2 프로필을 사용하는 러너에서는 이 액션으로 권한 있는 프로필 설정도 사용할 수 있습니다. 여기에는 권한 있는 컨테이너, 호스트 namespace, 호스트 파일 시스템 마운트가 포함됩니다. 이러한 설정을 사용하면 샌드박스가 클러스터 관리자에 준하는 노드 액세스 권한을 갖게 될 수 있습니다. v1 정책의 allow_privileged 설정은 샌드박스 격리 경계 안에서의 게스트 내부 권한을 제어합니다.
• sandbox_user: 샌드박스를 생성하고 운영하며, 샌드박스의 네트워크 설정도 관리할 수 있습니다. 관리형 러너 관리에 대한 액세스 권한은 부여하지 않습니다.

​

콘텐츠 유형

Content-Type: application/json

​

리소스 패밀리

​

페이지 매김

• pageSize: 페이지 크기입니다. 기본값은 50, 최대 100입니다.
• pageToken: 이전 페이지에서 nextPageToken으로 반환된 커서입니다. 빈 문자열은 더 이상 페이지가 없음을 의미합니다.

curl -H "Authorization: Bearer $TOKEN" \
  'https://api.coreweave.com/v1/sandbox/managedRunners?pageSize=50'

# 커서 따르기
curl -H "Authorization: Bearer $TOKEN" \
  'https://api.coreweave.com/v1/sandbox/managedRunners?pageSize=50&pageToken=[NEXT-PAGE-TOKEN]'

​

업데이트 시 필드 마스크

curl -X PATCH "https://api.coreweave.com/v1/sandbox/managedRunners/[RUNNER-ID]?updateMask=spec.releaseChannel,spec.maintenancePolicy" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "spec": { "releaseChannel": "RELEASE_CHANNEL_RAPID" } }'

​

러너 선호도

​

오류

{
  "code":    3,
  "message": "runner.identity.zone is required",
  "details": []
}

​

멱등성

• Delete* 엔드포인트는 멱등성을 가집니다. 이미 삭제된 리소스에 DELETE를 호출하면 부작용 없이 404를 반환합니다.
• Create* 엔드포인트는 멱등성을 가지지 않습니다. 동일한 runnerId 또는 displayName을 두 번 지정하면 409 Conflict를 반환합니다. 안전하게 재시도하려면 GET으로 리소스가 이미 존재하는지 먼저 확인하세요.
• Update* 엔드포인트는 필드 마스크를 사용하여 변경하려는 필드만 설정하면 안전하게 재시도할 수 있습니다.

​

Heartbeats

​

참고 항목

• Terraform으로 러너 관리: CoreWeave Terraform 공급자로 러너를 설정, 임포트, 업데이트하는 방법을 설명합니다.
• 샌드박스 아키텍처: 네 가지 리소스 분류 체계와 게이트웨이가 런타임 요청을 중개하는 방식을 설명합니다.
• 정책 개요: 샌드박스가 정책에 따라 어떻게 결정되는지 설명합니다.
• 샌드박스 정책 설정: CoreWeave Intelligent CLI 워크플로와 프로필 사양의 필드별 워크스루를 제공합니다.
• 러너 배포 및 관리: 러너 라이프사이클에 대한 CoreWeave Intelligent CLI 및 REST 워크스루를 제공합니다.
• 정책 레퍼런스: 프로필에 설정할 수 있는 모든 필드를 설명합니다.
• Protobuf: 게시된 Protobuf 모듈의 위치, 각 서비스를 제공하는 호스트, 생성된 SDK의 설치 방법을 설명합니다.