Команда: state show

Команда tofu state show используется для отображения атрибутов отдельного ресурса в состоянии OpenTofu.

Использование​

Использование: tofu state show [options] ADDRESS

Команда отображает атрибуты отдельного ресурса в файле состояния, соответствующего указанному адресу.

Для этой команды требуется адрес, указывающий на отдельный ресурс в состоянии. Адреса задаются в формате адресации ресурсов.

Все флаги командной строки необязательны. Доступны следующие флаги:

• -state=path — путь к файлу состояния. По умолчанию используется "terraform.tfstate". Игнорируется при использовании удаленного состояния.

• -var 'NAME=VALUE' — задает значение для одной входной переменной, объявленной в корневом модуле конфигурации. Используйте этот параметр несколько раз, чтобы задать несколько переменных. Дополнительные сведения см. в разделе Входные переменные в командной строке.

• -var-file=FILENAME — задает значения для нескольких входных переменных, объявленных в корневом модуле конфигурации, используя определения из файла "tfvars". Используйте этот параметр несколько раз, чтобы включить значения из нескольких файлов.

• -show-sensitive — если указан, отображаются конфиденциальные значения.

• -json — включает вывод машиночитаемого JSON-интерфейса.

• -json-into=out.json — формирует тот же вывод, что и -json, но перенаправляет его в файл. Это позволяет одновременно сохранять машиночитаемые и удобочитаемые журналы.

Помимо параметров -var и -var-file, задать значения входных переменных корневого модуля можно несколькими другими способами. Дополнительные сведения см. в разделе Задание значений переменным корневого модуля.

Вывод tofu state show предназначен для чтения человеком, а не для программной обработки. Чтобы извлечь данные состояния для использования в другом программном обеспечении, используйте tofu show -json и декодируйте результат согласно документированной структуре.

Пример: отображение ресурса​

В приведенном ниже примере показан ресурс packet_device с именем worker:

$ tofu state show 'packet_device.worker'
# packet_device.worker:
resource "packet_device" "worker" {
    billing_cycle = "hourly"
    created       = "2015-12-17T00:06:56Z"
    facility      = "ewr1"
    hostname      = "prod-xyz01"
    id            = "6015bg2b-b8c4-4925-aad2-f0671d5d3b13"
    locked        = false
}

Пример: отображение ресурса модуля​

В приведенном ниже примере показан ресурс packet_device с именем worker в модуле с именем foo:

$ tofu state show 'module.foo.packet_device.worker'

Пример: отображение ресурса, настроенного с помощью count​

В приведенном ниже примере показан первый экземпляр ресурса packet_device с именем worker, настроенного с помощью count:

$ tofu state show 'packet_device.worker[0]'

Пример: отображение ресурса, настроенного с помощью for_each​

В следующем примере показан экземпляр "example" ресурса packet_device с именем worker, настроенного с помощью метааргумента for_each. Если имя ресурса содержит специальные символы, например двойные кавычки, его необходимо заключить в одинарные кавычки.

Linux, Mac OS и UNIX:

$ tofu state show 'packet_device.worker["example"]'

PowerShell:

$ tofu state show 'packet_device.worker[\"example\"]'

Windows cmd.exe:

$ tofu state show packet_device.worker[\"example\"]