{"record":{"id":"b6f7e03d72dc04ac","repo":"pulumi/pulumi","slug":"unknown-setting-name-s","errorCode":null,"errorMessage":"unknown setting name: %s","messagePattern":"unknown setting name: (.+?)","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"pkg/cmd/esc/cli/env_settings_get.go","lineNumber":82,"sourceCode":"\n\t\t\tif len(args) == 0 {\n\t\t\t\tif format == outputJSON {\n\t\t\t\t\tall := map[string]any{}\n\t\t\t\t\tfor _, setting := range registry.Settings {\n\t\t\t\t\t\tall[setting.KebabName()] = setting.GetValue(settings)\n\t\t\t\t\t}\n\t\t\t\t\treturn writeJSON(env.esc.stdout, all)\n\t\t\t\t}\n\t\t\t\tfor _, setting := range registry.Settings {\n\t\t\t\t\tfmt.Fprintf(env.esc.stdout, \"%s %v\\n\", setting.KebabName(), setting.GetValue(settings))\n\t\t\t\t}\n\t\t\t\treturn nil\n\t\t\t}\n\n\t\t\trawSettingName := args[0]\n\t\t\tsetting, ok := registry.GetSetting(rawSettingName)\n\t\t\tif !ok {\n\t\t\t\treturn fmt.Errorf(\"unknown setting name: %s\", rawSettingName)\n\t\t\t}\n\n\t\t\tvalue := setting.GetValue(settings)\n\t\t\tif format == outputJSON {\n\t\t\t\treturn writeJSON(env.esc.stdout, map[string]any{setting.KebabName(): value})\n\t\t\t}\n\t\t\tfmt.Fprintln(env.esc.stdout, value)\n\n\t\t\treturn nil\n\t\t},\n\t}\n\n\taddOutputFlag(cmd, &output)\n\n\treturn cmd\n}\n","sourceCodeStart":64,"sourceCodeEnd":99,"githubUrl":"https://github.com/pulumi/pulumi/blob/793f7b2e160db4321fb7fb6b0607461e01cb251e/pkg/cmd/esc/cli/env_settings_get.go#L64-L99","documentation":"`pulumi esc env get-settings` takes an optional setting name argument which must match a name registered in the settings registry (e.g. \"deletion-protected\"). If the provided name is not found in the registry, the command fails with this error rather than querying the API.","triggerScenarios":"Running `pulumi esc env get-settings <env> <name>` where <name> is not a registered setting — typos like \"deletionProtection\", \"deletion_protected\", or a name that exists only conceptually but is not in the registry.","commonSituations":"Guessing setting names from API docs instead of the CLI's kebab-case registry names; using camelCase or snake_case variants of \"deletion-protected\".","solutions":["Use the exact kebab-case name: `pulumi esc env get-settings my-env deletion-protected`","Run without a setting name (`pulumi esc env get-settings my-env`) to list all settings and see valid names","Check `pulumi esc env set-settings --help` for the list of supported setting names"],"exampleFix":"// before\n$ pulumi esc env get-settings my-env deletionProtection\n// after\n$ pulumi esc env get-settings my-env deletion-protected","handlingStrategy":"validation","validationCode":"const KNOWN_SETTINGS = [\"deletion-protected\"];\nif (!KNOWN_SETTINGS.includes(settingName)) {\n  throw new Error(`unknown setting \"${settingName}\"; valid: ${KNOWN_SETTINGS.join(\", \")}`);\n}","typeGuard":"const isKnownSetting = (name, registry) =>\n  typeof name === \"string\" && registry.some((s) => s.kebabName === name);","tryCatchPattern":null,"preventionTips":["Use kebab-case setting names exactly as shown in `--help`","Run get-settings without a name first to enumerate valid settings","Avoid camelCase/snake_case variants of setting names"],"tags":["cli","esc-settings","unknown-setting"],"backgroundTag":"unknown-setting-name","analyzedSha":"793f7b2e160db4321fb7fb6b0607461e01cb251e","analyzedAt":"2026-08-31T09:36:43.099Z","schemaVersion":2},"datasetVersion":"2026-09-01T08:17:40.651Z"}