跳到主要内容

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 <名称>stringProfile 名称(必填)
--store-domain, -s <域名>string该 Profile 绑定的店铺域名(如 my-store.myshoplaza.com)(必填)
--scope <作用域>StringSlice该 Profile 的作用域(须为账户已授权作用域的子集);留空则授予账户的全部作用域
--usebool添加后设为当前 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
--previousbool切回上一个 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(必填)