terraform/website/docs/configuration/functions/jsondecode.html.md

1.8 KiB

layout page_title sidebar_current description
functions jsondecode - Functions - Configuration Language docs-funcs-encoding-jsondecode The jsondecode function decodes a JSON string into a representation of its value.

jsondecode Function

-> Note: This page is about Terraform 0.12 and later. For Terraform 0.11 and earlier, see 0.11 Configuration Language: Interpolation Syntax.

jsondecode interprets a given string as JSON, returning a representation of the result of decoding that string.

The JSON encoding is defined in RFC 7159.

This function maps JSON values to Terraform language values in the following way:

JSON type Terraform type
String string
Number number
Boolean bool
Object object(...) with attribute types determined per this table
Array tuple(...) with element types determined per this table
Null The Terraform language null value

The Terraform language automatic type conversion rules mean that you don't usually need to worry about exactly what type is produced for a given value, and can just use the result in an intuitive way.

Examples

> jsondecode("{\"hello\": \"world\"}")
{
  "hello" = "world"
}
> jsondecode("true")
true
  • jsonencode performs the opposite operation, encoding a value as JSON.