Z Tag
管理组织服务与凭证配置

火山引擎 OpenAPI

获取 Access Key,配置火山引擎 OpenAPI 的 Region、Service 与允许的操作。

适用于组织 Owner / Admin;成员的个人连接器同样适用

在连接器的 访问内容 → 添加访问 中,从 服务预设 选择 火山引擎 OpenAPI。Region、Service 和 Version 按目标产品的 API 文档填写。

获取与填写凭证

在火山引擎控制台的 访问控制(IAM)→ 访问密钥 中,为实际调用目标服务的身份创建 Access Key,并为该身份授予目标产品权限。复制 Access Key ID 与 Secret Access Key,分别填入表单的 Access Key ID 和 Secret Key。

使用临时凭证时,再把配套的 Session Token 填入 Session Token(可选)。权限范围仍由云服务的 IAM 策略决定。

官方说明:火山引擎访问控制。

服务地址

填写目标产品文档中的 https://<endpoint>.volcengineapi.com。

Region

Region 必填。从目标产品 API 文档的请求示例或火山引擎控制台的资源详情复制地域代码,不要根据控制台页面的显示语言推断地域。每份凭证只按这里填写的地域签名,创建后不能修改;需要访问其他地域时,另建一份凭证。

Service

填写目标产品要求的签名 Service。产品可使用包含下划线的 Service 名称;它不是资源 ID,也不一定等于服务地址的主机名前缀。

允许的操作

每行填写 Action@Version。Action 和 Version 来自要调用的 OpenAPI 接口说明,使用该产品实际支持的组合。

验证

保存后请 ZAI 用一项已授权的只读操作访问目标资源。出现签名错误时,先核对 Access Key ID 与 Secret Key 是否配对,以及 Region、Service、Version 和服务地址是否正确,再核对 允许的操作 与云端账号权限。其余排查见验证与排错。

本页目录