エンドポイント

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 パススルーでは未設定にする必要があります。

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)

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

サンドボックス

サンドボックスを使用する

サンドボックスの管理

リファレンス

エンドポイント