跳至主要内容

uuid 函数

uuid 生成一个唯一的标识符字符串。

该 ID 是生成的,并根据 RFC 4122 第 4.4 节 的要求进行格式化,生成版本 4 的 UUID。结果是仅从伪随机数生成的 UUID。

此函数每次调用时都会生成一个新值,因此在资源参数中直接使用它会导致虚假差异。我们不建议在资源配置中使用 uuid 函数,但可以谨慎地结合 ignore_changes 生命周期元参数 使用。

在大多数情况下,我们建议改用 random 提供程序,因为它允许一次性生成随机值,然后将其保留在 OpenTofu 状态 中以供后续操作使用。特别是,random_id 可以生成与 uuid 函数具有相同随机性的结果。

示例

代码块
> uuid()
b5ee72a3-54dd-c4b8-551c-4bdc0204cedb
  • uuidv5,它生成基于名称的 UUID。