Profile 管理
管理店铺 Profile。Profile 是已登录账户下按店铺划分的执行上下文(店铺、店铺令牌和作用域),让你无需重新认证即可操作多个店铺。auth login --store-domain 和 auth store use 会自动创建并切换 Profile。
如需让单条命令使用另一个 Profile 而不切换,传入全局参数 --profile <名称> 或设置 SHOPLAZZA_CLI_PROFILE。--profile 优先于环境变量,环境变量优先于当前 Profile。
在交互式终端中,add 会询问缺少的名称和店铺,use、rename、remove 可从列表中选择 Profile,remove 还会请你确认。
add
添加一个绑定到店铺的命名 Profile,并申请、缓存其店铺令牌。需要先登录账户(shoplazza auth login)。
shell
shoplazza profile add [参数]
参数
| 参数 | 类型 | 说明 |
|---|---|---|
--name <名称> | string | Profile 名称(必填) |
--store-domain, -s <域名> | string | 该 Profile 绑定的店铺域名(如 my-store.myshoplaza.com)(必填) |
--scope <作用域> | StringSlice | 该 Profile 的作用域(须为账户已授权作用域的子集);留空则授予账户的全部作用域 |
--use | bool | 添加后设为当前 Profile |
示例
shell
# 为店铺添加 Profile
shoplazza profile add --name prod --store-domain my-store.myshoplaza.com
# 添加限定作用域的 Profile 并切换过去
shoplazza profile add --name staging --store-domain staging.myshoplaza.com --scope read_product --use
list
列出所有已配置的 Profile,包括店铺、作用域、令牌状态以及哪个是当前 Profile。
shell
shoplazza profile list
info
显示某个 Profile 的详情(默认当前 Profile)。
shell
shoplazza profile info [参数]
参数
| 参数 | 类型 | 说明 |
|---|---|---|
--name <名称> | string | 要查看的 Profile(默认当前 Profile) |
use
切换到指定的 Profile,或切回上一个 Profile。
shell
shoplazza profile use [参数]
参数
| 参数 | 类型 | 说明 |
|---|---|---|
--name <名称> | string | 要切换到的 Profile |
--previous | bool | 切回上一个 Profile |
示例
shell
# 切换到指定 Profile
shoplazza profile use --name prod
# 切回上一个 Profile
shoplazza profile use --previous
# 单条命令使用另一个 Profile,不切换
shoplazza products list --profile prod
update
更新某个 Profile 的作用域。缓存的店铺令牌会被丢弃,下一条命令按新作用域重新申请。
shell
shoplazza profile update [参数]
参数
| 参数 | 类型 | 说明 |
|---|---|---|
--name <名称> | string | 要更新的 Profile(默认当前 Profile) |
--scope <作用域> | StringSlice | 该 Profile 的新作用域(须为账户已授权作用域的子集) |
rename
重命名 Profile。
shell
shoplazza profile rename [参数]
参数
| 参数 | 类型 | 说明 |
|---|---|---|
--from <名称> | string | 现有 Profile 名称(默认当前 Profile) |
--to <名称> | string | 新的 Profile 名称(必填) |
remove
删除 Profile:包括其缓存的店铺令牌和配置记录。账户登录状态保留。
shell
shoplazza profile remove [参数]
参数
| 参数 | 类型 | 说明 |
|---|---|---|
--name <名称> | string | 要删除的 Profile(必填) |