[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-hashicorp-provider-actions":3,"mdc-ktcj08-key":34,"related-org-hashicorp-provider-actions":3654,"related-repo-hashicorp-provider-actions":3808},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":22,"repoUrl":23,"updatedAt":24,"license":25,"forks":26,"topics":27,"repo":29,"sourceUrl":32,"mdContent":33},"provider-actions","implement Terraform Provider lifecycle actions","Implement Terraform Provider actions using the Plugin Framework. Use when developing imperative operations that execute at lifecycle events (before\u002Fafter create, update, destroy).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"hashicorp","HashiCorp","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fhashicorp.png",[12,16,19],{"name":13,"slug":14,"type":15},"Plugin Development","plugin-development","tag",{"name":17,"slug":18,"type":15},"Terraform","terraform",{"name":20,"slug":21,"type":15},"API Development","api-development",728,"https:\u002F\u002Fgithub.com\u002Fhashicorp\u002Fagent-skills","2026-04-06T18:25:07.880533",null,104,[28],"doormat-managed",{"repoUrl":23,"stars":22,"forks":26,"topics":30,"description":31},[28],"A collection of Agent skills and Claude Code plugins for HashiCorp products.","https:\u002F\u002Fgithub.com\u002Fhashicorp\u002Fagent-skills\u002Ftree\u002FHEAD\u002Fterraform\u002Fprovider-development\u002Fskills\u002Fprovider-actions","---\nname: provider-actions\ndescription: Implement Terraform Provider actions using the Plugin Framework. Use when developing imperative operations that execute at lifecycle events (before\u002Fafter create, update, destroy).\nmetadata:\n copyright: Copyright IBM Corp. 2026\n version: \"0.0.1\"\n---\n\n# Terraform Provider Actions Implementation Guide\n\n## Overview\n\nTerraform Actions enable imperative operations during the Terraform lifecycle. Actions are experimental features that allow performing provider operations at specific lifecycle events (before\u002Fafter create, update, destroy).\n\n**References:**\n- [Terraform Plugin Framework](https:\u002F\u002Fdeveloper.hashicorp.com\u002Fterraform\u002Fplugin\u002Fframework)\n- [Terraform Actions RFC](https:\u002F\u002Fgithub.com\u002Fhashicorp\u002Fterraform\u002Fblob\u002Fmain\u002Fdocs\u002Fplugin-protocol\u002Factions.md)\n\n## First Action Setup\n\nWhen adding the first action to a provider that has never had one, several one-time scaffolding steps are required:\n\n1. **Implement `ProviderWithActions`** — add an `Actions()` method to the provider that returns `[]func() action.Action`.\n2. **Set `ActionData` in `Configure`** — the provider's `Configure` method must set `resp.ActionData = v` alongside the existing `ResourceData`, `DataSourceData`, and `EphemeralResourceData` assignments.\n3. **Create `ActionWithConfigure` base type** — if the provider uses embedded base types (e.g. `ResourceWithConfigure`), create an equivalent `ActionWithConfigure` type implementing `action.ConfigureRequest` \u002F `action.ConfigureResponse`.\n4. **Action-schema helper variants** — if the provider injects common schema attributes (e.g. `namespace`) via helper functions, action-schema variants are needed since `action\u002Fschema` types differ from `resource\u002Fschema` types.\n\n## File Structure\n\nActions follow the standard service package structure:\n\n```\ninternal\u002Fservice\u002F\u003Cservice>\u002F\n├── \u003Caction_name>_action.go # Action implementation\n├── \u003Caction_name>_action_test.go # Action tests\n└── service_package_gen.go # Auto-generated service registration\n```\n\nDocumentation structure:\n```\nwebsite\u002Fdocs\u002Factions\u002F\n└── \u003Cservice>_\u003Caction_name>.html.markdown # User-facing documentation\n```\n\nChangelog entry:\n```\n.changelog\u002F\n└── \u003Cpr_number_or_description>.txt # Release note entry\n```\n\n## Action Schema Definition\n\nActions use the Terraform Plugin Framework with a standard schema pattern:\n\n```go\nfunc (a *actionType) Schema(ctx context.Context, req action.SchemaRequest, resp *action.SchemaResponse) {\n resp.Schema = schema.Schema{\n Attributes: map[string]schema.Attribute{\n \u002F\u002F Required configuration parameters\n \"resource_id\": schema.StringAttribute{\n Required: true,\n Description: \"ID of the resource to operate on\",\n },\n \u002F\u002F Optional parameters with defaults\n \"timeout\": schema.Int64Attribute{\n Optional: true,\n Description: \"Operation timeout in seconds\",\n Default: int64default.StaticInt64(1800),\n Computed: true,\n },\n },\n }\n}\n```\n\n### Common Schema Issues\n\n**Pay special attention to the schema definition** - common issues after a first draft:\n\n1. **Type Mismatches**\n - Using `types.String` instead of `fwtypes.String` in model structs\n - Using `types.StringType` instead of `fwtypes.StringType` in schema\n - Mixing framework types with plugin-framework types\n\n2. **List\u002FMap Element Types**\n ```go\n \u002F\u002F WRONG - missing ElementType\n \"items\": schema.ListAttribute{\n Optional: true,\n }\n\n \u002F\u002F CORRECT\n \"items\": schema.ListAttribute{\n Optional: true,\n ElementType: fwtypes.StringType,\n }\n ```\n\n3. **Computed vs Optional**\n - Attributes with defaults must be both `Optional: true` and `Computed: true`\n - Don't mark action inputs as `Computed` unless they have defaults\n\n4. **Validator Imports**\n ```go\n \u002F\u002F Ensure proper imports\n \"github.com\u002Fhashicorp\u002Fterraform-plugin-framework-validators\u002Fint64validator\"\n \"github.com\u002Fhashicorp\u002Fterraform-plugin-framework-validators\u002Fstringvalidator\"\n ```\n\n5. **Region\u002FProvider Attribute**\n - Use framework-provided region handling when available\n - Don't manually define provider-specific config in schema if framework handles it\n\n6. **Nested Attributes**\n - Use appropriate nested object types for complex structures\n - Ensure nested types are properly defined\n\n### Schema Validation Checklist\n\nBefore submitting, verify:\n- [ ] All attributes have descriptions\n- [ ] List\u002FMap attributes have ElementType defined\n- [ ] Validators are imported and applied correctly\n- [ ] Model struct uses correct framework types\n- [ ] Optional attributes with defaults are marked Computed\n- [ ] Code compiles without type errors\n- [ ] Run `go build` to catch type mismatches\n\n## Action Invoke Method\n\nThe Invoke method contains the action logic:\n\n```go\nfunc (a *actionType) Invoke(ctx context.Context, req action.InvokeRequest, resp *action.InvokeResponse) {\n var data actionModel\n resp.Diagnostics.Append(req.Config.Get(ctx, &data)...)\n\n \u002F\u002F Create provider client\n conn := a.Meta().Client(ctx)\n\n \u002F\u002F Progress updates for long-running operations\n resp.Progress.Set(ctx, \"Starting operation...\")\n\n \u002F\u002F Implement action logic with error handling\n \u002F\u002F Use context for timeout management\n \u002F\u002F Poll for completion if async operation\n\n resp.Progress.Set(ctx, \"Operation completed\")\n}\n```\n\n## Key Implementation Requirements\n\n### 1. Progress Reporting\n\n- Use `resp.SendProgress(action.InvokeProgressEvent{...})` for real-time updates\n- Provide meaningful progress messages during long operations\n- Update progress at key milestones\n- Include elapsed time for long operations\n\n### 2. Timeout Management\n\n- Always include configurable timeout parameter (default: 1800s)\n- Use `context.WithTimeout()` for API calls\n- Handle timeout errors gracefully\n- Validate timeout ranges (typically 60-7200 seconds)\n\n### 3. Error Handling\n\n- Add diagnostics with `resp.Diagnostics.AddError()`\n- Provide clear error messages with context\n- Include API error details when relevant\n- Map provider error types to user-friendly messages\n- Document all possible error cases\n\nExample error handling:\n```go\n\u002F\u002F Handle specific errors\nvar notFound *types.ResourceNotFoundException\nif errors.As(err, ¬Found) {\n resp.Diagnostics.AddError(\n \"Resource Not Found\",\n fmt.Sprintf(\"Resource %s was not found\", resourceID),\n )\n return\n}\n\n\u002F\u002F Generic error handling\nresp.Diagnostics.AddError(\n \"Operation Failed\",\n fmt.Sprintf(\"Could not complete operation for %s: %s\", resourceID, err),\n)\n```\n\n### 4. Provider SDK Integration\n\n- Use provider SDK clients from `a.Meta().\u003CService>Client(ctx)`\n- Handle pagination for list operations\n- Implement retry logic for transient failures\n- Use appropriate error types\n\n### 5. Parameter Validation\n\n- Use framework validators for input validation\n- Validate resource existence before operations\n- Check for conflicting parameters\n- Validate against provider naming requirements\n\n### 6. Polling and Waiting\n\nFor operations that require waiting for completion:\n\n```go\nresult, err := wait.WaitForStatus(ctx,\n func(ctx context.Context) (wait.FetchResult[*ResourceType], error) {\n \u002F\u002F Fetch current status\n resource, err := findResource(ctx, conn, id)\n if err != nil {\n return wait.FetchResult[*ResourceType]{}, err\n }\n return wait.FetchResult[*ResourceType]{\n Status: wait.Status(resource.Status),\n Value: resource,\n }, nil\n },\n wait.Options[*ResourceType]{\n Timeout: timeout,\n Interval: wait.FixedInterval(5 * time.Second),\n SuccessStates: []wait.Status{\"AVAILABLE\", \"COMPLETED\"},\n TransitionalStates: []wait.Status{\"CREATING\", \"PENDING\"},\n ProgressInterval: 30 * time.Second,\n ProgressSink: func(fr wait.FetchResult[any], meta wait.ProgressMeta) {\n resp.SendProgress(action.InvokeProgressEvent{\n Message: fmt.Sprintf(\"Status: %s, Elapsed: %v\", fr.Status, meta.Elapsed.Round(time.Second)),\n })\n },\n },\n)\n```\n\n## Common Action Patterns\n\n### Batch Operations\n- Process items in configurable batches\n- Report progress per batch\n- Handle partial failures gracefully\n- Support prefix\u002Ffilter parameters\n\n### Command Execution\n- Submit command and get operation ID\n- Poll for completion status\n- Retrieve and report output\n- Handle timeout during polling\n- Validate resources exist before execution\n\n### Service Invocation\n- Invoke service with parameters\n- Wait for completion (if synchronous)\n- Return output\u002Fresults\n- Handle service-specific errors\n\n### Resource State Changes\n- Validate current state\n- Apply state change\n- Poll for target state\n- Handle transitional states\n\n### Async Job Submission\n- Submit job with configuration\n- Get job ID\n- Optionally wait for completion\n- Report job status\n\n## Action Triggers\n\nActions are invoked via `action_trigger` lifecycle blocks in Terraform configurations. A standalone `action` block without a corresponding trigger is declared but never executed.\n\n### HCL Syntax\n\nAction parameters must be wrapped in a `config {}` block. Trigger references use the `action.` prefix, and `actions` is a list. Events are bare identifiers, not quoted strings.\n\n```hcl\naction \"provider_service_action\" \"name\" {\n config {\n parameter = value\n }\n}\n\nresource \"terraform_data\" \"trigger\" {\n lifecycle {\n action_trigger {\n events = [after_create]\n actions = [action.provider_service_action.name]\n }\n }\n}\n```\n\n### Available Trigger Events\n\n**Terraform 1.14.0 Supported Events:**\n- `before_create` - Before resource creation\n- `after_create` - After resource creation\n- `before_update` - Before resource update\n- `after_update` - After resource update\n\n**Not Supported in Terraform 1.14.0:**\n- `before_destroy` - Not available (will cause validation error)\n- `after_destroy` - Not available (will cause validation error)\n\n## Testing Actions\n\n### Acceptance Tests\n\n- Test action invocation with valid parameters\n- Test timeout scenarios\n- Test error conditions\n- Verify provider state changes\n- Test progress reporting\n- Test with custom parameters\n- Test trigger-based invocation\n\n### Test Pattern\n\n```go\nfunc TestAccServiceAction_basic(t *testing.T) {\n ctx := acctest.Context(t)\n\n resource.ParallelTest(t, resource.TestCase{\n PreCheck: func() { acctest.PreCheck(ctx, t) },\n ProtoV5ProviderFactories: acctest.ProtoV5ProviderFactories,\n TerraformVersionChecks: []tfversion.TerraformVersionCheck{\n tfversion.SkipBelow(tfversion.Version1_14_0),\n },\n Steps: []resource.TestStep{\n {\n Config: testAccActionConfig_basic(),\n Check: resource.ComposeTestCheckFunc(\n testAccCheckResourceExists(ctx, \"provider_resource.test\"),\n ),\n },\n },\n })\n}\n```\n\n### Test Cleanup with Sweep Functions\n\nAdd sweep functions to clean up test resources:\n\n```go\nfunc sweepResources(region string) error {\n ctx := context.Background()\n client := \u002F* get client for region *\u002F\n\n input := &service.ListInput{\n \u002F\u002F Filter for test resources\n }\n\n var sweeperErrs *multierror.Error\n\n pages := service.NewListPaginator(client, input)\n for pages.HasMorePages() {\n page, err := pages.NextPage(ctx)\n if err != nil {\n sweeperErrs = multierror.Append(sweeperErrs, err)\n continue\n }\n\n for _, item := range page.Items {\n id := item.Id\n\n \u002F\u002F Skip non-test resources\n if !strings.HasPrefix(id, \"tf-acc-test\") {\n continue\n }\n\n _, err := client.Delete(ctx, &service.DeleteInput{\n Id: id,\n })\n if err != nil {\n sweeperErrs = multierror.Append(sweeperErrs, err)\n }\n }\n }\n\n return sweeperErrs.ErrorOrNil()\n}\n```\n\n### Using `terraform_data` as a No-Op Trigger\n\n`terraform_data` can serve as a no-op trigger resource for action tests that don't need real infrastructure. This is valuable for error-case and validation tests:\n\n```hcl\nresource \"terraform_data\" \"trigger\" {\n lifecycle {\n action_trigger {\n events = [after_create]\n actions = [action.provider_service_action.test]\n }\n }\n}\n\naction \"provider_service_action\" \"test\" {\n config {\n param = \"invalid-value\"\n }\n}\n```\n\n### Using `PostApplyFunc` to Verify Side Effects\n\nActions don't produce state that can be checked with `resource.TestCheckResourceAttr`. Use `PostApplyFunc` on `resource.TestStep` to query the API after apply and confirm the action produced the expected side effect:\n\n```go\nSteps: []resource.TestStep{\n {\n Config: testConfig,\n PostApplyFunc: func() {\n \u002F\u002F query the API to verify the action's side effect occurred\n },\n },\n},\n```\n\n### Testing Best Practices\n\n**Service-Specific Prerequisites**\n- Always check for service-specific prerequisites that must be met before actions can succeed\n- Document prerequisites in action documentation and test configurations\n\n**Error Pattern Matching**\n- Terraform wraps action errors with additional context\n- Use flexible regex patterns: `regexache.MustCompile(\\`(?s)Error Title.*key phrase\\`)`\n\n**Test Patterns Not Applicable to Actions**\n1. Actions trigger on lifecycle events, not config reapplication\n2. Before\u002FAfter Destroy Tests: Not supported in Terraform 1.14.0\n\n### Running Tests\n\nCompile test to check for errors:\n```bash\ngo test -c -o \u002Fdev\u002Fnull .\u002Finternal\u002Fservice\u002F\u003Cservice>\n```\n\nRun specific action tests:\n```bash\nTF_ACC=1 go test .\u002Finternal\u002Fservice\u002F\u003Cservice> -run TestAccServiceAction_ -v\n```\n\nRun sweep to clean up test resources:\n```bash\nTF_ACC=1 go test .\u002Finternal\u002Fservice\u002F\u003Cservice> -sweep=\u003Cregion> -v\n```\n\n## Documentation Standards\n\nEach action documentation file must include:\n\n1. **Front Matter**\n ```yaml\n ---\n subcategory: \"Service Name\"\n layout: \"provider\"\n page_title: \"Provider: provider_service_action\"\n description: |-\n Brief description of what the action does.\n ---\n ```\n\n2. **Header with Warnings**\n - Beta\u002FAlpha notice about experimental status\n - Warning about potential unintended consequences\n - Link to provider documentation\n\n3. **Example Usage**\n - Basic usage example\n - Advanced usage with all options\n - Trigger-based example with `terraform_data`\n - Real-world use case examples\n\n4. **Argument Reference**\n - List all required and optional arguments\n - Include descriptions and defaults\n - Note any validation rules\n\n5. **Documentation Linting**\n - Run `terrafmt fmt` before submission\n - Verify with `terrafmt diff`\n\n## Changelog Entry Format\n\nCreate a changelog entry in `.changelog\u002F` directory:\n\n```\n.changelog\u002F\u003Cpr_number_or_description>.txt\n```\n\nContent format:\n```release-note:new-action\naction\u002Fprovider_service_action: Brief description of the action\n```\n\n## Pre-Submission Checklist\n\nBefore submitting your action implementation:\n\n- [ ] Code compiles: `go build -o \u002Fdev\u002Fnull .`\n- [ ] Tests compile: `go test -c -o \u002Fdev\u002Fnull .\u002Finternal\u002Fservice\u002F\u003Cservice>`\n- [ ] Code formatted: `make fmt`\n- [ ] Documentation formatted: `terrafmt fmt website\u002Fdocs\u002Factions\u002F\u003Caction>.html.markdown`\n- [ ] Changelog entry created\n- [ ] Schema uses correct types\n- [ ] All List\u002FMap attributes have ElementType\n- [ ] Progress updates implemented for long operations\n- [ ] Error messages include context and resource identifiers\n- [ ] Documentation includes multiple examples\n- [ ] Documentation includes prerequisites and warnings\n\n## References\n\n- [Terraform Plugin Framework Documentation](https:\u002F\u002Fdeveloper.hashicorp.com\u002Fterraform\u002Fplugin\u002Fframework)\n- [Terraform Provider Development](https:\u002F\u002Fdeveloper.hashicorp.com\u002Fterraform\u002Fplugin)\n- [terraform-plugin-framework GitHub](https:\u002F\u002Fgithub.com\u002Fhashicorp\u002Fterraform-plugin-framework)\n- [terraform-plugin-testing](https:\u002F\u002Fgithub.com\u002Fhashicorp\u002Fterraform-plugin-testing)\n- [Writing a Terraform Action (blog)](https:\u002F\u002Fdanielmschmidt.de\u002Fposts\u002F2025-09-26-writing-a-terraform-action\u002F)\n- Reference implementations: `terraform-provider-tfe` (`action_query_run.go`, `action_query_run_test.go`), `terraform-provider-vault` (`action_rotate_root.go`)\n",{"data":35,"body":39},{"name":4,"description":6,"metadata":36},{"copyright":37,"version":38},"Copyright IBM Corp. 2026","0.0.1",{"type":40,"children":41},"root",[42,51,58,64,73,100,106,111,293,299,304,316,321,330,335,344,350,355,527,534,544,820,826,831,910,916,921,1051,1057,1063,1094,1100,1130,1136,1170,1175,1300,1306,1335,1341,1364,1370,1375,1586,1592,1598,1621,1627,1655,1661,1684,1690,1713,1719,1742,1748,1769,1775,1804,1920,1926,1934,1981,1989,2013,2019,2025,2063,2069,2223,2229,2234,2534,2547,2557,2665,2678,2706,2775,2781,2789,2802,2810,2831,2839,2852,2858,2863,2928,2933,3003,3008,3080,3086,3091,3360,3366,3379,3388,3393,3409,3415,3420,3547,3553,3648],{"type":43,"tag":44,"props":45,"children":47},"element","h1",{"id":46},"terraform-provider-actions-implementation-guide",[48],{"type":49,"value":50},"text","Terraform Provider Actions Implementation Guide",{"type":43,"tag":52,"props":53,"children":55},"h2",{"id":54},"overview",[56],{"type":49,"value":57},"Overview",{"type":43,"tag":59,"props":60,"children":61},"p",{},[62],{"type":49,"value":63},"Terraform Actions enable imperative operations during the Terraform lifecycle. Actions are experimental features that allow performing provider operations at specific lifecycle events (before\u002Fafter create, update, destroy).",{"type":43,"tag":59,"props":65,"children":66},{},[67],{"type":43,"tag":68,"props":69,"children":70},"strong",{},[71],{"type":49,"value":72},"References:",{"type":43,"tag":74,"props":75,"children":76},"ul",{},[77,90],{"type":43,"tag":78,"props":79,"children":80},"li",{},[81],{"type":43,"tag":82,"props":83,"children":87},"a",{"href":84,"rel":85},"https:\u002F\u002Fdeveloper.hashicorp.com\u002Fterraform\u002Fplugin\u002Fframework",[86],"nofollow",[88],{"type":49,"value":89},"Terraform Plugin Framework",{"type":43,"tag":78,"props":91,"children":92},{},[93],{"type":43,"tag":82,"props":94,"children":97},{"href":95,"rel":96},"https:\u002F\u002Fgithub.com\u002Fhashicorp\u002Fterraform\u002Fblob\u002Fmain\u002Fdocs\u002Fplugin-protocol\u002Factions.md",[86],[98],{"type":49,"value":99},"Terraform Actions RFC",{"type":43,"tag":52,"props":101,"children":103},{"id":102},"first-action-setup",[104],{"type":49,"value":105},"First Action Setup",{"type":43,"tag":59,"props":107,"children":108},{},[109],{"type":49,"value":110},"When adding the first action to a provider that has never had one, several one-time scaffolding steps are required:",{"type":43,"tag":112,"props":113,"children":114},"ol",{},[115,148,211,259],{"type":43,"tag":78,"props":116,"children":117},{},[118,130,132,138,140,146],{"type":43,"tag":68,"props":119,"children":120},{},[121,123],{"type":49,"value":122},"Implement ",{"type":43,"tag":124,"props":125,"children":127},"code",{"className":126},[],[128],{"type":49,"value":129},"ProviderWithActions",{"type":49,"value":131}," — add an ",{"type":43,"tag":124,"props":133,"children":135},{"className":134},[],[136],{"type":49,"value":137},"Actions()",{"type":49,"value":139}," method to the provider that returns ",{"type":43,"tag":124,"props":141,"children":143},{"className":142},[],[144],{"type":49,"value":145},"[]func() action.Action",{"type":49,"value":147},".",{"type":43,"tag":78,"props":149,"children":150},{},[151,170,172,177,179,185,187,193,195,201,203,209],{"type":43,"tag":68,"props":152,"children":153},{},[154,156,162,164],{"type":49,"value":155},"Set ",{"type":43,"tag":124,"props":157,"children":159},{"className":158},[],[160],{"type":49,"value":161},"ActionData",{"type":49,"value":163}," in ",{"type":43,"tag":124,"props":165,"children":167},{"className":166},[],[168],{"type":49,"value":169},"Configure",{"type":49,"value":171}," — the provider's ",{"type":43,"tag":124,"props":173,"children":175},{"className":174},[],[176],{"type":49,"value":169},{"type":49,"value":178}," method must set ",{"type":43,"tag":124,"props":180,"children":182},{"className":181},[],[183],{"type":49,"value":184},"resp.ActionData = v",{"type":49,"value":186}," alongside the existing ",{"type":43,"tag":124,"props":188,"children":190},{"className":189},[],[191],{"type":49,"value":192},"ResourceData",{"type":49,"value":194},", ",{"type":43,"tag":124,"props":196,"children":198},{"className":197},[],[199],{"type":49,"value":200},"DataSourceData",{"type":49,"value":202},", and ",{"type":43,"tag":124,"props":204,"children":206},{"className":205},[],[207],{"type":49,"value":208},"EphemeralResourceData",{"type":49,"value":210}," assignments.",{"type":43,"tag":78,"props":212,"children":213},{},[214,227,229,235,237,242,244,250,252,258],{"type":43,"tag":68,"props":215,"children":216},{},[217,219,225],{"type":49,"value":218},"Create ",{"type":43,"tag":124,"props":220,"children":222},{"className":221},[],[223],{"type":49,"value":224},"ActionWithConfigure",{"type":49,"value":226}," base type",{"type":49,"value":228}," — if the provider uses embedded base types (e.g. ",{"type":43,"tag":124,"props":230,"children":232},{"className":231},[],[233],{"type":49,"value":234},"ResourceWithConfigure",{"type":49,"value":236},"), create an equivalent ",{"type":43,"tag":124,"props":238,"children":240},{"className":239},[],[241],{"type":49,"value":224},{"type":49,"value":243}," type implementing ",{"type":43,"tag":124,"props":245,"children":247},{"className":246},[],[248],{"type":49,"value":249},"action.ConfigureRequest",{"type":49,"value":251}," \u002F ",{"type":43,"tag":124,"props":253,"children":255},{"className":254},[],[256],{"type":49,"value":257},"action.ConfigureResponse",{"type":49,"value":147},{"type":43,"tag":78,"props":260,"children":261},{},[262,267,269,275,277,283,285,291],{"type":43,"tag":68,"props":263,"children":264},{},[265],{"type":49,"value":266},"Action-schema helper variants",{"type":49,"value":268}," — if the provider injects common schema attributes (e.g. ",{"type":43,"tag":124,"props":270,"children":272},{"className":271},[],[273],{"type":49,"value":274},"namespace",{"type":49,"value":276},") via helper functions, action-schema variants are needed since ",{"type":43,"tag":124,"props":278,"children":280},{"className":279},[],[281],{"type":49,"value":282},"action\u002Fschema",{"type":49,"value":284}," types differ from ",{"type":43,"tag":124,"props":286,"children":288},{"className":287},[],[289],{"type":49,"value":290},"resource\u002Fschema",{"type":49,"value":292}," types.",{"type":43,"tag":52,"props":294,"children":296},{"id":295},"file-structure",[297],{"type":49,"value":298},"File Structure",{"type":43,"tag":59,"props":300,"children":301},{},[302],{"type":49,"value":303},"Actions follow the standard service package structure:",{"type":43,"tag":305,"props":306,"children":310},"pre",{"className":307,"code":309,"language":49},[308],"language-text","internal\u002Fservice\u002F\u003Cservice>\u002F\n├── \u003Caction_name>_action.go # Action implementation\n├── \u003Caction_name>_action_test.go # Action tests\n└── service_package_gen.go # Auto-generated service registration\n",[311],{"type":43,"tag":124,"props":312,"children":314},{"__ignoreMap":313},"",[315],{"type":49,"value":309},{"type":43,"tag":59,"props":317,"children":318},{},[319],{"type":49,"value":320},"Documentation structure:",{"type":43,"tag":305,"props":322,"children":325},{"className":323,"code":324,"language":49},[308],"website\u002Fdocs\u002Factions\u002F\n└── \u003Cservice>_\u003Caction_name>.html.markdown # User-facing documentation\n",[326],{"type":43,"tag":124,"props":327,"children":328},{"__ignoreMap":313},[329],{"type":49,"value":324},{"type":43,"tag":59,"props":331,"children":332},{},[333],{"type":49,"value":334},"Changelog entry:",{"type":43,"tag":305,"props":336,"children":339},{"className":337,"code":338,"language":49},[308],".changelog\u002F\n└── \u003Cpr_number_or_description>.txt # Release note entry\n",[340],{"type":43,"tag":124,"props":341,"children":342},{"__ignoreMap":313},[343],{"type":49,"value":338},{"type":43,"tag":52,"props":345,"children":347},{"id":346},"action-schema-definition",[348],{"type":49,"value":349},"Action Schema Definition",{"type":43,"tag":59,"props":351,"children":352},{},[353],{"type":49,"value":354},"Actions use the Terraform Plugin Framework with a standard schema pattern:",{"type":43,"tag":305,"props":356,"children":360},{"className":357,"code":358,"language":359,"meta":313,"style":313},"language-go shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","func (a *actionType) Schema(ctx context.Context, req action.SchemaRequest, resp *action.SchemaResponse) {\n resp.Schema = schema.Schema{\n Attributes: map[string]schema.Attribute{\n \u002F\u002F Required configuration parameters\n \"resource_id\": schema.StringAttribute{\n Required: true,\n Description: \"ID of the resource to operate on\",\n },\n \u002F\u002F Optional parameters with defaults\n \"timeout\": schema.Int64Attribute{\n Optional: true,\n Description: \"Operation timeout in seconds\",\n Default: int64default.StaticInt64(1800),\n Computed: true,\n },\n },\n }\n}\n","go",[361],{"type":43,"tag":124,"props":362,"children":363},{"__ignoreMap":313},[364,375,384,393,402,411,420,429,438,447,456,465,474,483,492,500,509,518],{"type":43,"tag":365,"props":366,"children":369},"span",{"class":367,"line":368},"line",1,[370],{"type":43,"tag":365,"props":371,"children":372},{},[373],{"type":49,"value":374},"func (a *actionType) Schema(ctx context.Context, req action.SchemaRequest, resp *action.SchemaResponse) {\n",{"type":43,"tag":365,"props":376,"children":378},{"class":367,"line":377},2,[379],{"type":43,"tag":365,"props":380,"children":381},{},[382],{"type":49,"value":383}," resp.Schema = schema.Schema{\n",{"type":43,"tag":365,"props":385,"children":387},{"class":367,"line":386},3,[388],{"type":43,"tag":365,"props":389,"children":390},{},[391],{"type":49,"value":392}," Attributes: map[string]schema.Attribute{\n",{"type":43,"tag":365,"props":394,"children":396},{"class":367,"line":395},4,[397],{"type":43,"tag":365,"props":398,"children":399},{},[400],{"type":49,"value":401}," \u002F\u002F Required configuration parameters\n",{"type":43,"tag":365,"props":403,"children":405},{"class":367,"line":404},5,[406],{"type":43,"tag":365,"props":407,"children":408},{},[409],{"type":49,"value":410}," \"resource_id\": schema.StringAttribute{\n",{"type":43,"tag":365,"props":412,"children":414},{"class":367,"line":413},6,[415],{"type":43,"tag":365,"props":416,"children":417},{},[418],{"type":49,"value":419}," Required: true,\n",{"type":43,"tag":365,"props":421,"children":423},{"class":367,"line":422},7,[424],{"type":43,"tag":365,"props":425,"children":426},{},[427],{"type":49,"value":428}," Description: \"ID of the resource to operate on\",\n",{"type":43,"tag":365,"props":430,"children":432},{"class":367,"line":431},8,[433],{"type":43,"tag":365,"props":434,"children":435},{},[436],{"type":49,"value":437}," },\n",{"type":43,"tag":365,"props":439,"children":441},{"class":367,"line":440},9,[442],{"type":43,"tag":365,"props":443,"children":444},{},[445],{"type":49,"value":446}," \u002F\u002F Optional parameters with defaults\n",{"type":43,"tag":365,"props":448,"children":450},{"class":367,"line":449},10,[451],{"type":43,"tag":365,"props":452,"children":453},{},[454],{"type":49,"value":455}," \"timeout\": schema.Int64Attribute{\n",{"type":43,"tag":365,"props":457,"children":459},{"class":367,"line":458},11,[460],{"type":43,"tag":365,"props":461,"children":462},{},[463],{"type":49,"value":464}," Optional: true,\n",{"type":43,"tag":365,"props":466,"children":468},{"class":367,"line":467},12,[469],{"type":43,"tag":365,"props":470,"children":471},{},[472],{"type":49,"value":473}," Description: \"Operation timeout in seconds\",\n",{"type":43,"tag":365,"props":475,"children":477},{"class":367,"line":476},13,[478],{"type":43,"tag":365,"props":479,"children":480},{},[481],{"type":49,"value":482}," Default: int64default.StaticInt64(1800),\n",{"type":43,"tag":365,"props":484,"children":486},{"class":367,"line":485},14,[487],{"type":43,"tag":365,"props":488,"children":489},{},[490],{"type":49,"value":491}," Computed: true,\n",{"type":43,"tag":365,"props":493,"children":495},{"class":367,"line":494},15,[496],{"type":43,"tag":365,"props":497,"children":498},{},[499],{"type":49,"value":437},{"type":43,"tag":365,"props":501,"children":503},{"class":367,"line":502},16,[504],{"type":43,"tag":365,"props":505,"children":506},{},[507],{"type":49,"value":508}," },\n",{"type":43,"tag":365,"props":510,"children":512},{"class":367,"line":511},17,[513],{"type":43,"tag":365,"props":514,"children":515},{},[516],{"type":49,"value":517}," }\n",{"type":43,"tag":365,"props":519,"children":521},{"class":367,"line":520},18,[522],{"type":43,"tag":365,"props":523,"children":524},{},[525],{"type":49,"value":526},"}\n",{"type":43,"tag":528,"props":529,"children":531},"h3",{"id":530},"common-schema-issues",[532],{"type":49,"value":533},"Common Schema Issues",{"type":43,"tag":59,"props":535,"children":536},{},[537,542],{"type":43,"tag":68,"props":538,"children":539},{},[540],{"type":49,"value":541},"Pay special attention to the schema definition",{"type":49,"value":543}," - common issues after a first draft:",{"type":43,"tag":112,"props":545,"children":546},{},[547,603,696,739,778,799],{"type":43,"tag":78,"props":548,"children":549},{},[550,555],{"type":43,"tag":68,"props":551,"children":552},{},[553],{"type":49,"value":554},"Type Mismatches",{"type":43,"tag":74,"props":556,"children":557},{},[558,579,598],{"type":43,"tag":78,"props":559,"children":560},{},[561,563,569,571,577],{"type":49,"value":562},"Using ",{"type":43,"tag":124,"props":564,"children":566},{"className":565},[],[567],{"type":49,"value":568},"types.String",{"type":49,"value":570}," instead of ",{"type":43,"tag":124,"props":572,"children":574},{"className":573},[],[575],{"type":49,"value":576},"fwtypes.String",{"type":49,"value":578}," in model structs",{"type":43,"tag":78,"props":580,"children":581},{},[582,583,589,590,596],{"type":49,"value":562},{"type":43,"tag":124,"props":584,"children":586},{"className":585},[],[587],{"type":49,"value":588},"types.StringType",{"type":49,"value":570},{"type":43,"tag":124,"props":591,"children":593},{"className":592},[],[594],{"type":49,"value":595},"fwtypes.StringType",{"type":49,"value":597}," in schema",{"type":43,"tag":78,"props":599,"children":600},{},[601],{"type":49,"value":602},"Mixing framework types with plugin-framework types",{"type":43,"tag":78,"props":604,"children":605},{},[606,611],{"type":43,"tag":68,"props":607,"children":608},{},[609],{"type":49,"value":610},"List\u002FMap Element Types",{"type":43,"tag":305,"props":612,"children":614},{"className":357,"code":613,"language":359,"meta":313,"style":313},"\u002F\u002F WRONG - missing ElementType\n\"items\": schema.ListAttribute{\n Optional: true,\n}\n\n\u002F\u002F CORRECT\n\"items\": schema.ListAttribute{\n Optional: true,\n ElementType: fwtypes.StringType,\n}\n",[615],{"type":43,"tag":124,"props":616,"children":617},{"__ignoreMap":313},[618,626,634,642,649,658,666,673,681,689],{"type":43,"tag":365,"props":619,"children":620},{"class":367,"line":368},[621],{"type":43,"tag":365,"props":622,"children":623},{},[624],{"type":49,"value":625},"\u002F\u002F WRONG - missing ElementType\n",{"type":43,"tag":365,"props":627,"children":628},{"class":367,"line":377},[629],{"type":43,"tag":365,"props":630,"children":631},{},[632],{"type":49,"value":633},"\"items\": schema.ListAttribute{\n",{"type":43,"tag":365,"props":635,"children":636},{"class":367,"line":386},[637],{"type":43,"tag":365,"props":638,"children":639},{},[640],{"type":49,"value":641}," Optional: true,\n",{"type":43,"tag":365,"props":643,"children":644},{"class":367,"line":395},[645],{"type":43,"tag":365,"props":646,"children":647},{},[648],{"type":49,"value":526},{"type":43,"tag":365,"props":650,"children":651},{"class":367,"line":404},[652],{"type":43,"tag":365,"props":653,"children":655},{"emptyLinePlaceholder":654},true,[656],{"type":49,"value":657},"\n",{"type":43,"tag":365,"props":659,"children":660},{"class":367,"line":413},[661],{"type":43,"tag":365,"props":662,"children":663},{},[664],{"type":49,"value":665},"\u002F\u002F CORRECT\n",{"type":43,"tag":365,"props":667,"children":668},{"class":367,"line":422},[669],{"type":43,"tag":365,"props":670,"children":671},{},[672],{"type":49,"value":633},{"type":43,"tag":365,"props":674,"children":675},{"class":367,"line":431},[676],{"type":43,"tag":365,"props":677,"children":678},{},[679],{"type":49,"value":680}," Optional: true,\n",{"type":43,"tag":365,"props":682,"children":683},{"class":367,"line":440},[684],{"type":43,"tag":365,"props":685,"children":686},{},[687],{"type":49,"value":688}," ElementType: fwtypes.StringType,\n",{"type":43,"tag":365,"props":690,"children":691},{"class":367,"line":449},[692],{"type":43,"tag":365,"props":693,"children":694},{},[695],{"type":49,"value":526},{"type":43,"tag":78,"props":697,"children":698},{},[699,704],{"type":43,"tag":68,"props":700,"children":701},{},[702],{"type":49,"value":703},"Computed vs Optional",{"type":43,"tag":74,"props":705,"children":706},{},[707,726],{"type":43,"tag":78,"props":708,"children":709},{},[710,712,718,720],{"type":49,"value":711},"Attributes with defaults must be both ",{"type":43,"tag":124,"props":713,"children":715},{"className":714},[],[716],{"type":49,"value":717},"Optional: true",{"type":49,"value":719}," and ",{"type":43,"tag":124,"props":721,"children":723},{"className":722},[],[724],{"type":49,"value":725},"Computed: true",{"type":43,"tag":78,"props":727,"children":728},{},[729,731,737],{"type":49,"value":730},"Don't mark action inputs as ",{"type":43,"tag":124,"props":732,"children":734},{"className":733},[],[735],{"type":49,"value":736},"Computed",{"type":49,"value":738}," unless they have defaults",{"type":43,"tag":78,"props":740,"children":741},{},[742,747],{"type":43,"tag":68,"props":743,"children":744},{},[745],{"type":49,"value":746},"Validator Imports",{"type":43,"tag":305,"props":748,"children":750},{"className":357,"code":749,"language":359,"meta":313,"style":313},"\u002F\u002F Ensure proper imports\n\"github.com\u002Fhashicorp\u002Fterraform-plugin-framework-validators\u002Fint64validator\"\n\"github.com\u002Fhashicorp\u002Fterraform-plugin-framework-validators\u002Fstringvalidator\"\n",[751],{"type":43,"tag":124,"props":752,"children":753},{"__ignoreMap":313},[754,762,770],{"type":43,"tag":365,"props":755,"children":756},{"class":367,"line":368},[757],{"type":43,"tag":365,"props":758,"children":759},{},[760],{"type":49,"value":761},"\u002F\u002F Ensure proper imports\n",{"type":43,"tag":365,"props":763,"children":764},{"class":367,"line":377},[765],{"type":43,"tag":365,"props":766,"children":767},{},[768],{"type":49,"value":769},"\"github.com\u002Fhashicorp\u002Fterraform-plugin-framework-validators\u002Fint64validator\"\n",{"type":43,"tag":365,"props":771,"children":772},{"class":367,"line":386},[773],{"type":43,"tag":365,"props":774,"children":775},{},[776],{"type":49,"value":777},"\"github.com\u002Fhashicorp\u002Fterraform-plugin-framework-validators\u002Fstringvalidator\"\n",{"type":43,"tag":78,"props":779,"children":780},{},[781,786],{"type":43,"tag":68,"props":782,"children":783},{},[784],{"type":49,"value":785},"Region\u002FProvider Attribute",{"type":43,"tag":74,"props":787,"children":788},{},[789,794],{"type":43,"tag":78,"props":790,"children":791},{},[792],{"type":49,"value":793},"Use framework-provided region handling when available",{"type":43,"tag":78,"props":795,"children":796},{},[797],{"type":49,"value":798},"Don't manually define provider-specific config in schema if framework handles it",{"type":43,"tag":78,"props":800,"children":801},{},[802,807],{"type":43,"tag":68,"props":803,"children":804},{},[805],{"type":49,"value":806},"Nested Attributes",{"type":43,"tag":74,"props":808,"children":809},{},[810,815],{"type":43,"tag":78,"props":811,"children":812},{},[813],{"type":49,"value":814},"Use appropriate nested object types for complex structures",{"type":43,"tag":78,"props":816,"children":817},{},[818],{"type":49,"value":819},"Ensure nested types are properly defined",{"type":43,"tag":528,"props":821,"children":823},{"id":822},"schema-validation-checklist",[824],{"type":49,"value":825},"Schema Validation Checklist",{"type":43,"tag":59,"props":827,"children":828},{},[829],{"type":49,"value":830},"Before submitting, verify:",{"type":43,"tag":74,"props":832,"children":835},{"className":833},[834],"contains-task-list",[836,848,857,866,875,884,893],{"type":43,"tag":78,"props":837,"children":840},{"className":838},[839],"task-list-item",[841,846],{"type":43,"tag":842,"props":843,"children":845},"input",{"disabled":654,"type":844},"checkbox",[],{"type":49,"value":847}," All attributes have descriptions",{"type":43,"tag":78,"props":849,"children":851},{"className":850},[839],[852,855],{"type":43,"tag":842,"props":853,"children":854},{"disabled":654,"type":844},[],{"type":49,"value":856}," List\u002FMap attributes have ElementType defined",{"type":43,"tag":78,"props":858,"children":860},{"className":859},[839],[861,864],{"type":43,"tag":842,"props":862,"children":863},{"disabled":654,"type":844},[],{"type":49,"value":865}," Validators are imported and applied correctly",{"type":43,"tag":78,"props":867,"children":869},{"className":868},[839],[870,873],{"type":43,"tag":842,"props":871,"children":872},{"disabled":654,"type":844},[],{"type":49,"value":874}," Model struct uses correct framework types",{"type":43,"tag":78,"props":876,"children":878},{"className":877},[839],[879,882],{"type":43,"tag":842,"props":880,"children":881},{"disabled":654,"type":844},[],{"type":49,"value":883}," Optional attributes with defaults are marked Computed",{"type":43,"tag":78,"props":885,"children":887},{"className":886},[839],[888,891],{"type":43,"tag":842,"props":889,"children":890},{"disabled":654,"type":844},[],{"type":49,"value":892}," Code compiles without type errors",{"type":43,"tag":78,"props":894,"children":896},{"className":895},[839],[897,900,902,908],{"type":43,"tag":842,"props":898,"children":899},{"disabled":654,"type":844},[],{"type":49,"value":901}," Run ",{"type":43,"tag":124,"props":903,"children":905},{"className":904},[],[906],{"type":49,"value":907},"go build",{"type":49,"value":909}," to catch type mismatches",{"type":43,"tag":52,"props":911,"children":913},{"id":912},"action-invoke-method",[914],{"type":49,"value":915},"Action Invoke Method",{"type":43,"tag":59,"props":917,"children":918},{},[919],{"type":49,"value":920},"The Invoke method contains the action logic:",{"type":43,"tag":305,"props":922,"children":924},{"className":357,"code":923,"language":359,"meta":313,"style":313},"func (a *actionType) Invoke(ctx context.Context, req action.InvokeRequest, resp *action.InvokeResponse) {\n var data actionModel\n resp.Diagnostics.Append(req.Config.Get(ctx, &data)...)\n\n \u002F\u002F Create provider client\n conn := a.Meta().Client(ctx)\n\n \u002F\u002F Progress updates for long-running operations\n resp.Progress.Set(ctx, \"Starting operation...\")\n\n \u002F\u002F Implement action logic with error handling\n \u002F\u002F Use context for timeout management\n \u002F\u002F Poll for completion if async operation\n\n resp.Progress.Set(ctx, \"Operation completed\")\n}\n",[925],{"type":43,"tag":124,"props":926,"children":927},{"__ignoreMap":313},[928,936,944,952,959,967,975,982,990,998,1005,1013,1021,1029,1036,1044],{"type":43,"tag":365,"props":929,"children":930},{"class":367,"line":368},[931],{"type":43,"tag":365,"props":932,"children":933},{},[934],{"type":49,"value":935},"func (a *actionType) Invoke(ctx context.Context, req action.InvokeRequest, resp *action.InvokeResponse) {\n",{"type":43,"tag":365,"props":937,"children":938},{"class":367,"line":377},[939],{"type":43,"tag":365,"props":940,"children":941},{},[942],{"type":49,"value":943}," var data actionModel\n",{"type":43,"tag":365,"props":945,"children":946},{"class":367,"line":386},[947],{"type":43,"tag":365,"props":948,"children":949},{},[950],{"type":49,"value":951}," resp.Diagnostics.Append(req.Config.Get(ctx, &data)...)\n",{"type":43,"tag":365,"props":953,"children":954},{"class":367,"line":395},[955],{"type":43,"tag":365,"props":956,"children":957},{"emptyLinePlaceholder":654},[958],{"type":49,"value":657},{"type":43,"tag":365,"props":960,"children":961},{"class":367,"line":404},[962],{"type":43,"tag":365,"props":963,"children":964},{},[965],{"type":49,"value":966}," \u002F\u002F Create provider client\n",{"type":43,"tag":365,"props":968,"children":969},{"class":367,"line":413},[970],{"type":43,"tag":365,"props":971,"children":972},{},[973],{"type":49,"value":974}," conn := a.Meta().Client(ctx)\n",{"type":43,"tag":365,"props":976,"children":977},{"class":367,"line":422},[978],{"type":43,"tag":365,"props":979,"children":980},{"emptyLinePlaceholder":654},[981],{"type":49,"value":657},{"type":43,"tag":365,"props":983,"children":984},{"class":367,"line":431},[985],{"type":43,"tag":365,"props":986,"children":987},{},[988],{"type":49,"value":989}," \u002F\u002F Progress updates for long-running operations\n",{"type":43,"tag":365,"props":991,"children":992},{"class":367,"line":440},[993],{"type":43,"tag":365,"props":994,"children":995},{},[996],{"type":49,"value":997}," resp.Progress.Set(ctx, \"Starting operation...\")\n",{"type":43,"tag":365,"props":999,"children":1000},{"class":367,"line":449},[1001],{"type":43,"tag":365,"props":1002,"children":1003},{"emptyLinePlaceholder":654},[1004],{"type":49,"value":657},{"type":43,"tag":365,"props":1006,"children":1007},{"class":367,"line":458},[1008],{"type":43,"tag":365,"props":1009,"children":1010},{},[1011],{"type":49,"value":1012}," \u002F\u002F Implement action logic with error handling\n",{"type":43,"tag":365,"props":1014,"children":1015},{"class":367,"line":467},[1016],{"type":43,"tag":365,"props":1017,"children":1018},{},[1019],{"type":49,"value":1020}," \u002F\u002F Use context for timeout management\n",{"type":43,"tag":365,"props":1022,"children":1023},{"class":367,"line":476},[1024],{"type":43,"tag":365,"props":1025,"children":1026},{},[1027],{"type":49,"value":1028}," \u002F\u002F Poll for completion if async operation\n",{"type":43,"tag":365,"props":1030,"children":1031},{"class":367,"line":485},[1032],{"type":43,"tag":365,"props":1033,"children":1034},{"emptyLinePlaceholder":654},[1035],{"type":49,"value":657},{"type":43,"tag":365,"props":1037,"children":1038},{"class":367,"line":494},[1039],{"type":43,"tag":365,"props":1040,"children":1041},{},[1042],{"type":49,"value":1043}," resp.Progress.Set(ctx, \"Operation completed\")\n",{"type":43,"tag":365,"props":1045,"children":1046},{"class":367,"line":502},[1047],{"type":43,"tag":365,"props":1048,"children":1049},{},[1050],{"type":49,"value":526},{"type":43,"tag":52,"props":1052,"children":1054},{"id":1053},"key-implementation-requirements",[1055],{"type":49,"value":1056},"Key Implementation Requirements",{"type":43,"tag":528,"props":1058,"children":1060},{"id":1059},"_1-progress-reporting",[1061],{"type":49,"value":1062},"1. Progress Reporting",{"type":43,"tag":74,"props":1064,"children":1065},{},[1066,1079,1084,1089],{"type":43,"tag":78,"props":1067,"children":1068},{},[1069,1071,1077],{"type":49,"value":1070},"Use ",{"type":43,"tag":124,"props":1072,"children":1074},{"className":1073},[],[1075],{"type":49,"value":1076},"resp.SendProgress(action.InvokeProgressEvent{...})",{"type":49,"value":1078}," for real-time updates",{"type":43,"tag":78,"props":1080,"children":1081},{},[1082],{"type":49,"value":1083},"Provide meaningful progress messages during long operations",{"type":43,"tag":78,"props":1085,"children":1086},{},[1087],{"type":49,"value":1088},"Update progress at key milestones",{"type":43,"tag":78,"props":1090,"children":1091},{},[1092],{"type":49,"value":1093},"Include elapsed time for long operations",{"type":43,"tag":528,"props":1095,"children":1097},{"id":1096},"_2-timeout-management",[1098],{"type":49,"value":1099},"2. Timeout Management",{"type":43,"tag":74,"props":1101,"children":1102},{},[1103,1108,1120,1125],{"type":43,"tag":78,"props":1104,"children":1105},{},[1106],{"type":49,"value":1107},"Always include configurable timeout parameter (default: 1800s)",{"type":43,"tag":78,"props":1109,"children":1110},{},[1111,1112,1118],{"type":49,"value":1070},{"type":43,"tag":124,"props":1113,"children":1115},{"className":1114},[],[1116],{"type":49,"value":1117},"context.WithTimeout()",{"type":49,"value":1119}," for API calls",{"type":43,"tag":78,"props":1121,"children":1122},{},[1123],{"type":49,"value":1124},"Handle timeout errors gracefully",{"type":43,"tag":78,"props":1126,"children":1127},{},[1128],{"type":49,"value":1129},"Validate timeout ranges (typically 60-7200 seconds)",{"type":43,"tag":528,"props":1131,"children":1133},{"id":1132},"_3-error-handling",[1134],{"type":49,"value":1135},"3. Error Handling",{"type":43,"tag":74,"props":1137,"children":1138},{},[1139,1150,1155,1160,1165],{"type":43,"tag":78,"props":1140,"children":1141},{},[1142,1144],{"type":49,"value":1143},"Add diagnostics with ",{"type":43,"tag":124,"props":1145,"children":1147},{"className":1146},[],[1148],{"type":49,"value":1149},"resp.Diagnostics.AddError()",{"type":43,"tag":78,"props":1151,"children":1152},{},[1153],{"type":49,"value":1154},"Provide clear error messages with context",{"type":43,"tag":78,"props":1156,"children":1157},{},[1158],{"type":49,"value":1159},"Include API error details when relevant",{"type":43,"tag":78,"props":1161,"children":1162},{},[1163],{"type":49,"value":1164},"Map provider error types to user-friendly messages",{"type":43,"tag":78,"props":1166,"children":1167},{},[1168],{"type":49,"value":1169},"Document all possible error cases",{"type":43,"tag":59,"props":1171,"children":1172},{},[1173],{"type":49,"value":1174},"Example error handling:",{"type":43,"tag":305,"props":1176,"children":1178},{"className":357,"code":1177,"language":359,"meta":313,"style":313},"\u002F\u002F Handle specific errors\nvar notFound *types.ResourceNotFoundException\nif errors.As(err, ¬Found) {\n resp.Diagnostics.AddError(\n \"Resource Not Found\",\n fmt.Sprintf(\"Resource %s was not found\", resourceID),\n )\n return\n}\n\n\u002F\u002F Generic error handling\nresp.Diagnostics.AddError(\n \"Operation Failed\",\n fmt.Sprintf(\"Could not complete operation for %s: %s\", resourceID, err),\n)\n",[1179],{"type":43,"tag":124,"props":1180,"children":1181},{"__ignoreMap":313},[1182,1190,1198,1206,1214,1222,1230,1238,1246,1253,1260,1268,1276,1284,1292],{"type":43,"tag":365,"props":1183,"children":1184},{"class":367,"line":368},[1185],{"type":43,"tag":365,"props":1186,"children":1187},{},[1188],{"type":49,"value":1189},"\u002F\u002F Handle specific errors\n",{"type":43,"tag":365,"props":1191,"children":1192},{"class":367,"line":377},[1193],{"type":43,"tag":365,"props":1194,"children":1195},{},[1196],{"type":49,"value":1197},"var notFound *types.ResourceNotFoundException\n",{"type":43,"tag":365,"props":1199,"children":1200},{"class":367,"line":386},[1201],{"type":43,"tag":365,"props":1202,"children":1203},{},[1204],{"type":49,"value":1205},"if errors.As(err, ¬Found) {\n",{"type":43,"tag":365,"props":1207,"children":1208},{"class":367,"line":395},[1209],{"type":43,"tag":365,"props":1210,"children":1211},{},[1212],{"type":49,"value":1213}," resp.Diagnostics.AddError(\n",{"type":43,"tag":365,"props":1215,"children":1216},{"class":367,"line":404},[1217],{"type":43,"tag":365,"props":1218,"children":1219},{},[1220],{"type":49,"value":1221}," \"Resource Not Found\",\n",{"type":43,"tag":365,"props":1223,"children":1224},{"class":367,"line":413},[1225],{"type":43,"tag":365,"props":1226,"children":1227},{},[1228],{"type":49,"value":1229}," fmt.Sprintf(\"Resource %s was not found\", resourceID),\n",{"type":43,"tag":365,"props":1231,"children":1232},{"class":367,"line":422},[1233],{"type":43,"tag":365,"props":1234,"children":1235},{},[1236],{"type":49,"value":1237}," )\n",{"type":43,"tag":365,"props":1239,"children":1240},{"class":367,"line":431},[1241],{"type":43,"tag":365,"props":1242,"children":1243},{},[1244],{"type":49,"value":1245}," return\n",{"type":43,"tag":365,"props":1247,"children":1248},{"class":367,"line":440},[1249],{"type":43,"tag":365,"props":1250,"children":1251},{},[1252],{"type":49,"value":526},{"type":43,"tag":365,"props":1254,"children":1255},{"class":367,"line":449},[1256],{"type":43,"tag":365,"props":1257,"children":1258},{"emptyLinePlaceholder":654},[1259],{"type":49,"value":657},{"type":43,"tag":365,"props":1261,"children":1262},{"class":367,"line":458},[1263],{"type":43,"tag":365,"props":1264,"children":1265},{},[1266],{"type":49,"value":1267},"\u002F\u002F Generic error handling\n",{"type":43,"tag":365,"props":1269,"children":1270},{"class":367,"line":467},[1271],{"type":43,"tag":365,"props":1272,"children":1273},{},[1274],{"type":49,"value":1275},"resp.Diagnostics.AddError(\n",{"type":43,"tag":365,"props":1277,"children":1278},{"class":367,"line":476},[1279],{"type":43,"tag":365,"props":1280,"children":1281},{},[1282],{"type":49,"value":1283}," \"Operation Failed\",\n",{"type":43,"tag":365,"props":1285,"children":1286},{"class":367,"line":485},[1287],{"type":43,"tag":365,"props":1288,"children":1289},{},[1290],{"type":49,"value":1291}," fmt.Sprintf(\"Could not complete operation for %s: %s\", resourceID, err),\n",{"type":43,"tag":365,"props":1293,"children":1294},{"class":367,"line":494},[1295],{"type":43,"tag":365,"props":1296,"children":1297},{},[1298],{"type":49,"value":1299},")\n",{"type":43,"tag":528,"props":1301,"children":1303},{"id":1302},"_4-provider-sdk-integration",[1304],{"type":49,"value":1305},"4. Provider SDK Integration",{"type":43,"tag":74,"props":1307,"children":1308},{},[1309,1320,1325,1330],{"type":43,"tag":78,"props":1310,"children":1311},{},[1312,1314],{"type":49,"value":1313},"Use provider SDK clients from ",{"type":43,"tag":124,"props":1315,"children":1317},{"className":1316},[],[1318],{"type":49,"value":1319},"a.Meta().\u003CService>Client(ctx)",{"type":43,"tag":78,"props":1321,"children":1322},{},[1323],{"type":49,"value":1324},"Handle pagination for list operations",{"type":43,"tag":78,"props":1326,"children":1327},{},[1328],{"type":49,"value":1329},"Implement retry logic for transient failures",{"type":43,"tag":78,"props":1331,"children":1332},{},[1333],{"type":49,"value":1334},"Use appropriate error types",{"type":43,"tag":528,"props":1336,"children":1338},{"id":1337},"_5-parameter-validation",[1339],{"type":49,"value":1340},"5. Parameter Validation",{"type":43,"tag":74,"props":1342,"children":1343},{},[1344,1349,1354,1359],{"type":43,"tag":78,"props":1345,"children":1346},{},[1347],{"type":49,"value":1348},"Use framework validators for input validation",{"type":43,"tag":78,"props":1350,"children":1351},{},[1352],{"type":49,"value":1353},"Validate resource existence before operations",{"type":43,"tag":78,"props":1355,"children":1356},{},[1357],{"type":49,"value":1358},"Check for conflicting parameters",{"type":43,"tag":78,"props":1360,"children":1361},{},[1362],{"type":49,"value":1363},"Validate against provider naming requirements",{"type":43,"tag":528,"props":1365,"children":1367},{"id":1366},"_6-polling-and-waiting",[1368],{"type":49,"value":1369},"6. Polling and Waiting",{"type":43,"tag":59,"props":1371,"children":1372},{},[1373],{"type":49,"value":1374},"For operations that require waiting for completion:",{"type":43,"tag":305,"props":1376,"children":1378},{"className":357,"code":1377,"language":359,"meta":313,"style":313},"result, err := wait.WaitForStatus(ctx,\n func(ctx context.Context) (wait.FetchResult[*ResourceType], error) {\n \u002F\u002F Fetch current status\n resource, err := findResource(ctx, conn, id)\n if err != nil {\n return wait.FetchResult[*ResourceType]{}, err\n }\n return wait.FetchResult[*ResourceType]{\n Status: wait.Status(resource.Status),\n Value: resource,\n }, nil\n },\n wait.Options[*ResourceType]{\n Timeout: timeout,\n Interval: wait.FixedInterval(5 * time.Second),\n SuccessStates: []wait.Status{\"AVAILABLE\", \"COMPLETED\"},\n TransitionalStates: []wait.Status{\"CREATING\", \"PENDING\"},\n ProgressInterval: 30 * time.Second,\n ProgressSink: func(fr wait.FetchResult[any], meta wait.ProgressMeta) {\n resp.SendProgress(action.InvokeProgressEvent{\n Message: fmt.Sprintf(\"Status: %s, Elapsed: %v\", fr.Status, meta.Elapsed.Round(time.Second)),\n })\n },\n },\n)\n",[1379],{"type":43,"tag":124,"props":1380,"children":1381},{"__ignoreMap":313},[1382,1390,1398,1406,1414,1422,1430,1438,1446,1454,1462,1470,1478,1486,1494,1502,1510,1518,1526,1535,1544,1553,1562,1570,1578],{"type":43,"tag":365,"props":1383,"children":1384},{"class":367,"line":368},[1385],{"type":43,"tag":365,"props":1386,"children":1387},{},[1388],{"type":49,"value":1389},"result, err := wait.WaitForStatus(ctx,\n",{"type":43,"tag":365,"props":1391,"children":1392},{"class":367,"line":377},[1393],{"type":43,"tag":365,"props":1394,"children":1395},{},[1396],{"type":49,"value":1397}," func(ctx context.Context) (wait.FetchResult[*ResourceType], error) {\n",{"type":43,"tag":365,"props":1399,"children":1400},{"class":367,"line":386},[1401],{"type":43,"tag":365,"props":1402,"children":1403},{},[1404],{"type":49,"value":1405}," \u002F\u002F Fetch current status\n",{"type":43,"tag":365,"props":1407,"children":1408},{"class":367,"line":395},[1409],{"type":43,"tag":365,"props":1410,"children":1411},{},[1412],{"type":49,"value":1413}," resource, err := findResource(ctx, conn, id)\n",{"type":43,"tag":365,"props":1415,"children":1416},{"class":367,"line":404},[1417],{"type":43,"tag":365,"props":1418,"children":1419},{},[1420],{"type":49,"value":1421}," if err != nil {\n",{"type":43,"tag":365,"props":1423,"children":1424},{"class":367,"line":413},[1425],{"type":43,"tag":365,"props":1426,"children":1427},{},[1428],{"type":49,"value":1429}," return wait.FetchResult[*ResourceType]{}, err\n",{"type":43,"tag":365,"props":1431,"children":1432},{"class":367,"line":422},[1433],{"type":43,"tag":365,"props":1434,"children":1435},{},[1436],{"type":49,"value":1437}," }\n",{"type":43,"tag":365,"props":1439,"children":1440},{"class":367,"line":431},[1441],{"type":43,"tag":365,"props":1442,"children":1443},{},[1444],{"type":49,"value":1445}," return wait.FetchResult[*ResourceType]{\n",{"type":43,"tag":365,"props":1447,"children":1448},{"class":367,"line":440},[1449],{"type":43,"tag":365,"props":1450,"children":1451},{},[1452],{"type":49,"value":1453}," Status: wait.Status(resource.Status),\n",{"type":43,"tag":365,"props":1455,"children":1456},{"class":367,"line":449},[1457],{"type":43,"tag":365,"props":1458,"children":1459},{},[1460],{"type":49,"value":1461}," Value: resource,\n",{"type":43,"tag":365,"props":1463,"children":1464},{"class":367,"line":458},[1465],{"type":43,"tag":365,"props":1466,"children":1467},{},[1468],{"type":49,"value":1469}," }, nil\n",{"type":43,"tag":365,"props":1471,"children":1472},{"class":367,"line":467},[1473],{"type":43,"tag":365,"props":1474,"children":1475},{},[1476],{"type":49,"value":1477}," },\n",{"type":43,"tag":365,"props":1479,"children":1480},{"class":367,"line":476},[1481],{"type":43,"tag":365,"props":1482,"children":1483},{},[1484],{"type":49,"value":1485}," wait.Options[*ResourceType]{\n",{"type":43,"tag":365,"props":1487,"children":1488},{"class":367,"line":485},[1489],{"type":43,"tag":365,"props":1490,"children":1491},{},[1492],{"type":49,"value":1493}," Timeout: timeout,\n",{"type":43,"tag":365,"props":1495,"children":1496},{"class":367,"line":494},[1497],{"type":43,"tag":365,"props":1498,"children":1499},{},[1500],{"type":49,"value":1501}," Interval: wait.FixedInterval(5 * time.Second),\n",{"type":43,"tag":365,"props":1503,"children":1504},{"class":367,"line":502},[1505],{"type":43,"tag":365,"props":1506,"children":1507},{},[1508],{"type":49,"value":1509}," SuccessStates: []wait.Status{\"AVAILABLE\", \"COMPLETED\"},\n",{"type":43,"tag":365,"props":1511,"children":1512},{"class":367,"line":511},[1513],{"type":43,"tag":365,"props":1514,"children":1515},{},[1516],{"type":49,"value":1517}," TransitionalStates: []wait.Status{\"CREATING\", \"PENDING\"},\n",{"type":43,"tag":365,"props":1519,"children":1520},{"class":367,"line":520},[1521],{"type":43,"tag":365,"props":1522,"children":1523},{},[1524],{"type":49,"value":1525}," ProgressInterval: 30 * time.Second,\n",{"type":43,"tag":365,"props":1527,"children":1529},{"class":367,"line":1528},19,[1530],{"type":43,"tag":365,"props":1531,"children":1532},{},[1533],{"type":49,"value":1534}," ProgressSink: func(fr wait.FetchResult[any], meta wait.ProgressMeta) {\n",{"type":43,"tag":365,"props":1536,"children":1538},{"class":367,"line":1537},20,[1539],{"type":43,"tag":365,"props":1540,"children":1541},{},[1542],{"type":49,"value":1543}," resp.SendProgress(action.InvokeProgressEvent{\n",{"type":43,"tag":365,"props":1545,"children":1547},{"class":367,"line":1546},21,[1548],{"type":43,"tag":365,"props":1549,"children":1550},{},[1551],{"type":49,"value":1552}," Message: fmt.Sprintf(\"Status: %s, Elapsed: %v\", fr.Status, meta.Elapsed.Round(time.Second)),\n",{"type":43,"tag":365,"props":1554,"children":1556},{"class":367,"line":1555},22,[1557],{"type":43,"tag":365,"props":1558,"children":1559},{},[1560],{"type":49,"value":1561}," })\n",{"type":43,"tag":365,"props":1563,"children":1565},{"class":367,"line":1564},23,[1566],{"type":43,"tag":365,"props":1567,"children":1568},{},[1569],{"type":49,"value":508},{"type":43,"tag":365,"props":1571,"children":1573},{"class":367,"line":1572},24,[1574],{"type":43,"tag":365,"props":1575,"children":1576},{},[1577],{"type":49,"value":1477},{"type":43,"tag":365,"props":1579,"children":1581},{"class":367,"line":1580},25,[1582],{"type":43,"tag":365,"props":1583,"children":1584},{},[1585],{"type":49,"value":1299},{"type":43,"tag":52,"props":1587,"children":1589},{"id":1588},"common-action-patterns",[1590],{"type":49,"value":1591},"Common Action Patterns",{"type":43,"tag":528,"props":1593,"children":1595},{"id":1594},"batch-operations",[1596],{"type":49,"value":1597},"Batch Operations",{"type":43,"tag":74,"props":1599,"children":1600},{},[1601,1606,1611,1616],{"type":43,"tag":78,"props":1602,"children":1603},{},[1604],{"type":49,"value":1605},"Process items in configurable batches",{"type":43,"tag":78,"props":1607,"children":1608},{},[1609],{"type":49,"value":1610},"Report progress per batch",{"type":43,"tag":78,"props":1612,"children":1613},{},[1614],{"type":49,"value":1615},"Handle partial failures gracefully",{"type":43,"tag":78,"props":1617,"children":1618},{},[1619],{"type":49,"value":1620},"Support prefix\u002Ffilter parameters",{"type":43,"tag":528,"props":1622,"children":1624},{"id":1623},"command-execution",[1625],{"type":49,"value":1626},"Command Execution",{"type":43,"tag":74,"props":1628,"children":1629},{},[1630,1635,1640,1645,1650],{"type":43,"tag":78,"props":1631,"children":1632},{},[1633],{"type":49,"value":1634},"Submit command and get operation ID",{"type":43,"tag":78,"props":1636,"children":1637},{},[1638],{"type":49,"value":1639},"Poll for completion status",{"type":43,"tag":78,"props":1641,"children":1642},{},[1643],{"type":49,"value":1644},"Retrieve and report output",{"type":43,"tag":78,"props":1646,"children":1647},{},[1648],{"type":49,"value":1649},"Handle timeout during polling",{"type":43,"tag":78,"props":1651,"children":1652},{},[1653],{"type":49,"value":1654},"Validate resources exist before execution",{"type":43,"tag":528,"props":1656,"children":1658},{"id":1657},"service-invocation",[1659],{"type":49,"value":1660},"Service Invocation",{"type":43,"tag":74,"props":1662,"children":1663},{},[1664,1669,1674,1679],{"type":43,"tag":78,"props":1665,"children":1666},{},[1667],{"type":49,"value":1668},"Invoke service with parameters",{"type":43,"tag":78,"props":1670,"children":1671},{},[1672],{"type":49,"value":1673},"Wait for completion (if synchronous)",{"type":43,"tag":78,"props":1675,"children":1676},{},[1677],{"type":49,"value":1678},"Return output\u002Fresults",{"type":43,"tag":78,"props":1680,"children":1681},{},[1682],{"type":49,"value":1683},"Handle service-specific errors",{"type":43,"tag":528,"props":1685,"children":1687},{"id":1686},"resource-state-changes",[1688],{"type":49,"value":1689},"Resource State Changes",{"type":43,"tag":74,"props":1691,"children":1692},{},[1693,1698,1703,1708],{"type":43,"tag":78,"props":1694,"children":1695},{},[1696],{"type":49,"value":1697},"Validate current state",{"type":43,"tag":78,"props":1699,"children":1700},{},[1701],{"type":49,"value":1702},"Apply state change",{"type":43,"tag":78,"props":1704,"children":1705},{},[1706],{"type":49,"value":1707},"Poll for target state",{"type":43,"tag":78,"props":1709,"children":1710},{},[1711],{"type":49,"value":1712},"Handle transitional states",{"type":43,"tag":528,"props":1714,"children":1716},{"id":1715},"async-job-submission",[1717],{"type":49,"value":1718},"Async Job Submission",{"type":43,"tag":74,"props":1720,"children":1721},{},[1722,1727,1732,1737],{"type":43,"tag":78,"props":1723,"children":1724},{},[1725],{"type":49,"value":1726},"Submit job with configuration",{"type":43,"tag":78,"props":1728,"children":1729},{},[1730],{"type":49,"value":1731},"Get job ID",{"type":43,"tag":78,"props":1733,"children":1734},{},[1735],{"type":49,"value":1736},"Optionally wait for completion",{"type":43,"tag":78,"props":1738,"children":1739},{},[1740],{"type":49,"value":1741},"Report job status",{"type":43,"tag":52,"props":1743,"children":1745},{"id":1744},"action-triggers",[1746],{"type":49,"value":1747},"Action Triggers",{"type":43,"tag":59,"props":1749,"children":1750},{},[1751,1753,1759,1761,1767],{"type":49,"value":1752},"Actions are invoked via ",{"type":43,"tag":124,"props":1754,"children":1756},{"className":1755},[],[1757],{"type":49,"value":1758},"action_trigger",{"type":49,"value":1760}," lifecycle blocks in Terraform configurations. A standalone ",{"type":43,"tag":124,"props":1762,"children":1764},{"className":1763},[],[1765],{"type":49,"value":1766},"action",{"type":49,"value":1768}," block without a corresponding trigger is declared but never executed.",{"type":43,"tag":528,"props":1770,"children":1772},{"id":1771},"hcl-syntax",[1773],{"type":49,"value":1774},"HCL Syntax",{"type":43,"tag":59,"props":1776,"children":1777},{},[1778,1780,1786,1788,1794,1796,1802],{"type":49,"value":1779},"Action parameters must be wrapped in a ",{"type":43,"tag":124,"props":1781,"children":1783},{"className":1782},[],[1784],{"type":49,"value":1785},"config {}",{"type":49,"value":1787}," block. Trigger references use the ",{"type":43,"tag":124,"props":1789,"children":1791},{"className":1790},[],[1792],{"type":49,"value":1793},"action.",{"type":49,"value":1795}," prefix, and ",{"type":43,"tag":124,"props":1797,"children":1799},{"className":1798},[],[1800],{"type":49,"value":1801},"actions",{"type":49,"value":1803}," is a list. Events are bare identifiers, not quoted strings.",{"type":43,"tag":305,"props":1805,"children":1809},{"className":1806,"code":1807,"language":1808,"meta":313,"style":313},"language-hcl shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","action \"provider_service_action\" \"name\" {\n config {\n parameter = value\n }\n}\n\nresource \"terraform_data\" \"trigger\" {\n lifecycle {\n action_trigger {\n events = [after_create]\n actions = [action.provider_service_action.name]\n }\n }\n}\n","hcl",[1810],{"type":43,"tag":124,"props":1811,"children":1812},{"__ignoreMap":313},[1813,1821,1829,1837,1845,1852,1859,1867,1875,1883,1891,1899,1906,1913],{"type":43,"tag":365,"props":1814,"children":1815},{"class":367,"line":368},[1816],{"type":43,"tag":365,"props":1817,"children":1818},{},[1819],{"type":49,"value":1820},"action \"provider_service_action\" \"name\" {\n",{"type":43,"tag":365,"props":1822,"children":1823},{"class":367,"line":377},[1824],{"type":43,"tag":365,"props":1825,"children":1826},{},[1827],{"type":49,"value":1828}," config {\n",{"type":43,"tag":365,"props":1830,"children":1831},{"class":367,"line":386},[1832],{"type":43,"tag":365,"props":1833,"children":1834},{},[1835],{"type":49,"value":1836}," parameter = value\n",{"type":43,"tag":365,"props":1838,"children":1839},{"class":367,"line":395},[1840],{"type":43,"tag":365,"props":1841,"children":1842},{},[1843],{"type":49,"value":1844}," }\n",{"type":43,"tag":365,"props":1846,"children":1847},{"class":367,"line":404},[1848],{"type":43,"tag":365,"props":1849,"children":1850},{},[1851],{"type":49,"value":526},{"type":43,"tag":365,"props":1853,"children":1854},{"class":367,"line":413},[1855],{"type":43,"tag":365,"props":1856,"children":1857},{"emptyLinePlaceholder":654},[1858],{"type":49,"value":657},{"type":43,"tag":365,"props":1860,"children":1861},{"class":367,"line":422},[1862],{"type":43,"tag":365,"props":1863,"children":1864},{},[1865],{"type":49,"value":1866},"resource \"terraform_data\" \"trigger\" {\n",{"type":43,"tag":365,"props":1868,"children":1869},{"class":367,"line":431},[1870],{"type":43,"tag":365,"props":1871,"children":1872},{},[1873],{"type":49,"value":1874}," lifecycle {\n",{"type":43,"tag":365,"props":1876,"children":1877},{"class":367,"line":440},[1878],{"type":43,"tag":365,"props":1879,"children":1880},{},[1881],{"type":49,"value":1882}," action_trigger {\n",{"type":43,"tag":365,"props":1884,"children":1885},{"class":367,"line":449},[1886],{"type":43,"tag":365,"props":1887,"children":1888},{},[1889],{"type":49,"value":1890}," events = [after_create]\n",{"type":43,"tag":365,"props":1892,"children":1893},{"class":367,"line":458},[1894],{"type":43,"tag":365,"props":1895,"children":1896},{},[1897],{"type":49,"value":1898}," actions = [action.provider_service_action.name]\n",{"type":43,"tag":365,"props":1900,"children":1901},{"class":367,"line":467},[1902],{"type":43,"tag":365,"props":1903,"children":1904},{},[1905],{"type":49,"value":517},{"type":43,"tag":365,"props":1907,"children":1908},{"class":367,"line":476},[1909],{"type":43,"tag":365,"props":1910,"children":1911},{},[1912],{"type":49,"value":1844},{"type":43,"tag":365,"props":1914,"children":1915},{"class":367,"line":485},[1916],{"type":43,"tag":365,"props":1917,"children":1918},{},[1919],{"type":49,"value":526},{"type":43,"tag":528,"props":1921,"children":1923},{"id":1922},"available-trigger-events",[1924],{"type":49,"value":1925},"Available Trigger Events",{"type":43,"tag":59,"props":1927,"children":1928},{},[1929],{"type":43,"tag":68,"props":1930,"children":1931},{},[1932],{"type":49,"value":1933},"Terraform 1.14.0 Supported Events:",{"type":43,"tag":74,"props":1935,"children":1936},{},[1937,1948,1959,1970],{"type":43,"tag":78,"props":1938,"children":1939},{},[1940,1946],{"type":43,"tag":124,"props":1941,"children":1943},{"className":1942},[],[1944],{"type":49,"value":1945},"before_create",{"type":49,"value":1947}," - Before resource creation",{"type":43,"tag":78,"props":1949,"children":1950},{},[1951,1957],{"type":43,"tag":124,"props":1952,"children":1954},{"className":1953},[],[1955],{"type":49,"value":1956},"after_create",{"type":49,"value":1958}," - After resource creation",{"type":43,"tag":78,"props":1960,"children":1961},{},[1962,1968],{"type":43,"tag":124,"props":1963,"children":1965},{"className":1964},[],[1966],{"type":49,"value":1967},"before_update",{"type":49,"value":1969}," - Before resource update",{"type":43,"tag":78,"props":1971,"children":1972},{},[1973,1979],{"type":43,"tag":124,"props":1974,"children":1976},{"className":1975},[],[1977],{"type":49,"value":1978},"after_update",{"type":49,"value":1980}," - After resource update",{"type":43,"tag":59,"props":1982,"children":1983},{},[1984],{"type":43,"tag":68,"props":1985,"children":1986},{},[1987],{"type":49,"value":1988},"Not Supported in Terraform 1.14.0:",{"type":43,"tag":74,"props":1990,"children":1991},{},[1992,2003],{"type":43,"tag":78,"props":1993,"children":1994},{},[1995,2001],{"type":43,"tag":124,"props":1996,"children":1998},{"className":1997},[],[1999],{"type":49,"value":2000},"before_destroy",{"type":49,"value":2002}," - Not available (will cause validation error)",{"type":43,"tag":78,"props":2004,"children":2005},{},[2006,2012],{"type":43,"tag":124,"props":2007,"children":2009},{"className":2008},[],[2010],{"type":49,"value":2011},"after_destroy",{"type":49,"value":2002},{"type":43,"tag":52,"props":2014,"children":2016},{"id":2015},"testing-actions",[2017],{"type":49,"value":2018},"Testing Actions",{"type":43,"tag":528,"props":2020,"children":2022},{"id":2021},"acceptance-tests",[2023],{"type":49,"value":2024},"Acceptance Tests",{"type":43,"tag":74,"props":2026,"children":2027},{},[2028,2033,2038,2043,2048,2053,2058],{"type":43,"tag":78,"props":2029,"children":2030},{},[2031],{"type":49,"value":2032},"Test action invocation with valid parameters",{"type":43,"tag":78,"props":2034,"children":2035},{},[2036],{"type":49,"value":2037},"Test timeout scenarios",{"type":43,"tag":78,"props":2039,"children":2040},{},[2041],{"type":49,"value":2042},"Test error conditions",{"type":43,"tag":78,"props":2044,"children":2045},{},[2046],{"type":49,"value":2047},"Verify provider state changes",{"type":43,"tag":78,"props":2049,"children":2050},{},[2051],{"type":49,"value":2052},"Test progress reporting",{"type":43,"tag":78,"props":2054,"children":2055},{},[2056],{"type":49,"value":2057},"Test with custom parameters",{"type":43,"tag":78,"props":2059,"children":2060},{},[2061],{"type":49,"value":2062},"Test trigger-based invocation",{"type":43,"tag":528,"props":2064,"children":2066},{"id":2065},"test-pattern",[2067],{"type":49,"value":2068},"Test Pattern",{"type":43,"tag":305,"props":2070,"children":2072},{"className":357,"code":2071,"language":359,"meta":313,"style":313},"func TestAccServiceAction_basic(t *testing.T) {\n ctx := acctest.Context(t)\n\n resource.ParallelTest(t, resource.TestCase{\n PreCheck: func() { acctest.PreCheck(ctx, t) },\n ProtoV5ProviderFactories: acctest.ProtoV5ProviderFactories,\n TerraformVersionChecks: []tfversion.TerraformVersionCheck{\n tfversion.SkipBelow(tfversion.Version1_14_0),\n },\n Steps: []resource.TestStep{\n {\n Config: testAccActionConfig_basic(),\n Check: resource.ComposeTestCheckFunc(\n testAccCheckResourceExists(ctx, \"provider_resource.test\"),\n ),\n },\n },\n })\n}\n",[2073],{"type":43,"tag":124,"props":2074,"children":2075},{"__ignoreMap":313},[2076,2084,2092,2099,2107,2115,2123,2131,2139,2146,2154,2162,2170,2178,2186,2194,2201,2208,2216],{"type":43,"tag":365,"props":2077,"children":2078},{"class":367,"line":368},[2079],{"type":43,"tag":365,"props":2080,"children":2081},{},[2082],{"type":49,"value":2083},"func TestAccServiceAction_basic(t *testing.T) {\n",{"type":43,"tag":365,"props":2085,"children":2086},{"class":367,"line":377},[2087],{"type":43,"tag":365,"props":2088,"children":2089},{},[2090],{"type":49,"value":2091}," ctx := acctest.Context(t)\n",{"type":43,"tag":365,"props":2093,"children":2094},{"class":367,"line":386},[2095],{"type":43,"tag":365,"props":2096,"children":2097},{"emptyLinePlaceholder":654},[2098],{"type":49,"value":657},{"type":43,"tag":365,"props":2100,"children":2101},{"class":367,"line":395},[2102],{"type":43,"tag":365,"props":2103,"children":2104},{},[2105],{"type":49,"value":2106}," resource.ParallelTest(t, resource.TestCase{\n",{"type":43,"tag":365,"props":2108,"children":2109},{"class":367,"line":404},[2110],{"type":43,"tag":365,"props":2111,"children":2112},{},[2113],{"type":49,"value":2114}," PreCheck: func() { acctest.PreCheck(ctx, t) },\n",{"type":43,"tag":365,"props":2116,"children":2117},{"class":367,"line":413},[2118],{"type":43,"tag":365,"props":2119,"children":2120},{},[2121],{"type":49,"value":2122}," ProtoV5ProviderFactories: acctest.ProtoV5ProviderFactories,\n",{"type":43,"tag":365,"props":2124,"children":2125},{"class":367,"line":422},[2126],{"type":43,"tag":365,"props":2127,"children":2128},{},[2129],{"type":49,"value":2130}," TerraformVersionChecks: []tfversion.TerraformVersionCheck{\n",{"type":43,"tag":365,"props":2132,"children":2133},{"class":367,"line":431},[2134],{"type":43,"tag":365,"props":2135,"children":2136},{},[2137],{"type":49,"value":2138}," tfversion.SkipBelow(tfversion.Version1_14_0),\n",{"type":43,"tag":365,"props":2140,"children":2141},{"class":367,"line":440},[2142],{"type":43,"tag":365,"props":2143,"children":2144},{},[2145],{"type":49,"value":508},{"type":43,"tag":365,"props":2147,"children":2148},{"class":367,"line":449},[2149],{"type":43,"tag":365,"props":2150,"children":2151},{},[2152],{"type":49,"value":2153}," Steps: []resource.TestStep{\n",{"type":43,"tag":365,"props":2155,"children":2156},{"class":367,"line":458},[2157],{"type":43,"tag":365,"props":2158,"children":2159},{},[2160],{"type":49,"value":2161}," {\n",{"type":43,"tag":365,"props":2163,"children":2164},{"class":367,"line":467},[2165],{"type":43,"tag":365,"props":2166,"children":2167},{},[2168],{"type":49,"value":2169}," Config: testAccActionConfig_basic(),\n",{"type":43,"tag":365,"props":2171,"children":2172},{"class":367,"line":476},[2173],{"type":43,"tag":365,"props":2174,"children":2175},{},[2176],{"type":49,"value":2177}," Check: resource.ComposeTestCheckFunc(\n",{"type":43,"tag":365,"props":2179,"children":2180},{"class":367,"line":485},[2181],{"type":43,"tag":365,"props":2182,"children":2183},{},[2184],{"type":49,"value":2185}," testAccCheckResourceExists(ctx, \"provider_resource.test\"),\n",{"type":43,"tag":365,"props":2187,"children":2188},{"class":367,"line":494},[2189],{"type":43,"tag":365,"props":2190,"children":2191},{},[2192],{"type":49,"value":2193}," ),\n",{"type":43,"tag":365,"props":2195,"children":2196},{"class":367,"line":502},[2197],{"type":43,"tag":365,"props":2198,"children":2199},{},[2200],{"type":49,"value":437},{"type":43,"tag":365,"props":2202,"children":2203},{"class":367,"line":511},[2204],{"type":43,"tag":365,"props":2205,"children":2206},{},[2207],{"type":49,"value":508},{"type":43,"tag":365,"props":2209,"children":2210},{"class":367,"line":520},[2211],{"type":43,"tag":365,"props":2212,"children":2213},{},[2214],{"type":49,"value":2215}," })\n",{"type":43,"tag":365,"props":2217,"children":2218},{"class":367,"line":1528},[2219],{"type":43,"tag":365,"props":2220,"children":2221},{},[2222],{"type":49,"value":526},{"type":43,"tag":528,"props":2224,"children":2226},{"id":2225},"test-cleanup-with-sweep-functions",[2227],{"type":49,"value":2228},"Test Cleanup with Sweep Functions",{"type":43,"tag":59,"props":2230,"children":2231},{},[2232],{"type":49,"value":2233},"Add sweep functions to clean up test resources:",{"type":43,"tag":305,"props":2235,"children":2237},{"className":357,"code":2236,"language":359,"meta":313,"style":313},"func sweepResources(region string) error {\n ctx := context.Background()\n client := \u002F* get client for region *\u002F\n\n input := &service.ListInput{\n \u002F\u002F Filter for test resources\n }\n\n var sweeperErrs *multierror.Error\n\n pages := service.NewListPaginator(client, input)\n for pages.HasMorePages() {\n page, err := pages.NextPage(ctx)\n if err != nil {\n sweeperErrs = multierror.Append(sweeperErrs, err)\n continue\n }\n\n for _, item := range page.Items {\n id := item.Id\n\n \u002F\u002F Skip non-test resources\n if !strings.HasPrefix(id, \"tf-acc-test\") {\n continue\n }\n\n _, err := client.Delete(ctx, &service.DeleteInput{\n Id: id,\n })\n if err != nil {\n sweeperErrs = multierror.Append(sweeperErrs, err)\n }\n }\n }\n\n return sweeperErrs.ErrorOrNil()\n}\n",[2238],{"type":43,"tag":124,"props":2239,"children":2240},{"__ignoreMap":313},[2241,2249,2257,2265,2272,2280,2288,2295,2302,2310,2317,2325,2333,2341,2348,2356,2364,2371,2378,2386,2394,2401,2409,2417,2425,2433,2441,2450,2459,2467,2476,2485,2493,2501,2509,2517,2526],{"type":43,"tag":365,"props":2242,"children":2243},{"class":367,"line":368},[2244],{"type":43,"tag":365,"props":2245,"children":2246},{},[2247],{"type":49,"value":2248},"func sweepResources(region string) error {\n",{"type":43,"tag":365,"props":2250,"children":2251},{"class":367,"line":377},[2252],{"type":43,"tag":365,"props":2253,"children":2254},{},[2255],{"type":49,"value":2256}," ctx := context.Background()\n",{"type":43,"tag":365,"props":2258,"children":2259},{"class":367,"line":386},[2260],{"type":43,"tag":365,"props":2261,"children":2262},{},[2263],{"type":49,"value":2264}," client := \u002F* get client for region *\u002F\n",{"type":43,"tag":365,"props":2266,"children":2267},{"class":367,"line":395},[2268],{"type":43,"tag":365,"props":2269,"children":2270},{"emptyLinePlaceholder":654},[2271],{"type":49,"value":657},{"type":43,"tag":365,"props":2273,"children":2274},{"class":367,"line":404},[2275],{"type":43,"tag":365,"props":2276,"children":2277},{},[2278],{"type":49,"value":2279}," input := &service.ListInput{\n",{"type":43,"tag":365,"props":2281,"children":2282},{"class":367,"line":413},[2283],{"type":43,"tag":365,"props":2284,"children":2285},{},[2286],{"type":49,"value":2287}," \u002F\u002F Filter for test resources\n",{"type":43,"tag":365,"props":2289,"children":2290},{"class":367,"line":422},[2291],{"type":43,"tag":365,"props":2292,"children":2293},{},[2294],{"type":49,"value":517},{"type":43,"tag":365,"props":2296,"children":2297},{"class":367,"line":431},[2298],{"type":43,"tag":365,"props":2299,"children":2300},{"emptyLinePlaceholder":654},[2301],{"type":49,"value":657},{"type":43,"tag":365,"props":2303,"children":2304},{"class":367,"line":440},[2305],{"type":43,"tag":365,"props":2306,"children":2307},{},[2308],{"type":49,"value":2309}," var sweeperErrs *multierror.Error\n",{"type":43,"tag":365,"props":2311,"children":2312},{"class":367,"line":449},[2313],{"type":43,"tag":365,"props":2314,"children":2315},{"emptyLinePlaceholder":654},[2316],{"type":49,"value":657},{"type":43,"tag":365,"props":2318,"children":2319},{"class":367,"line":458},[2320],{"type":43,"tag":365,"props":2321,"children":2322},{},[2323],{"type":49,"value":2324}," pages := service.NewListPaginator(client, input)\n",{"type":43,"tag":365,"props":2326,"children":2327},{"class":367,"line":467},[2328],{"type":43,"tag":365,"props":2329,"children":2330},{},[2331],{"type":49,"value":2332}," for pages.HasMorePages() {\n",{"type":43,"tag":365,"props":2334,"children":2335},{"class":367,"line":476},[2336],{"type":43,"tag":365,"props":2337,"children":2338},{},[2339],{"type":49,"value":2340}," page, err := pages.NextPage(ctx)\n",{"type":43,"tag":365,"props":2342,"children":2343},{"class":367,"line":485},[2344],{"type":43,"tag":365,"props":2345,"children":2346},{},[2347],{"type":49,"value":1421},{"type":43,"tag":365,"props":2349,"children":2350},{"class":367,"line":494},[2351],{"type":43,"tag":365,"props":2352,"children":2353},{},[2354],{"type":49,"value":2355}," sweeperErrs = multierror.Append(sweeperErrs, err)\n",{"type":43,"tag":365,"props":2357,"children":2358},{"class":367,"line":502},[2359],{"type":43,"tag":365,"props":2360,"children":2361},{},[2362],{"type":49,"value":2363}," continue\n",{"type":43,"tag":365,"props":2365,"children":2366},{"class":367,"line":511},[2367],{"type":43,"tag":365,"props":2368,"children":2369},{},[2370],{"type":49,"value":1437},{"type":43,"tag":365,"props":2372,"children":2373},{"class":367,"line":520},[2374],{"type":43,"tag":365,"props":2375,"children":2376},{"emptyLinePlaceholder":654},[2377],{"type":49,"value":657},{"type":43,"tag":365,"props":2379,"children":2380},{"class":367,"line":1528},[2381],{"type":43,"tag":365,"props":2382,"children":2383},{},[2384],{"type":49,"value":2385}," for _, item := range page.Items {\n",{"type":43,"tag":365,"props":2387,"children":2388},{"class":367,"line":1537},[2389],{"type":43,"tag":365,"props":2390,"children":2391},{},[2392],{"type":49,"value":2393}," id := item.Id\n",{"type":43,"tag":365,"props":2395,"children":2396},{"class":367,"line":1546},[2397],{"type":43,"tag":365,"props":2398,"children":2399},{"emptyLinePlaceholder":654},[2400],{"type":49,"value":657},{"type":43,"tag":365,"props":2402,"children":2403},{"class":367,"line":1555},[2404],{"type":43,"tag":365,"props":2405,"children":2406},{},[2407],{"type":49,"value":2408}," \u002F\u002F Skip non-test resources\n",{"type":43,"tag":365,"props":2410,"children":2411},{"class":367,"line":1564},[2412],{"type":43,"tag":365,"props":2413,"children":2414},{},[2415],{"type":49,"value":2416}," if !strings.HasPrefix(id, \"tf-acc-test\") {\n",{"type":43,"tag":365,"props":2418,"children":2419},{"class":367,"line":1572},[2420],{"type":43,"tag":365,"props":2421,"children":2422},{},[2423],{"type":49,"value":2424}," continue\n",{"type":43,"tag":365,"props":2426,"children":2427},{"class":367,"line":1580},[2428],{"type":43,"tag":365,"props":2429,"children":2430},{},[2431],{"type":49,"value":2432}," }\n",{"type":43,"tag":365,"props":2434,"children":2436},{"class":367,"line":2435},26,[2437],{"type":43,"tag":365,"props":2438,"children":2439},{"emptyLinePlaceholder":654},[2440],{"type":49,"value":657},{"type":43,"tag":365,"props":2442,"children":2444},{"class":367,"line":2443},27,[2445],{"type":43,"tag":365,"props":2446,"children":2447},{},[2448],{"type":49,"value":2449}," _, err := client.Delete(ctx, &service.DeleteInput{\n",{"type":43,"tag":365,"props":2451,"children":2453},{"class":367,"line":2452},28,[2454],{"type":43,"tag":365,"props":2455,"children":2456},{},[2457],{"type":49,"value":2458}," Id: id,\n",{"type":43,"tag":365,"props":2460,"children":2462},{"class":367,"line":2461},29,[2463],{"type":43,"tag":365,"props":2464,"children":2465},{},[2466],{"type":49,"value":1561},{"type":43,"tag":365,"props":2468,"children":2470},{"class":367,"line":2469},30,[2471],{"type":43,"tag":365,"props":2472,"children":2473},{},[2474],{"type":49,"value":2475}," if err != nil {\n",{"type":43,"tag":365,"props":2477,"children":2479},{"class":367,"line":2478},31,[2480],{"type":43,"tag":365,"props":2481,"children":2482},{},[2483],{"type":49,"value":2484}," sweeperErrs = multierror.Append(sweeperErrs, err)\n",{"type":43,"tag":365,"props":2486,"children":2488},{"class":367,"line":2487},32,[2489],{"type":43,"tag":365,"props":2490,"children":2491},{},[2492],{"type":49,"value":2432},{"type":43,"tag":365,"props":2494,"children":2496},{"class":367,"line":2495},33,[2497],{"type":43,"tag":365,"props":2498,"children":2499},{},[2500],{"type":49,"value":1437},{"type":43,"tag":365,"props":2502,"children":2504},{"class":367,"line":2503},34,[2505],{"type":43,"tag":365,"props":2506,"children":2507},{},[2508],{"type":49,"value":517},{"type":43,"tag":365,"props":2510,"children":2512},{"class":367,"line":2511},35,[2513],{"type":43,"tag":365,"props":2514,"children":2515},{"emptyLinePlaceholder":654},[2516],{"type":49,"value":657},{"type":43,"tag":365,"props":2518,"children":2520},{"class":367,"line":2519},36,[2521],{"type":43,"tag":365,"props":2522,"children":2523},{},[2524],{"type":49,"value":2525}," return sweeperErrs.ErrorOrNil()\n",{"type":43,"tag":365,"props":2527,"children":2529},{"class":367,"line":2528},37,[2530],{"type":43,"tag":365,"props":2531,"children":2532},{},[2533],{"type":49,"value":526},{"type":43,"tag":528,"props":2535,"children":2537},{"id":2536},"using-terraform_data-as-a-no-op-trigger",[2538,2539,2545],{"type":49,"value":562},{"type":43,"tag":124,"props":2540,"children":2542},{"className":2541},[],[2543],{"type":49,"value":2544},"terraform_data",{"type":49,"value":2546}," as a No-Op Trigger",{"type":43,"tag":59,"props":2548,"children":2549},{},[2550,2555],{"type":43,"tag":124,"props":2551,"children":2553},{"className":2552},[],[2554],{"type":49,"value":2544},{"type":49,"value":2556}," can serve as a no-op trigger resource for action tests that don't need real infrastructure. This is valuable for error-case and validation tests:",{"type":43,"tag":305,"props":2558,"children":2560},{"className":1806,"code":2559,"language":1808,"meta":313,"style":313},"resource \"terraform_data\" \"trigger\" {\n lifecycle {\n action_trigger {\n events = [after_create]\n actions = [action.provider_service_action.test]\n }\n }\n}\n\naction \"provider_service_action\" \"test\" {\n config {\n param = \"invalid-value\"\n }\n}\n",[2561],{"type":43,"tag":124,"props":2562,"children":2563},{"__ignoreMap":313},[2564,2571,2578,2585,2592,2600,2607,2614,2621,2628,2636,2643,2651,2658],{"type":43,"tag":365,"props":2565,"children":2566},{"class":367,"line":368},[2567],{"type":43,"tag":365,"props":2568,"children":2569},{},[2570],{"type":49,"value":1866},{"type":43,"tag":365,"props":2572,"children":2573},{"class":367,"line":377},[2574],{"type":43,"tag":365,"props":2575,"children":2576},{},[2577],{"type":49,"value":1874},{"type":43,"tag":365,"props":2579,"children":2580},{"class":367,"line":386},[2581],{"type":43,"tag":365,"props":2582,"children":2583},{},[2584],{"type":49,"value":1882},{"type":43,"tag":365,"props":2586,"children":2587},{"class":367,"line":395},[2588],{"type":43,"tag":365,"props":2589,"children":2590},{},[2591],{"type":49,"value":1890},{"type":43,"tag":365,"props":2593,"children":2594},{"class":367,"line":404},[2595],{"type":43,"tag":365,"props":2596,"children":2597},{},[2598],{"type":49,"value":2599}," actions = [action.provider_service_action.test]\n",{"type":43,"tag":365,"props":2601,"children":2602},{"class":367,"line":413},[2603],{"type":43,"tag":365,"props":2604,"children":2605},{},[2606],{"type":49,"value":517},{"type":43,"tag":365,"props":2608,"children":2609},{"class":367,"line":422},[2610],{"type":43,"tag":365,"props":2611,"children":2612},{},[2613],{"type":49,"value":1844},{"type":43,"tag":365,"props":2615,"children":2616},{"class":367,"line":431},[2617],{"type":43,"tag":365,"props":2618,"children":2619},{},[2620],{"type":49,"value":526},{"type":43,"tag":365,"props":2622,"children":2623},{"class":367,"line":440},[2624],{"type":43,"tag":365,"props":2625,"children":2626},{"emptyLinePlaceholder":654},[2627],{"type":49,"value":657},{"type":43,"tag":365,"props":2629,"children":2630},{"class":367,"line":449},[2631],{"type":43,"tag":365,"props":2632,"children":2633},{},[2634],{"type":49,"value":2635},"action \"provider_service_action\" \"test\" {\n",{"type":43,"tag":365,"props":2637,"children":2638},{"class":367,"line":458},[2639],{"type":43,"tag":365,"props":2640,"children":2641},{},[2642],{"type":49,"value":1828},{"type":43,"tag":365,"props":2644,"children":2645},{"class":367,"line":467},[2646],{"type":43,"tag":365,"props":2647,"children":2648},{},[2649],{"type":49,"value":2650}," param = \"invalid-value\"\n",{"type":43,"tag":365,"props":2652,"children":2653},{"class":367,"line":476},[2654],{"type":43,"tag":365,"props":2655,"children":2656},{},[2657],{"type":49,"value":1844},{"type":43,"tag":365,"props":2659,"children":2660},{"class":367,"line":485},[2661],{"type":43,"tag":365,"props":2662,"children":2663},{},[2664],{"type":49,"value":526},{"type":43,"tag":528,"props":2666,"children":2668},{"id":2667},"using-postapplyfunc-to-verify-side-effects",[2669,2670,2676],{"type":49,"value":562},{"type":43,"tag":124,"props":2671,"children":2673},{"className":2672},[],[2674],{"type":49,"value":2675},"PostApplyFunc",{"type":49,"value":2677}," to Verify Side Effects",{"type":43,"tag":59,"props":2679,"children":2680},{},[2681,2683,2689,2691,2696,2698,2704],{"type":49,"value":2682},"Actions don't produce state that can be checked with ",{"type":43,"tag":124,"props":2684,"children":2686},{"className":2685},[],[2687],{"type":49,"value":2688},"resource.TestCheckResourceAttr",{"type":49,"value":2690},". Use ",{"type":43,"tag":124,"props":2692,"children":2694},{"className":2693},[],[2695],{"type":49,"value":2675},{"type":49,"value":2697}," on ",{"type":43,"tag":124,"props":2699,"children":2701},{"className":2700},[],[2702],{"type":49,"value":2703},"resource.TestStep",{"type":49,"value":2705}," to query the API after apply and confirm the action produced the expected side effect:",{"type":43,"tag":305,"props":2707,"children":2709},{"className":357,"code":2708,"language":359,"meta":313,"style":313},"Steps: []resource.TestStep{\n {\n Config: testConfig,\n PostApplyFunc: func() {\n \u002F\u002F query the API to verify the action's side effect occurred\n },\n },\n},\n",[2710],{"type":43,"tag":124,"props":2711,"children":2712},{"__ignoreMap":313},[2713,2721,2729,2737,2745,2753,2760,2767],{"type":43,"tag":365,"props":2714,"children":2715},{"class":367,"line":368},[2716],{"type":43,"tag":365,"props":2717,"children":2718},{},[2719],{"type":49,"value":2720},"Steps: []resource.TestStep{\n",{"type":43,"tag":365,"props":2722,"children":2723},{"class":367,"line":377},[2724],{"type":43,"tag":365,"props":2725,"children":2726},{},[2727],{"type":49,"value":2728}," {\n",{"type":43,"tag":365,"props":2730,"children":2731},{"class":367,"line":386},[2732],{"type":43,"tag":365,"props":2733,"children":2734},{},[2735],{"type":49,"value":2736}," Config: testConfig,\n",{"type":43,"tag":365,"props":2738,"children":2739},{"class":367,"line":395},[2740],{"type":43,"tag":365,"props":2741,"children":2742},{},[2743],{"type":49,"value":2744}," PostApplyFunc: func() {\n",{"type":43,"tag":365,"props":2746,"children":2747},{"class":367,"line":404},[2748],{"type":43,"tag":365,"props":2749,"children":2750},{},[2751],{"type":49,"value":2752}," \u002F\u002F query the API to verify the action's side effect occurred\n",{"type":43,"tag":365,"props":2754,"children":2755},{"class":367,"line":413},[2756],{"type":43,"tag":365,"props":2757,"children":2758},{},[2759],{"type":49,"value":508},{"type":43,"tag":365,"props":2761,"children":2762},{"class":367,"line":422},[2763],{"type":43,"tag":365,"props":2764,"children":2765},{},[2766],{"type":49,"value":1477},{"type":43,"tag":365,"props":2768,"children":2769},{"class":367,"line":431},[2770],{"type":43,"tag":365,"props":2771,"children":2772},{},[2773],{"type":49,"value":2774},"},\n",{"type":43,"tag":528,"props":2776,"children":2778},{"id":2777},"testing-best-practices",[2779],{"type":49,"value":2780},"Testing Best Practices",{"type":43,"tag":59,"props":2782,"children":2783},{},[2784],{"type":43,"tag":68,"props":2785,"children":2786},{},[2787],{"type":49,"value":2788},"Service-Specific Prerequisites",{"type":43,"tag":74,"props":2790,"children":2791},{},[2792,2797],{"type":43,"tag":78,"props":2793,"children":2794},{},[2795],{"type":49,"value":2796},"Always check for service-specific prerequisites that must be met before actions can succeed",{"type":43,"tag":78,"props":2798,"children":2799},{},[2800],{"type":49,"value":2801},"Document prerequisites in action documentation and test configurations",{"type":43,"tag":59,"props":2803,"children":2804},{},[2805],{"type":43,"tag":68,"props":2806,"children":2807},{},[2808],{"type":49,"value":2809},"Error Pattern Matching",{"type":43,"tag":74,"props":2811,"children":2812},{},[2813,2818],{"type":43,"tag":78,"props":2814,"children":2815},{},[2816],{"type":49,"value":2817},"Terraform wraps action errors with additional context",{"type":43,"tag":78,"props":2819,"children":2820},{},[2821,2823,2829],{"type":49,"value":2822},"Use flexible regex patterns: ",{"type":43,"tag":124,"props":2824,"children":2826},{"className":2825},[],[2827],{"type":49,"value":2828},"regexache.MustCompile(\\",{"type":49,"value":2830},"(?s)Error Title.*key phrase`)`",{"type":43,"tag":59,"props":2832,"children":2833},{},[2834],{"type":43,"tag":68,"props":2835,"children":2836},{},[2837],{"type":49,"value":2838},"Test Patterns Not Applicable to Actions",{"type":43,"tag":112,"props":2840,"children":2841},{},[2842,2847],{"type":43,"tag":78,"props":2843,"children":2844},{},[2845],{"type":49,"value":2846},"Actions trigger on lifecycle events, not config reapplication",{"type":43,"tag":78,"props":2848,"children":2849},{},[2850],{"type":49,"value":2851},"Before\u002FAfter Destroy Tests: Not supported in Terraform 1.14.0",{"type":43,"tag":528,"props":2853,"children":2855},{"id":2854},"running-tests",[2856],{"type":49,"value":2857},"Running Tests",{"type":43,"tag":59,"props":2859,"children":2860},{},[2861],{"type":49,"value":2862},"Compile test to check for errors:",{"type":43,"tag":305,"props":2864,"children":2868},{"className":2865,"code":2866,"language":2867,"meta":313,"style":313},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","go test -c -o \u002Fdev\u002Fnull .\u002Finternal\u002Fservice\u002F\u003Cservice>\n","bash",[2869],{"type":43,"tag":124,"props":2870,"children":2871},{"__ignoreMap":313},[2872],{"type":43,"tag":365,"props":2873,"children":2874},{"class":367,"line":368},[2875,2880,2886,2891,2896,2901,2906,2912,2917,2923],{"type":43,"tag":365,"props":2876,"children":2878},{"style":2877},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[2879],{"type":49,"value":359},{"type":43,"tag":365,"props":2881,"children":2883},{"style":2882},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[2884],{"type":49,"value":2885}," test",{"type":43,"tag":365,"props":2887,"children":2888},{"style":2882},[2889],{"type":49,"value":2890}," -c",{"type":43,"tag":365,"props":2892,"children":2893},{"style":2882},[2894],{"type":49,"value":2895}," -o",{"type":43,"tag":365,"props":2897,"children":2898},{"style":2882},[2899],{"type":49,"value":2900}," \u002Fdev\u002Fnull",{"type":43,"tag":365,"props":2902,"children":2903},{"style":2882},[2904],{"type":49,"value":2905}," .\u002Finternal\u002Fservice\u002F",{"type":43,"tag":365,"props":2907,"children":2909},{"style":2908},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[2910],{"type":49,"value":2911},"\u003C",{"type":43,"tag":365,"props":2913,"children":2914},{"style":2882},[2915],{"type":49,"value":2916},"servic",{"type":43,"tag":365,"props":2918,"children":2920},{"style":2919},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[2921],{"type":49,"value":2922},"e",{"type":43,"tag":365,"props":2924,"children":2925},{"style":2908},[2926],{"type":49,"value":2927},">\n",{"type":43,"tag":59,"props":2929,"children":2930},{},[2931],{"type":49,"value":2932},"Run specific action tests:",{"type":43,"tag":305,"props":2934,"children":2936},{"className":2865,"code":2935,"language":2867,"meta":313,"style":313},"TF_ACC=1 go test .\u002Finternal\u002Fservice\u002F\u003Cservice> -run TestAccServiceAction_ -v\n",[2937],{"type":43,"tag":124,"props":2938,"children":2939},{"__ignoreMap":313},[2940],{"type":43,"tag":365,"props":2941,"children":2942},{"class":367,"line":368},[2943,2948,2953,2958,2963,2967,2971,2975,2979,2983,2988,2993,2998],{"type":43,"tag":365,"props":2944,"children":2945},{"style":2919},[2946],{"type":49,"value":2947},"TF_ACC",{"type":43,"tag":365,"props":2949,"children":2950},{"style":2908},[2951],{"type":49,"value":2952},"=",{"type":43,"tag":365,"props":2954,"children":2955},{"style":2882},[2956],{"type":49,"value":2957},"1",{"type":43,"tag":365,"props":2959,"children":2960},{"style":2877},[2961],{"type":49,"value":2962}," go",{"type":43,"tag":365,"props":2964,"children":2965},{"style":2882},[2966],{"type":49,"value":2885},{"type":43,"tag":365,"props":2968,"children":2969},{"style":2882},[2970],{"type":49,"value":2905},{"type":43,"tag":365,"props":2972,"children":2973},{"style":2908},[2974],{"type":49,"value":2911},{"type":43,"tag":365,"props":2976,"children":2977},{"style":2882},[2978],{"type":49,"value":2916},{"type":43,"tag":365,"props":2980,"children":2981},{"style":2919},[2982],{"type":49,"value":2922},{"type":43,"tag":365,"props":2984,"children":2985},{"style":2908},[2986],{"type":49,"value":2987},">",{"type":43,"tag":365,"props":2989,"children":2990},{"style":2882},[2991],{"type":49,"value":2992}," -run",{"type":43,"tag":365,"props":2994,"children":2995},{"style":2882},[2996],{"type":49,"value":2997}," TestAccServiceAction_",{"type":43,"tag":365,"props":2999,"children":3000},{"style":2882},[3001],{"type":49,"value":3002}," -v\n",{"type":43,"tag":59,"props":3004,"children":3005},{},[3006],{"type":49,"value":3007},"Run sweep to clean up test resources:",{"type":43,"tag":305,"props":3009,"children":3011},{"className":2865,"code":3010,"language":2867,"meta":313,"style":313},"TF_ACC=1 go test .\u002Finternal\u002Fservice\u002F\u003Cservice> -sweep=\u003Cregion> -v\n",[3012],{"type":43,"tag":124,"props":3013,"children":3014},{"__ignoreMap":313},[3015],{"type":43,"tag":365,"props":3016,"children":3017},{"class":367,"line":368},[3018,3022,3026,3030,3034,3038,3042,3046,3050,3054,3058,3063,3067,3072,3076],{"type":43,"tag":365,"props":3019,"children":3020},{"style":2919},[3021],{"type":49,"value":2947},{"type":43,"tag":365,"props":3023,"children":3024},{"style":2908},[3025],{"type":49,"value":2952},{"type":43,"tag":365,"props":3027,"children":3028},{"style":2882},[3029],{"type":49,"value":2957},{"type":43,"tag":365,"props":3031,"children":3032},{"style":2877},[3033],{"type":49,"value":2962},{"type":43,"tag":365,"props":3035,"children":3036},{"style":2882},[3037],{"type":49,"value":2885},{"type":43,"tag":365,"props":3039,"children":3040},{"style":2882},[3041],{"type":49,"value":2905},{"type":43,"tag":365,"props":3043,"children":3044},{"style":2908},[3045],{"type":49,"value":2911},{"type":43,"tag":365,"props":3047,"children":3048},{"style":2882},[3049],{"type":49,"value":2916},{"type":43,"tag":365,"props":3051,"children":3052},{"style":2919},[3053],{"type":49,"value":2922},{"type":43,"tag":365,"props":3055,"children":3056},{"style":2908},[3057],{"type":49,"value":2987},{"type":43,"tag":365,"props":3059,"children":3060},{"style":2882},[3061],{"type":49,"value":3062}," -sweep=",{"type":43,"tag":365,"props":3064,"children":3065},{"style":2908},[3066],{"type":49,"value":2911},{"type":43,"tag":365,"props":3068,"children":3069},{"style":2882},[3070],{"type":49,"value":3071},"region",{"type":43,"tag":365,"props":3073,"children":3074},{"style":2908},[3075],{"type":49,"value":2987},{"type":43,"tag":365,"props":3077,"children":3078},{"style":2882},[3079],{"type":49,"value":3002},{"type":43,"tag":52,"props":3081,"children":3083},{"id":3082},"documentation-standards",[3084],{"type":49,"value":3085},"Documentation Standards",{"type":43,"tag":59,"props":3087,"children":3088},{},[3089],{"type":49,"value":3090},"Each action documentation file must include:",{"type":43,"tag":112,"props":3092,"children":3093},{},[3094,3237,3263,3299,3325],{"type":43,"tag":78,"props":3095,"children":3096},{},[3097,3102],{"type":43,"tag":68,"props":3098,"children":3099},{},[3100],{"type":49,"value":3101},"Front Matter",{"type":43,"tag":305,"props":3103,"children":3107},{"className":3104,"code":3105,"language":3106,"meta":313,"style":313},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","---\nsubcategory: \"Service Name\"\nlayout: \"provider\"\npage_title: \"Provider: provider_service_action\"\ndescription: |-\n Brief description of what the action does.\n---\n","yaml",[3108],{"type":43,"tag":124,"props":3109,"children":3110},{"__ignoreMap":313},[3111,3119,3148,3173,3198,3222,3230],{"type":43,"tag":365,"props":3112,"children":3113},{"class":367,"line":368},[3114],{"type":43,"tag":365,"props":3115,"children":3116},{"style":2877},[3117],{"type":49,"value":3118},"---\n",{"type":43,"tag":365,"props":3120,"children":3121},{"class":367,"line":377},[3122,3128,3133,3138,3143],{"type":43,"tag":365,"props":3123,"children":3125},{"style":3124},"--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178",[3126],{"type":49,"value":3127},"subcategory",{"type":43,"tag":365,"props":3129,"children":3130},{"style":2908},[3131],{"type":49,"value":3132},":",{"type":43,"tag":365,"props":3134,"children":3135},{"style":2908},[3136],{"type":49,"value":3137}," \"",{"type":43,"tag":365,"props":3139,"children":3140},{"style":2882},[3141],{"type":49,"value":3142},"Service Name",{"type":43,"tag":365,"props":3144,"children":3145},{"style":2908},[3146],{"type":49,"value":3147},"\"\n",{"type":43,"tag":365,"props":3149,"children":3150},{"class":367,"line":386},[3151,3156,3160,3164,3169],{"type":43,"tag":365,"props":3152,"children":3153},{"style":3124},[3154],{"type":49,"value":3155},"layout",{"type":43,"tag":365,"props":3157,"children":3158},{"style":2908},[3159],{"type":49,"value":3132},{"type":43,"tag":365,"props":3161,"children":3162},{"style":2908},[3163],{"type":49,"value":3137},{"type":43,"tag":365,"props":3165,"children":3166},{"style":2882},[3167],{"type":49,"value":3168},"provider",{"type":43,"tag":365,"props":3170,"children":3171},{"style":2908},[3172],{"type":49,"value":3147},{"type":43,"tag":365,"props":3174,"children":3175},{"class":367,"line":395},[3176,3181,3185,3189,3194],{"type":43,"tag":365,"props":3177,"children":3178},{"style":3124},[3179],{"type":49,"value":3180},"page_title",{"type":43,"tag":365,"props":3182,"children":3183},{"style":2908},[3184],{"type":49,"value":3132},{"type":43,"tag":365,"props":3186,"children":3187},{"style":2908},[3188],{"type":49,"value":3137},{"type":43,"tag":365,"props":3190,"children":3191},{"style":2882},[3192],{"type":49,"value":3193},"Provider: provider_service_action",{"type":43,"tag":365,"props":3195,"children":3196},{"style":2908},[3197],{"type":49,"value":3147},{"type":43,"tag":365,"props":3199,"children":3200},{"class":367,"line":404},[3201,3206,3210,3216],{"type":43,"tag":365,"props":3202,"children":3203},{"style":3124},[3204],{"type":49,"value":3205},"description",{"type":43,"tag":365,"props":3207,"children":3208},{"style":2908},[3209],{"type":49,"value":3132},{"type":43,"tag":365,"props":3211,"children":3213},{"style":3212},"--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic",[3214],{"type":49,"value":3215}," |",{"type":43,"tag":365,"props":3217,"children":3219},{"style":3218},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[3220],{"type":49,"value":3221},"-\n",{"type":43,"tag":365,"props":3223,"children":3224},{"class":367,"line":413},[3225],{"type":43,"tag":365,"props":3226,"children":3227},{"style":2882},[3228],{"type":49,"value":3229}," Brief description of what the action does.\n",{"type":43,"tag":365,"props":3231,"children":3232},{"class":367,"line":422},[3233],{"type":43,"tag":365,"props":3234,"children":3235},{"style":2877},[3236],{"type":49,"value":3118},{"type":43,"tag":78,"props":3238,"children":3239},{},[3240,3245],{"type":43,"tag":68,"props":3241,"children":3242},{},[3243],{"type":49,"value":3244},"Header with Warnings",{"type":43,"tag":74,"props":3246,"children":3247},{},[3248,3253,3258],{"type":43,"tag":78,"props":3249,"children":3250},{},[3251],{"type":49,"value":3252},"Beta\u002FAlpha notice about experimental status",{"type":43,"tag":78,"props":3254,"children":3255},{},[3256],{"type":49,"value":3257},"Warning about potential unintended consequences",{"type":43,"tag":78,"props":3259,"children":3260},{},[3261],{"type":49,"value":3262},"Link to provider documentation",{"type":43,"tag":78,"props":3264,"children":3265},{},[3266,3271],{"type":43,"tag":68,"props":3267,"children":3268},{},[3269],{"type":49,"value":3270},"Example Usage",{"type":43,"tag":74,"props":3272,"children":3273},{},[3274,3279,3284,3294],{"type":43,"tag":78,"props":3275,"children":3276},{},[3277],{"type":49,"value":3278},"Basic usage example",{"type":43,"tag":78,"props":3280,"children":3281},{},[3282],{"type":49,"value":3283},"Advanced usage with all options",{"type":43,"tag":78,"props":3285,"children":3286},{},[3287,3289],{"type":49,"value":3288},"Trigger-based example with ",{"type":43,"tag":124,"props":3290,"children":3292},{"className":3291},[],[3293],{"type":49,"value":2544},{"type":43,"tag":78,"props":3295,"children":3296},{},[3297],{"type":49,"value":3298},"Real-world use case examples",{"type":43,"tag":78,"props":3300,"children":3301},{},[3302,3307],{"type":43,"tag":68,"props":3303,"children":3304},{},[3305],{"type":49,"value":3306},"Argument Reference",{"type":43,"tag":74,"props":3308,"children":3309},{},[3310,3315,3320],{"type":43,"tag":78,"props":3311,"children":3312},{},[3313],{"type":49,"value":3314},"List all required and optional arguments",{"type":43,"tag":78,"props":3316,"children":3317},{},[3318],{"type":49,"value":3319},"Include descriptions and defaults",{"type":43,"tag":78,"props":3321,"children":3322},{},[3323],{"type":49,"value":3324},"Note any validation rules",{"type":43,"tag":78,"props":3326,"children":3327},{},[3328,3333],{"type":43,"tag":68,"props":3329,"children":3330},{},[3331],{"type":49,"value":3332},"Documentation Linting",{"type":43,"tag":74,"props":3334,"children":3335},{},[3336,3349],{"type":43,"tag":78,"props":3337,"children":3338},{},[3339,3341,3347],{"type":49,"value":3340},"Run ",{"type":43,"tag":124,"props":3342,"children":3344},{"className":3343},[],[3345],{"type":49,"value":3346},"terrafmt fmt",{"type":49,"value":3348}," before submission",{"type":43,"tag":78,"props":3350,"children":3351},{},[3352,3354],{"type":49,"value":3353},"Verify with ",{"type":43,"tag":124,"props":3355,"children":3357},{"className":3356},[],[3358],{"type":49,"value":3359},"terrafmt diff",{"type":43,"tag":52,"props":3361,"children":3363},{"id":3362},"changelog-entry-format",[3364],{"type":49,"value":3365},"Changelog Entry Format",{"type":43,"tag":59,"props":3367,"children":3368},{},[3369,3371,3377],{"type":49,"value":3370},"Create a changelog entry in ",{"type":43,"tag":124,"props":3372,"children":3374},{"className":3373},[],[3375],{"type":49,"value":3376},".changelog\u002F",{"type":49,"value":3378}," directory:",{"type":43,"tag":305,"props":3380,"children":3383},{"className":3381,"code":3382,"language":49},[308],".changelog\u002F\u003Cpr_number_or_description>.txt\n",[3384],{"type":43,"tag":124,"props":3385,"children":3386},{"__ignoreMap":313},[3387],{"type":49,"value":3382},{"type":43,"tag":59,"props":3389,"children":3390},{},[3391],{"type":49,"value":3392},"Content format:",{"type":43,"tag":305,"props":3394,"children":3398},{"className":3395,"code":3396,"language":3397,"meta":313,"style":313},"language-release-note:new-action shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","action\u002Fprovider_service_action: Brief description of the action\n","release-note:new-action",[3399],{"type":43,"tag":124,"props":3400,"children":3401},{"__ignoreMap":313},[3402],{"type":43,"tag":365,"props":3403,"children":3404},{"class":367,"line":368},[3405],{"type":43,"tag":365,"props":3406,"children":3407},{},[3408],{"type":49,"value":3396},{"type":43,"tag":52,"props":3410,"children":3412},{"id":3411},"pre-submission-checklist",[3413],{"type":49,"value":3414},"Pre-Submission Checklist",{"type":43,"tag":59,"props":3416,"children":3417},{},[3418],{"type":49,"value":3419},"Before submitting your action implementation:",{"type":43,"tag":74,"props":3421,"children":3423},{"className":3422},[834],[3424,3439,3454,3469,3484,3493,3502,3511,3520,3529,3538],{"type":43,"tag":78,"props":3425,"children":3427},{"className":3426},[839],[3428,3431,3433],{"type":43,"tag":842,"props":3429,"children":3430},{"disabled":654,"type":844},[],{"type":49,"value":3432}," Code compiles: ",{"type":43,"tag":124,"props":3434,"children":3436},{"className":3435},[],[3437],{"type":49,"value":3438},"go build -o \u002Fdev\u002Fnull .",{"type":43,"tag":78,"props":3440,"children":3442},{"className":3441},[839],[3443,3446,3448],{"type":43,"tag":842,"props":3444,"children":3445},{"disabled":654,"type":844},[],{"type":49,"value":3447}," Tests compile: ",{"type":43,"tag":124,"props":3449,"children":3451},{"className":3450},[],[3452],{"type":49,"value":3453},"go test -c -o \u002Fdev\u002Fnull .\u002Finternal\u002Fservice\u002F\u003Cservice>",{"type":43,"tag":78,"props":3455,"children":3457},{"className":3456},[839],[3458,3461,3463],{"type":43,"tag":842,"props":3459,"children":3460},{"disabled":654,"type":844},[],{"type":49,"value":3462}," Code formatted: ",{"type":43,"tag":124,"props":3464,"children":3466},{"className":3465},[],[3467],{"type":49,"value":3468},"make fmt",{"type":43,"tag":78,"props":3470,"children":3472},{"className":3471},[839],[3473,3476,3478],{"type":43,"tag":842,"props":3474,"children":3475},{"disabled":654,"type":844},[],{"type":49,"value":3477}," Documentation formatted: ",{"type":43,"tag":124,"props":3479,"children":3481},{"className":3480},[],[3482],{"type":49,"value":3483},"terrafmt fmt website\u002Fdocs\u002Factions\u002F\u003Caction>.html.markdown",{"type":43,"tag":78,"props":3485,"children":3487},{"className":3486},[839],[3488,3491],{"type":43,"tag":842,"props":3489,"children":3490},{"disabled":654,"type":844},[],{"type":49,"value":3492}," Changelog entry created",{"type":43,"tag":78,"props":3494,"children":3496},{"className":3495},[839],[3497,3500],{"type":43,"tag":842,"props":3498,"children":3499},{"disabled":654,"type":844},[],{"type":49,"value":3501}," Schema uses correct types",{"type":43,"tag":78,"props":3503,"children":3505},{"className":3504},[839],[3506,3509],{"type":43,"tag":842,"props":3507,"children":3508},{"disabled":654,"type":844},[],{"type":49,"value":3510}," All List\u002FMap attributes have ElementType",{"type":43,"tag":78,"props":3512,"children":3514},{"className":3513},[839],[3515,3518],{"type":43,"tag":842,"props":3516,"children":3517},{"disabled":654,"type":844},[],{"type":49,"value":3519}," Progress updates implemented for long operations",{"type":43,"tag":78,"props":3521,"children":3523},{"className":3522},[839],[3524,3527],{"type":43,"tag":842,"props":3525,"children":3526},{"disabled":654,"type":844},[],{"type":49,"value":3528}," Error messages include context and resource identifiers",{"type":43,"tag":78,"props":3530,"children":3532},{"className":3531},[839],[3533,3536],{"type":43,"tag":842,"props":3534,"children":3535},{"disabled":654,"type":844},[],{"type":49,"value":3537}," Documentation includes multiple examples",{"type":43,"tag":78,"props":3539,"children":3541},{"className":3540},[839],[3542,3545],{"type":43,"tag":842,"props":3543,"children":3544},{"disabled":654,"type":844},[],{"type":49,"value":3546}," Documentation includes prerequisites and warnings",{"type":43,"tag":52,"props":3548,"children":3550},{"id":3549},"references",[3551],{"type":49,"value":3552},"References",{"type":43,"tag":74,"props":3554,"children":3555},{},[3556,3565,3575,3585,3595,3605],{"type":43,"tag":78,"props":3557,"children":3558},{},[3559],{"type":43,"tag":82,"props":3560,"children":3562},{"href":84,"rel":3561},[86],[3563],{"type":49,"value":3564},"Terraform Plugin Framework Documentation",{"type":43,"tag":78,"props":3566,"children":3567},{},[3568],{"type":43,"tag":82,"props":3569,"children":3572},{"href":3570,"rel":3571},"https:\u002F\u002Fdeveloper.hashicorp.com\u002Fterraform\u002Fplugin",[86],[3573],{"type":49,"value":3574},"Terraform Provider Development",{"type":43,"tag":78,"props":3576,"children":3577},{},[3578],{"type":43,"tag":82,"props":3579,"children":3582},{"href":3580,"rel":3581},"https:\u002F\u002Fgithub.com\u002Fhashicorp\u002Fterraform-plugin-framework",[86],[3583],{"type":49,"value":3584},"terraform-plugin-framework GitHub",{"type":43,"tag":78,"props":3586,"children":3587},{},[3588],{"type":43,"tag":82,"props":3589,"children":3592},{"href":3590,"rel":3591},"https:\u002F\u002Fgithub.com\u002Fhashicorp\u002Fterraform-plugin-testing",[86],[3593],{"type":49,"value":3594},"terraform-plugin-testing",{"type":43,"tag":78,"props":3596,"children":3597},{},[3598],{"type":43,"tag":82,"props":3599,"children":3602},{"href":3600,"rel":3601},"https:\u002F\u002Fdanielmschmidt.de\u002Fposts\u002F2025-09-26-writing-a-terraform-action\u002F",[86],[3603],{"type":49,"value":3604},"Writing a Terraform Action (blog)",{"type":43,"tag":78,"props":3606,"children":3607},{},[3608,3610,3616,3618,3624,3625,3631,3633,3639,3640,3646],{"type":49,"value":3609},"Reference implementations: ",{"type":43,"tag":124,"props":3611,"children":3613},{"className":3612},[],[3614],{"type":49,"value":3615},"terraform-provider-tfe",{"type":49,"value":3617}," (",{"type":43,"tag":124,"props":3619,"children":3621},{"className":3620},[],[3622],{"type":49,"value":3623},"action_query_run.go",{"type":49,"value":194},{"type":43,"tag":124,"props":3626,"children":3628},{"className":3627},[],[3629],{"type":49,"value":3630},"action_query_run_test.go",{"type":49,"value":3632},"), ",{"type":43,"tag":124,"props":3634,"children":3636},{"className":3635},[],[3637],{"type":49,"value":3638},"terraform-provider-vault",{"type":49,"value":3617},{"type":43,"tag":124,"props":3641,"children":3643},{"className":3642},[],[3644],{"type":49,"value":3645},"action_rotate_root.go",{"type":49,"value":3647},")",{"type":43,"tag":3649,"props":3650,"children":3651},"style",{},[3652],{"type":49,"value":3653},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":3655,"total":520},[3656,3675,3687,3700,3712,3718,3732,3742,3757,3772,3784,3795],{"slug":3657,"name":3657,"fn":3658,"description":3659,"org":3660,"tags":3661,"stars":22,"repoUrl":23,"updatedAt":3674},"aws-ami-builder","build Amazon Machine Images with Packer","Build Amazon Machine Images (AMIs) with Packer using the amazon-ebs builder. Use when creating custom AMIs for EC2 instances.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3662,3665,3668,3671],{"name":3663,"slug":3664,"type":15},"AWS","aws",{"name":3666,"slug":3667,"type":15},"Deployment","deployment",{"name":3669,"slug":3670,"type":15},"Infrastructure as Code","infrastructure-as-code",{"name":3672,"slug":3673,"type":15},"Packer","packer","2026-04-06T18:25:04.01571",{"slug":3676,"name":3676,"fn":3677,"description":3678,"org":3679,"tags":3680,"stars":22,"repoUrl":23,"updatedAt":3686},"azure-image-builder","build Azure managed images with Packer","Build Azure managed images and Azure Compute Gallery images with Packer. Use when creating custom images for Azure VMs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3681,3684,3685],{"name":3682,"slug":3683,"type":15},"Azure","azure",{"name":3666,"slug":3667,"type":15},{"name":3672,"slug":3673,"type":15},"2026-04-06T18:25:06.590174",{"slug":3688,"name":3688,"fn":3689,"description":3690,"org":3691,"tags":3692,"stars":22,"repoUrl":23,"updatedAt":3699},"azure-verified-modules","develop certified Azure Verified Modules","Azure Verified Modules (AVM) requirements and best practices for developing certified Azure Terraform modules. Use when creating or reviewing Azure modules that need AVM certification.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3693,3694,3697,3698],{"name":3682,"slug":3683,"type":15},{"name":3695,"slug":3696,"type":15},"Compliance","compliance",{"name":3669,"slug":3670,"type":15},{"name":17,"slug":18,"type":15},"2026-04-06T18:25:16.88768",{"slug":3701,"name":3701,"fn":3702,"description":3703,"org":3704,"tags":3705,"stars":22,"repoUrl":23,"updatedAt":3711},"new-terraform-provider","scaffold new Terraform providers","Use this when scaffolding a new Terraform provider.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3706,3707,3710],{"name":13,"slug":14,"type":15},{"name":3708,"slug":3709,"type":15},"Templates","templates",{"name":17,"slug":18,"type":15},"2026-04-06T18:25:11.814973",{"slug":4,"name":4,"fn":5,"description":6,"org":3713,"tags":3714,"stars":22,"repoUrl":23,"updatedAt":24},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3715,3716,3717],{"name":20,"slug":21,"type":15},{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},{"slug":3719,"name":3719,"fn":3720,"description":3721,"org":3722,"tags":3723,"stars":22,"repoUrl":23,"updatedAt":3731},"provider-docs","generate and review Terraform provider documentation","Create, update, and review Terraform provider documentation for Terraform Registry using HashiCorp-recommended patterns, tfplugindocs templates, and schema descriptions. Use when adding or changing provider configuration, resources, data sources, ephemeral resources, list resources, functions, or guides; when validating generated docs; and when troubleshooting missing or incorrect Registry documentation.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3724,3727,3730],{"name":3725,"slug":3726,"type":15},"Documentation","documentation",{"name":3728,"slug":3729,"type":15},"Technical Writing","technical-writing",{"name":17,"slug":18,"type":15},"2026-04-06T18:25:09.261559",{"slug":3733,"name":3733,"fn":3734,"description":3735,"org":3736,"tags":3737,"stars":22,"repoUrl":23,"updatedAt":3741},"provider-resources","implement Terraform Provider resources and data sources","Implement Terraform Provider resources and data sources using the Plugin Framework. Use when developing CRUD operations, schema design, state management, and acceptance testing for provider resources.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3738,3739,3740],{"name":20,"slug":21,"type":15},{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},"2026-04-06T18:25:10.56237",{"slug":3743,"name":3743,"fn":3744,"description":3745,"org":3746,"tags":3747,"stars":22,"repoUrl":23,"updatedAt":3756},"provider-test-patterns","implement Terraform provider acceptance test patterns","Terraform provider acceptance test patterns using terraform-plugin-testing with the Plugin Framework. Covers test structure, TestCase\u002FTestStep fields, ConfigStateChecks with custom statecheck.StateCheck implementations, plan checks, CompareValue for cross-step assertions, config helpers, import testing with ImportStateKind, sweepers, and scenario patterns (basic, update, disappears, validation, regression), and ephemeral resource testing with the echoprovider package. Use when writing, reviewing, or debugging provider acceptance tests, including questions about statecheck, plancheck, TestCheckFunc, CheckDestroy, ExpectError, import state verification, ephemeral resources, or how to structure test files.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3748,3749,3752,3753],{"name":13,"slug":14,"type":15},{"name":3750,"slug":3751,"type":15},"QA","qa",{"name":17,"slug":18,"type":15},{"name":3754,"slug":3755,"type":15},"Testing","testing","2026-04-06T18:25:14.352781",{"slug":3758,"name":3758,"fn":3759,"description":3760,"org":3761,"tags":3762,"stars":22,"repoUrl":23,"updatedAt":3771},"push-to-registry","push Packer build metadata to HCP registry","Push Packer build metadata to HCP Packer registry for tracking and managing image lifecycle. Use when integrating Packer builds with HCP Packer for version control and governance.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3763,3764,3767,3770],{"name":3666,"slug":3667,"type":15},{"name":3765,"slug":3766,"type":15},"Governance","governance",{"name":3768,"slug":3769,"type":15},"HCP","hcp",{"name":3672,"slug":3673,"type":15},"2026-04-06T18:25:02.749563",{"slug":3773,"name":3773,"fn":3774,"description":3775,"org":3776,"tags":3777,"stars":22,"repoUrl":23,"updatedAt":3783},"refactor-module","refactor Terraform configurations into reusable modules","Transform monolithic Terraform configurations into reusable, maintainable modules following HashiCorp's module design principles and community best practices.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3778,3781,3782],{"name":3779,"slug":3780,"type":15},"Architecture","architecture",{"name":3669,"slug":3670,"type":15},{"name":17,"slug":18,"type":15},"2026-04-06T18:25:20.953737",{"slug":3785,"name":3785,"fn":3786,"description":3787,"org":3788,"tags":3789,"stars":22,"repoUrl":23,"updatedAt":3794},"run-acceptance-tests","run acceptance tests for Terraform providers","Guide for running acceptance tests for a Terraform provider. Use this when asked to run an acceptance test or to run a test with the prefix `TestAcc`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3790,3791,3792,3793],{"name":13,"slug":14,"type":15},{"name":3750,"slug":3751,"type":15},{"name":17,"slug":18,"type":15},{"name":3754,"slug":3755,"type":15},"2026-04-06T18:25:13.098191",{"slug":3796,"name":3796,"fn":3797,"description":3798,"org":3799,"tags":3800,"stars":22,"repoUrl":23,"updatedAt":3807},"terraform-policy","write and test Terraform policy files","Write, test, or convert Terraform Policy files (.policy.hcl, .policytest.hcl, Sentinel→tfpolicy). Triggers: policy.hcl, policytest, convert sentinel, tfpolicy, write a policy.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3801,3802,3803,3806],{"name":3695,"slug":3696,"type":15},{"name":3669,"slug":3670,"type":15},{"name":3804,"slug":3805,"type":15},"Security","security",{"name":17,"slug":18,"type":15},"2026-07-18T05:48:20.299442",{"items":3809,"total":511},[3810,3817,3823,3830,3836,3842,3848],{"slug":3657,"name":3657,"fn":3658,"description":3659,"org":3811,"tags":3812,"stars":22,"repoUrl":23,"updatedAt":3674},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3813,3814,3815,3816],{"name":3663,"slug":3664,"type":15},{"name":3666,"slug":3667,"type":15},{"name":3669,"slug":3670,"type":15},{"name":3672,"slug":3673,"type":15},{"slug":3676,"name":3676,"fn":3677,"description":3678,"org":3818,"tags":3819,"stars":22,"repoUrl":23,"updatedAt":3686},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3820,3821,3822],{"name":3682,"slug":3683,"type":15},{"name":3666,"slug":3667,"type":15},{"name":3672,"slug":3673,"type":15},{"slug":3688,"name":3688,"fn":3689,"description":3690,"org":3824,"tags":3825,"stars":22,"repoUrl":23,"updatedAt":3699},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3826,3827,3828,3829],{"name":3682,"slug":3683,"type":15},{"name":3695,"slug":3696,"type":15},{"name":3669,"slug":3670,"type":15},{"name":17,"slug":18,"type":15},{"slug":3701,"name":3701,"fn":3702,"description":3703,"org":3831,"tags":3832,"stars":22,"repoUrl":23,"updatedAt":3711},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3833,3834,3835],{"name":13,"slug":14,"type":15},{"name":3708,"slug":3709,"type":15},{"name":17,"slug":18,"type":15},{"slug":4,"name":4,"fn":5,"description":6,"org":3837,"tags":3838,"stars":22,"repoUrl":23,"updatedAt":24},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3839,3840,3841],{"name":20,"slug":21,"type":15},{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},{"slug":3719,"name":3719,"fn":3720,"description":3721,"org":3843,"tags":3844,"stars":22,"repoUrl":23,"updatedAt":3731},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3845,3846,3847],{"name":3725,"slug":3726,"type":15},{"name":3728,"slug":3729,"type":15},{"name":17,"slug":18,"type":15},{"slug":3733,"name":3733,"fn":3734,"description":3735,"org":3849,"tags":3850,"stars":22,"repoUrl":23,"updatedAt":3741},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3851,3852,3853],{"name":20,"slug":21,"type":15},{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15}]