b2c-sandbox

B2C サンドボックススキル

明示的に依頼された場合にのみ、サンドボックスを作成または削除してください。破壊的な操作は必ず確認してください。

b2c CLI プラグインを使用して、Salesforce B2C Commerce On-demand サンドボックス（ODS）を管理します。請求が発生する、または破壊的な操作となる可能性があるため、明示的に依頼された場合にのみサンドボックスを作成または削除してください。

ヒント： b2c がグローバルにインストールされていない場合は、代わりに npx @salesforce/b2c-cli を使用してください（例：npx @salesforce/b2c-cli sandbox list）。

エイリアス： 下位互換性のため、ods プレフィックスも引き続きサポートされています（例：b2c ods list は b2c sandbox list と同じように動作します）。

設定と認証

CLI は、SFCC_* 環境変数（プロジェクトの .env を含む）、選択したプロジェクトローカルまたは共有の dw.json、および設定プラグインから認証情報を自動検出します。package.json が提供するのは、機密情報を含まないデフォルト値のみです。通常、--client-id や --client-secret などのフラグは不要です。自動検出された値を上書きする場合にのみ指定してください。ブラウザーベースのログインが必要な場合（例：クライアントシークレットがない場合や、対話形式で使用する場合）にのみ、--user-auth を使用してください。

b2c setup inspect を実行すると、解決された設定と各値の取得元を確認できます（スクリプトで使用する場合は --json を指定してください。デフォルトではシークレットはマスクされます）。優先順位のルールとトラブルシューティングについては、b2c-cli:b2c-config スキルを参照してください。

サンドボックス ID の形式

特定のサンドボックスを操作するコマンドでは、次の 2 種類の ID 形式を使用できます。

• UUID：サンドボックスの完全な UUID（例：abc12345-1234-1234-1234-abc123456789）
• レルム・インスタンス：レルム・インスタンス形式（例：zzzv-123 または zzzv_123）

レルム・インスタンス形式では、4 文字のレルムコードの後にハイフンまたはアンダースコアとインスタンス番号を指定します。この形式を使用すると、CLI が対応する UUID を自動的に検索します。

例

サンドボックスの一覧表示

b2c sandbox list

# for realm zzpq with JSON output
b2c sandbox list --realm zzpq --json

# filter by status and those created by a specific user, only print the columns id,state,hostname
b2c sandbox list --filter-params 'state=started,creating&[email protected]' --realm zzpq --columns id,state,hostname

サンドボックスの作成

請求が発生する可能性があるため、明示的に依頼された場合にのみサンドボックスを作成してください。

# create in realm zzpq with 4 hour TTL (0 = infinite); json output and wait for completion (this may take 5-10 minutes; timeout is 10 minutes)
b2c sandbox create --realm zzpq --ttl 4 --json --wait

# create in realm zzpq with large profile (medium is default)
b2c sandbox create --realm zzpq --profile large

# create without automatic OCAPI/WebDAV permissions
b2c sandbox create --realm zzpq --no-set-permissions

# use a different client ID for default permissions
b2c sandbox create --realm zzpq --permissions-client-id my-other-client

# custom OCAPI settings (replaces defaults)
b2c sandbox create --realm zzpq --ocapi-settings '[{"client_id":"my-client","resources":[{"resource_id":"/code_versions","methods":["get"]}]}]'

# with start/stop scheduler
b2c sandbox create --realm zzpq --start-scheduler '{"weekdays":["MONDAY","TUESDAY"],"time":"08:00:00Z"}' --stop-scheduler '{"weekdays":["MONDAY","TUESDAY"],"time":"19:00:00Z"}'

# get full log trace output to debug
b2c sandbox create --realm zzpq --log-level trace

サンドボックスの取得／起動／停止／再起動／削除

特定のサンドボックスを操作するコマンドでは、UUID とレルム・インスタンスの両方の形式を使用できます。

# Using UUID
b2c sandbox get abc12345-1234-1234-1234-abc123456789
b2c sandbox start abc12345-1234-1234-1234-abc123456789
b2c sandbox stop abc12345-1234-1234-1234-abc123456789

# Using realm-instance format
b2c sandbox get zzzv-123
b2c sandbox start zzzv_123
b2c sandbox stop zzzv-123
b2c sandbox restart zzzv-123
b2c sandbox delete zzzv-123 --force

サンドボックスのクローン作成

# clone a sandbox (defaults to source profile, 24h TTL)
b2c sandbox clone create zzzv-123

# clone with a different profile and wait for completion
b2c sandbox clone create zzzv-123 --target-profile large --wait

# create 3 clones from the same source in one request (1 to many cloning), and wait for all of them
b2c sandbox clone create zzzv-123 --target-count 3 --wait

# list clones for a sandbox, optionally filtered to a specific 1 to many batch
b2c sandbox clone list zzzv-123
b2c sandbox clone list zzzv-123 --batch-id batch-abcd-002-1700000000000-a1b2c3d4

# get details for a specific clone
b2c sandbox clone get zzzv-123 aaaa-002-1642780893121

その他のコマンド

sandbox トピックで使用できるコマンドとオプションの一覧については、b2c sandbox --help を参照してください。