用途:通过 b2c CLI 插件管理 Salesforce B2C Commerce 按需沙箱(ODS)。仅在用户明确要求时才创建或删除沙箱,因为可能产生计费或不可逆操作,破坏性操作需确认。
主要能力:列出沙箱(可按 realm、状态、创建者过滤并选择输出列);创建沙箱(可指定 realm、TTL、profile、权限、OCAPI 设置、启停调度器);获取、启动、停止、重启、删除指定沙箱;克隆沙箱(支持指定目标 profile、一次生成多个克隆、列出与查看克隆详情)。
使用方式:若未全局安装 b2c,可用 npx @salesforce/b2c-cli 替代,例如 npx @salesforce/b2c-cli sandbox list。ods 前缀为向后兼容别名,b2c ods list 等同于 b2c sandbox list。CLI 会从 SFCC_* 环境变量(含项目 .env)、项目本地或共享 dw.json 及配置插件自动发现凭据,通常无需传 --client-id/--client-secret;仅在需要浏览器登录时用 --user-auth。可用 b2c setup inspect 查看解析后的配置与来源,--json 便于脚本化,密钥默认掩码。
沙箱 ID 支持两种格式:完整 UUID,或 realm-instance(4 位 realm 码加连字符或下划线加实例号,如 zzzv-123 或 zzzv_123),后者会自动查找对应 UUID。
示例:b2c sandbox list --realm zzpq --json;b2c sandbox create --realm zzpq --ttl 4 --json --wait;b2c sandbox get zzzv-123;b2c sandbox delete zzzv-123 --force;b2c sandbox clone create zzzv-123 --target-count 3 --wait。
限制:创建可能计费,删除不可逆,均需明确请求;创建等待可能耗时 5-10 分钟,超时 10 分钟;更多命令见 b2c sandbox --help。