用途:配置 Elastic Cloud 的认证信息与环境默认值,是所有 cloud/* 技能的前置步骤。
主要能力:验证 EC_API_KEY 是否已设置;引导用户在 Elastic Cloud 生成 API 密钥(仅组织所有者可创建和管理 Cloud API 密钥,创建时需包含 Project Admin 或更高权限);设置 EC_BASE_URL 与 EC_REGION 默认值;通过 regions 接口验证连接。
使用方式:先检查密钥 echo "${EC_API_KEY:?Not set}",未设置则引导用户自行设置。推荐在项目根目录创建 .env 文件写入 EC_API_KEY=your-api-key,cloud/* 脚本会自动加载;也可在终端 export EC_API_KEY="your-api-key"。随后设置 export EC_BASE_URL="https://api.elastic-cloud.com" 与 export EC_REGION="gcp-us-central1",如需其他区域可调用 ${EC_BASE_URL}/api/v1/serverless/regions 列出。最后用 curl -sf -H "Authorization: ApiKey ${EC_API_KEY}" "${EC_BASE_URL}/api/v1/serverless/regions" 验证,成功输出 Authenticated.。
环境变量:EC_API_KEY 必填;EC_BASE_URL 可选,默认 https://api.elastic-cloud.com;EC_REGION 可选,默认 gcp-us-central1。
限制与注意:绝不能在对话中接收、回显或记录 API 密钥等凭据,需由用户在终端或文件中自行管理;沙箱代理可能看不到终端 export,建议用 .env。本地文件存密钥仅适合开发,生产或共享环境应使用集中式密钥管理器。验证失败时检查密钥是否有效或过期、到 api.elastic-cloud.com 的网络连通性。资料未提供免费试用以外的收费与价格信息。