> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 엔드포인트

> Product 엔드포인트 on public services, and the status shapes echoed back.

<h2 id="endpoint">
  엔드포인트
</h2>

소스: [src/cwsandbox/\_types.py:219](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_types.py#L219)

```python theme={"system"}
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
  패스스루에서는 설정하지 않아야 합니다.

***

<h2 id="endpointauth">
  EndpointAuth
</h2>

소스: [src/cwsandbox/\_types.py:213](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_types.py#L213)

```python theme={"system"}
class EndpointAuth
```

* `OPEN` = `'open'`

***

<h2 id="endpointkind">
  EndpointKind
</h2>

소스: [src/cwsandbox/\_types.py:206](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_types.py#L206)

```python theme={"system"}
class EndpointKind
```

* `HTTPS` = `'https'`
* `TLS_PASSTHROUGH` = `'tls_passthrough'`

***

<h2 id="httpsendpointstatus">
  HttpsEndpointStatus
</h2>

소스: [src/cwsandbox/\_types.py:278](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_types.py#L278)

```python theme={"system"}
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=...)`와는 다릅니다.

***

<h2 id="tlspassthroughendpointstatus">
  TlsPassthroughEndpointStatus
</h2>

소스: [src/cwsandbox/\_types.py:303](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_types.py#L303)

```python theme={"system"}
class TlsPassthroughEndpointStatus(*, port: int, name: str, kind: EndpointKind, address: str)
```

적용된 TLS 패스스루 엔드포인트가 `Sandbox.service_addresses`에 반영됩니다.

`address`는 `host:port` 형식입니다. 호스트를 TLS SNI로 사용하세요. 워크로드가
인증서를 소유합니다. 중지 후에는 비어 있습니다.

***