配置

ecctl configure 写入资源命令使用的 ecctl 本地配置。原生 OAuth 登录只在其中保存非敏感 profile 元数据，包括经过验证的账号 ID；access token、refresh token 和换取到的 STS 凭证只进入 ~/.ecctl/credentials-v2/ 下的 canonical 私有存储。普通云命令仍会把本地 aliyun CLI profile 作为只读的回退来源。

配置地域

ecctl configure set region cn-hangzhou

输出形态：

{
  "key": "region",
  "profile": "default",
  "sensitive": false,
  "value": "cn-hangzhou"
}

设置默认输出模式：

ecctl configure set output json

读取当前生效的 profile：

ecctl configure get

输出形态：

{
  "lang": "",
  "mode": "",
  "output": "json",
  "profile": "default",
  "region": "cn-hangzhou"
}

凭证

ecctl 支持阿里云 CLI 当前的同组十一种凭证模式，并把兼容 ~/.aliyun/config.json 的 profile 作为只读的回退来源。只有 OAuth 提供 ecctl 交互式配置流程：

ecctl configure --mode OAuth --profile production
ecctl --profile production ecs instance list --region cn-hangzhou

其余模式通过 aliyun configure --mode <Mode>、环境变量，或直接向兼容配置文件写入 profile 来配置。本地 AK 或 STS 凭证也可以直接设置：

ecctl configure set access-key-id <id>
ecctl configure set access-key-secret <secret>
ecctl configure set security-token <token>

身份凭证是这一领域的参考文档：模式选择、两个配置文件及其能力差异、profile 与凭证解析顺序、身份固定、验证方式，以及 DEBUG=dara 的失败退出规则。每种凭证模式都有独立页面，可以从该总览或侧边栏进入。

支持的配置项

列出支持的配置项：

ecctl configure list

当前配置项：

配置项	存储为	取值
`region`	`region_id`	任意语法合法的阿里云地域 ID
`access-key-id`	`access_key_id`	字符串
`access-key-secret`	`access_key_secret`	字符串，敏感
`security-token`	`sts_token`	字符串，敏感
`lang`	`language`	`en`、`zh-CN`
`output`	`output_format`	`json`、`text`

敏感值默认掩码。仅在确实需要查看本地敏感值时使用 --show-secret。

Profile

用 --profile 写入命名 profile：

ecctl --profile production configure set output json

profile 存在后切换当前 profile：

ecctl configure use production

configure use 会在兼容 aliyun 的配置和 ecctl 配置中检查该 profile 名，然后将所选 profile 记录到 ecctl 配置文件。

凭证 profile 的选择优先级如下：

--profile
ECCTL_PROFILE，然后是兼容的阿里云 profile 环境变量
本地配置中的当前 profile

所选 profile 优先于普通凭证环境变量。设置 ALIBABA_CLOUD_IGNORE_PROFILE=TRUE 后，命令忽略已存储凭证，仅使用环境变量提供的凭证。显式选择的 profile 不存在时会直接失败，不会静默切换身份。

全局覆盖

全局 flag 可对单条命令覆盖配置：

ecctl --region cn-beijing --output json --lang en schema --list ecs

常用全局 flag：

Flag	用途
`--profile`	选择配置 profile
`--region`	选择当前命令的阿里云地域
`--output`	选择 `json` 或 `text` 输出
`--json`	强制 JSON 输出
`--lang`	选择 `en` 或 `zh-CN` 文案
`--no-color`	关闭人类可读输出的颜色
`--agent-envelope`	将 JSON 输出包裹在 ecctl Agent envelope 中

环境变量

ecctl 识别以下环境变量覆盖：

变量	用途
`ECCTL_PROFILE`、`ALIBABACLOUD_PROFILE`、`ALIBABA_CLOUD_PROFILE`、`ALICLOUD_PROFILE`	未传 `--profile` 时的默认 profile
`ECCTL_REGION`、`ALIBABA_CLOUD_REGION_ID`、`ALIBABACLOUD_REGION_ID`、`ALICLOUD_REGION_ID`	未传 `--region` 时的地域覆盖
`ECCTL_ALIYUN_CONFIG_PATH`、`ALIBABA_CLOUD_CONFIG_PATH`、`ALIBABACLOUD_CONFIG_PATH`、`ALICLOUD_CONFIG_PATH`	兼容 `aliyun` CLI 的配置文件路径，按此顺序检查
`ALIBABA_CLOUD_IGNORE_PROFILE`	设为 `TRUE` 时忽略已存储的凭证 profile
`ALIBABA_CLOUD_ACCESS_KEY_ID`、`ALIBABA_CLOUD_ACCESS_KEY_SECRET`、`ALIBABA_CLOUD_SECURITY_TOKEN`	AK 或 STS 凭证
`ALIBABA_CLOUD_ROLE_ARN`、`ALIBABA_CLOUD_ROLE_SESSION_NAME`、`ALIBABA_CLOUD_EXTERNAL_ID`	RAM 角色扮演
`ALIBABA_CLOUD_ECS_METADATA`、`ALIBABA_CLOUD_IMDSV1_DISABLED`	ECS 实例 RAM 角色和 IMDS 策略
`ALIBABA_CLOUD_OIDC_PROVIDER_ARN`、`ALIBABA_CLOUD_OIDC_TOKEN_FILE`	OIDC/RRSA 凭证
`ALIBABA_CLOUD_CREDENTIALS_URI`	CredentialsURI 端点
`ALIBABA_CLOUD_BEARER_TOKEN`、`ALIBABA_CLOUD_BEARER_TOKEN_HEADER_KEY`	Bearer 令牌和可选的自定义请求头
`ALIBABA_CLOUD_DISABLE_EXTERNAL_PROCESS`	禁用 `External` 和 `CredentialsURI` 凭证来源

配置地域​

凭证​

支持的配置项​

Profile​

全局覆盖​

环境变量​

配置地域

凭证

支持的配置项

Profile

全局覆盖

环境变量