`terraform import` не угадывает ваши намерения. Он связывает существующий объект с address в state, а желаемые параметры по-прежнему задаёт configuration. Если пустой или неточный `resource` block отличается от cloud object, следующий normal plan честно предложит update либо replacement.

Остановитесь до apply. Сверьте provider account/region, уникальный ID и destination address, сделайте резервную копию state по принятой процедуре backend и получите свежий plan. Исправлять расхождение нужно в config или осознанно в инфраструктуре, а не ручным редактированием state JSON.

Три представления отвечают на разные вопросы

СлойЧто содержитТиповая ошибка
Remote objectФактические cloud/API параметрыВыбран объект из другого account/region
Terraform stateСвязь address, ID и прочитанные attributesИмпорт в неверный module/key
ConfigurationЖелаемые управляемые аргументыПустые значения и provider defaults
Provider schemaComputed/Optional/ForceNew semanticsАргумент нельзя трактовать как обычный update
PlanПредлагаемый переход config → remoteReplace замечен только после import

HashiCorp указывает: import block содержит identity/ID и address, а destination `resource` block представляет ресурс в configuration. Значение ID зависит от конкретного provider; имя в консоли не всегда является import ID.

Импорт описываем кодом и проверяем plan

import {
  to = example_service.app
  id = "provider-specific-resource-id"
}

resource "example_service" "app" {
  name   = "app"
  region = "region-from-provider"
  # Добавляйте только проверенные управляемые аргументы
}

terraform plan

Тип `example_service` условный: реальный resource type, формат ID и импортируемые attributes берутся из документации вашего provider и его версии. `to` должен совпасть с address resource block, включая module path и индекс `for_each`/`count`.

Сначала проверяем личность ресурса

  1. Сверить workspace/backend, provider alias, account/subscription и region.
  2. Получить ID по документации provider, а не по подписи в UI.
  3. Проверить destination address, module и instance key.
  4. После import перечитать state и remote object без изменения.
  5. Запустить speculative normal plan и сохранить его для review.

Если imported ID указывает не на тот объект, не применяйте plan. Удаление неверной связи из state не удаляет remote object только при корректной state-команде, но это отдельная ответственная операция: сначала подтвердите address и сделайте backup. Не используйте destroy для исправления ошибочного import.

Diff делим на computed, default и управляемое намерение

Computed fields provider читает сам; их обычно не копируют в config. Optional поля с provider/cloud defaults могут появиться в plan, если локальное значение подразумевает другое поведение. Для каждого diff откройте schema/docs: является ли аргумент управляемым, чувствительным, изменяемым и вызывает ли replacement.

Секреты не переносите из state в исходники. Если resource поддерживает ссылку на secret manager, настройте её по документации. State может содержать чувствительные значения даже при `sensitive=true`, поэтому доступ к backend и диагностическим выгрузкам ограничивают.

ignore_changes не заменяет модель ресурса

`ignore_changes` уместен, когда поле действительно управляется внешним процессом и это закреплено архитектурой. Добавлять туда весь diff после import опасно: Terraform перестанет замечать drift. Для каждого ignored attribute укажите владельца, причину и способ аудита.

Refresh-only plan предназначен для согласования state с намеренными внешними изменениями, но не объявляет их желаемой configuration. После него всё равно нужен normal plan. Режимы plan взаимоисключающие; не оценивайте готовность import только по refresh-only результату.

Нулевой plan — начало приёмки, не конец

Когда normal plan не предлагает изменений, выполните plan в CI с тем же backend/provider lock, затем проверьте policy и зависимости. Небольшое безопасное изменение проведите обычным review-процессом и откатите через configuration, чтобы убедиться, что объект действительно управляется ожидаемым address.

Диагностика не требует state целиком

Для разбора подготовьте version Terraform/provider, import block, обезличенный resource block, address, тип ID и plan diff без секретов. Полный state, backend credentials, cloud tokens и приватные значения отправлять нельзя.

Проверенные источники