buf.build/coreweave/sandbox에서 확인할 수 있습니다. CoreWeave 공식 클라이언트가 없는 언어로 통합하거나, Python 클라이언트 또는 TypeScript 클라이언트(@coreweave/cwsandbox)에서 제공하지 않는 RPC가 필요할 때 이 정의를 사용하세요.
모듈 페이지는 API 자체에 대한 레퍼런스로, 모든 서비스와 필드, JSON 인코딩 규칙, 오류 규약을 설명합니다. 새로 통합할 때는 coreweave.sandbox.v1을 사용하세요. 이전 버전인 coreweave.sandbox.v1beta2 패키지는 기존 클라이언트를 위해 계속 제공되며, 프로필 템플릿과 러너 등록 기능도 포함되어 있습니다.
엔드포인트
모든 RPC는 Connect 프로토콜로 제공되며, 동일한 엔드포인트에서 gRPC 및 gRPC-Web 클라이언트 요청도 처리합니다.v1 서비스는 두 호스트에 나뉘어 제공되며, 직접 연결을 위한 샌드박스별 엔드포인트가 별도로 있습니다.
NetworkService는 아직 사용할 수 없으며, 모든 RPC가 UNIMPLEMENTED를 반환합니다. 또한 모든 RPC가 모든 조직이나 배치 모드에서 활성화되어 있지는 않습니다. 사용할 수 없는 호출은 사유 CWSANDBOX_NOT_IMPLEMENTED와 함께 UNIMPLEMENTED를 반환합니다.
요청은 CoreWeave API 액세스 토큰으로 인증합니다. 토큰을 생성하고 SANDBOX_USER 또는 SANDBOX_ADMIN IAM 액션을 부여하는 방법은 인증을 참조하세요.
생성된 SDK 설치
Buf Schema Registry는 요청 시 해당 모듈의 SDK를 빌드합니다. 다음 명령어를 사용하면 자주 쓰이는 언어 및 플러그인 조합을 설치할 수 있습니다.Install a generated SDK
buf generate에 모듈을 지정하세요: buf generate buf.build/coreweave/sandbox.
참조
- 샌드박스 아키텍처: 게이트웨이가 런타임 요청을 중개하는 방식과 컨트롤 플레인 및 데이터 영역의 분리 구조를 설명합니다.
- API 개요: 컨트롤 플레인의 인증, 페이지 매김, 필드 마스크, 오류 처리를 설명합니다.
- 샌드박스 Python 클라이언트: 이 API를 기반으로 구축된 상위 수준 클라이언트인
cwsandbox를 소개합니다. - 샌드박스 직접 연결: 클라이언트가 상호 TLS(mTLS)를 통해
SandboxDataPlaneService에 연결하는 방법을 설명합니다.