엔드포인트

class Endpoint(*, kind: EndpointKind | str, auth: EndpointAuth | str | None = None, request_timeout_seconds: int | None = None)

PUBLIC 서비스의 제품 엔드포인트입니다. 생성 시 설정됩니다. HTTPS + OPEN: CoreWeave가 TLS를 종료합니다. Sandbox.service_urls에 URL이 있다는 것은 호스트 이름이 부여되었다는 뜻이며, 앱이 이미 수신 대기 중이라는 뜻은 아닙니다. auth는 필수입니다. TLS_PASSTHROUGH: 플랫폼이 SNI를 기반으로 TLS를 컨테이너에 전달합니다. auth와 request_timeout_seconds는 설정하지 않아야 합니다. 부여된 대상은 Sandbox.service_addresses의 host:port입니다. 호스트를 TLS SNI로 사용하세요. 워크로드가 인증서를 관리합니다. request_timeout_seconds는 이 제품 엔드포인트에서 서버 측 HTTPS 요청의 제한 시간입니다(샌드박스가 계속 실행되는 동안 504 반환). 이는 클라이언트 RPC 기한인 Sandbox.run(request_timeout_seconds=...)와는 다릅니다. 이 클라이언트는 int(또는 None)만 요구합니다. 속성

auth (EndpointAuth | str | None) : 종류가 HTTPS이면 OPEN입니다. TLS 패스스루에서는 생략해야 합니다.
request_timeout_seconds (int | None) : 플랫폼이 진행 중인 HTTPS 요청을 종료하기까지의 시간(초)입니다. None 또는 0을 지정하면 플랫폼 기본값(서버리스에서는 15초)이 선택됩니다. 서버는 0 또는 [15, 900]을 허용합니다. 템플릿에서 생성할 때 0은 명시된 경우 기존 값을 대체하며, 템플릿의 timeout을 지워 플랫폼 기본값으로 되돌리지 않습니다. TLS 패스스루에서는 설정하지 않아야 합니다.

EndpointAuth

소스: src/cwsandbox/_types.py:213

class EndpointAuth

OPEN = 'open'

EndpointKind

소스: src/cwsandbox/_types.py:206

class EndpointKind

HTTPS = 'https'
TLS_PASSTHROUGH = 'tls_passthrough'

HttpsEndpointStatus

소스: src/cwsandbox/_types.py:278

class HttpsEndpointStatus(*, port: int, name: str, kind: EndpointKind, auth: EndpointAuth, url: str, request_timeout_seconds: int)

Sandbox.service_endpoints에 반영되는, 적용된 HTTPS 제품 엔드포인트입니다. request_timeout_seconds는 서버 측에서 실제로 적용되는 타이머 값입니다(생성 시 생략하거나 0을 보낸 경우 15). API가 url을 숨기는 경우(종료 상태의 샌드박스)에는 url이 비어 있습니다. 이 값은 Sandbox.run(request_timeout_seconds=...)와는 다릅니다.

TlsPassthroughEndpointStatus

소스: src/cwsandbox/_types.py:303

class TlsPassthroughEndpointStatus(*, port: int, name: str, kind: EndpointKind, address: str)

적용된 TLS 패스스루 엔드포인트가 Sandbox.service_addresses에 반영됩니다. address는 host:port 형식입니다. 호스트를 TLS SNI로 사용하세요. 워크로드가 인증서를 소유합니다. 중지 후에는 비어 있습니다.

샌드박스

샌드박스 사용하기

샌드박스 관리

레퍼런스

엔드포인트