Terraform Error Codes

Diagnostic error types produced by the Terraform CLI. These appear as structured diagnostics in human-readable output and in machine-readable JSON (terraform plan -json), covering configuration, state, backend, provider, and plan/apply errors.

40 codes

• backend_initialization_required Backend initialization required
• cycle_error Cycle error
• duplicate_resource Duplicate resource
• error_locking_state Error locking state
• error_refreshing_state Error refreshing state
• failed_to_read_schema Failed to read schema
• incompatible_provider_version Incompatible provider version
• insufficient_permissions Insufficient permissions
• invalid_block_definition Invalid block definition
• invalid_count_argument Invalid count argument
• invalid_depends_on Invalid depends_on reference
• invalid_expression Invalid expression
• invalid_for_each_argument Invalid for_each argument
• invalid_function_call Invalid function call
• invalid_index Invalid index
• invalid_module_output_reference Module has no output with name
• invalid_provider_configuration Invalid provider configuration
• invalid_resource_type Invalid resource type
• invalid_template_interpolation Invalid template interpolation value
• invalid_value Invalid value
• missing_required_argument Missing required argument
• missing_required_provider Missing required provider
• module_not_installed Module not installed
• no_configuration_files No configuration files
• output_refers_to_sensitive_value Output refers to sensitive values
• plan_file_incompatible Saved plan is stale
• provider_configuration_not_present Provider configuration not present
• provider_not_found Provider not found
• reference_to_undeclared_input_variable Reference to undeclared input variable
• reference_to_undeclared_local_value Reference to undeclared local value
• reference_to_undeclared_resource Reference to undeclared resource
• required_providers_not_initialised Required providers not initialised
• resource_already_exists Resource already exists
• state_inconsistency Inconsistent result after apply
• state_lock_error Error acquiring the state lock
• type_mismatch Incorrect attribute value type
• unsupported_argument Unsupported argument
• unsupported_attribute Unsupported attribute
• unsupported_block_type Unsupported block type
• values_not_yet_known Error: ... will be known only after apply