> ## 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.

# エンドポイント

> パブリックサービス上のプロダクトのエンドポイントと、エコーバックされるステータスの形状です。

<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`) : kind が HTTPS の場合 `OPEN`。TLS パススルーでは省略する必要があります。
* `request_timeout_seconds` (`int | None`) : プラットフォームが進行中の HTTPS リクエストを閉じるまでの秒数。`None` または `0` はプラットフォームのデフォルト (サーバーレスでは 15 秒) を選択します。サーバーは `0` または `[15, 900]` を受け入れます。create-from-template では、`0` は存在時に置換され、テンプレートのタイムアウトをプラットフォームのデフォルトに戻しません。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)
```

適用された HTTPS プロダクト エンドポイントは `Sandbox.service_endpoints` にエコーバックされます。

`request_timeout_seconds` は有効なサーバー側クロックです (create が省略された場合または `0` が送信された場合は 15) 。`url` は API がそれを抑制する場合 (ターミナルサンドボックス) に空になります。これは `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 として使用します。ワークロードが証明書を所有します。停止後は空になります。

***
