文档中心

Terraform

cc 版本的 Terraform（推荐）

Terraform 身份认证

terraform provider volcenginecc 支持多种认证方式，您可以根据安全策略和便利性选择最适合的一种。使用 Terraform 管理火山引擎的云资源前，您需要获取 AK/SK，密钥获取方式参考访问密钥。

使用静态配置

你可以直接在 provider 块中编码 AK/SK。这种方式简单直接，但存在安全风险，极易导致凭证泄露，不建议在团队协作或生产环境中使用。

使用环境变量

在环境变量中配置密钥，适用于持续集成/持续部署（CI/CD）环境，Terraform 会自动读取特定的环境变量来完成认证。

使用本地配置文件

可以将凭证存储在本地的配置文件中（默认为 ~/.volcengine/config），然后在 provider 块中通过 profile 指定使用。

使用共享配置文件

当使用 CLI 完成凭证的配置后，Terraform 可以直接基于 Profile 的名称来配置身份认证方式，该机制能够以统一的方式管理多账号、多环境的认证凭证。

通过角色扮演认证

角色扮演（AssumeRole）适用于需要将权限与身份分离，或需要跨账号访问资源的场景。它通过一个已有身份如 IAM 子用户扮演 IAM 角色，从而获取该角色的临时凭证来访问资源。要在 Terraform 中使用角色扮演，您需要在 provider 配置块中添加一个 assume_role 的嵌套块，相关参数如下：

字段名	是否必填	类型	用途简述
assume_role_session_name	是	字符串	为角色扮演会话指定一个易于识别的名称，用于审计追踪。
assume_role_trn	是	字符串	要扮演的角色的唯一标识符（TRN）。
duration_seconds	是	数字	临时凭证的有效期（秒）。范围通常为 900-43200，默认 3600。
policy	否	JSON 字符串	附加一个额外的、更严格的权限策略，用于在角色原有权限基础上进一步收紧权限。

一个最简单的配置示例如下：

最近更新时间：2026.03.17 16:07:41

这个页面对您有帮助吗？

有用

无用