You're looking at documentation for Terraform v1.1 and earlier. Click here to view the latest content.
A new platform for documentation and tutorials is launching soon.
We are migrating Terraform documentation into HashiCorp Developer, our new developer experience.
uuid generates a unique identifier string.
The id is a generated and formatted as required by RFC 4122 section 4.4, producing a Version 4 UUID. The result is a UUID generated only from pseudo-random numbers.
This function produces a new value each time it is called, and so using it
directly in resource arguments will result in spurious diffs. We do not
recommend using the
uuid function in resource configurations, but it can
be used with care in conjunction with
ignore_changes lifecycle meta-argument.
In most cases we recommend using the
instead, since it allows the one-time generation of random values that are
then retained in the Terraform state for use by
future operations. In particular,
random_id can generate results with
equivalent randomness to the
> uuid() b5ee72a3-54dd-c4b8-551c-4bdc0204cedb
uuidv5, which generates name-based UUIDs.