MicrosoftDocs/azure-dev-docs/articles/terraform

Add Terraform drift guidance for stateful Azure resources (#9588) * Add storage account drift best practices article * Add storage account migration drift warning * Add storage account migration drift warning * Add storage account migration drift guidance * Add storage account drift article navigation * Apply suggestion from @learn-build-service-prod-07[bot] Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-07[bot] Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-07[bot] Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-07[bot] Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-07[bot] Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-07[bot] Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com> * Revise article on preventing Terraform drift for Azure resources Updated the article to focus on preventing Terraform drift for stateful Azure resources, with an emphasis on Azure Storage account migrations. Adjusted the title, description, and content to reflect best practices and risks associated with configuration drift. * Update text for Terraform drift guidance * Revise note on Azure Storage account migration guidance Updated note regarding Azure Storage account migrations to clarify guidance on preventing unexpected recreation during migrations. * Update warning message for storage account migration * Update link text for preventing Terraform drift * Update note on Azure Storage account migrations * Update section title for Azure resource drift * Apply suggestion from @learn-build-service-prod-01[bot] Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-08[bot] Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-08[bot] Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-08[bot] Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-08[bot] Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-08[bot] Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * Update migration guidance for Azure Storage accounts * Update and rename storage-account-drift-best-practices.md to prevent-terraform-drift-stateful-resources.md * Fix URL for preventing Terraform drift * Update link for preventing Terraform drift * Fix link for preventing Terraform drift guidance Updated link in Terraform overview to point to the correct document on preventing drift. * Fix link for Terraform drift prevention guidance Updated link for preventing Terraform drift during Azure Storage account migrations. * Update link for drift prevention documentation * Update link for preventing Terraform drift * Fix link to prevent Terraform drift documentation Updated link to migration guidance for Azure resources. * Fix typo in Terraform drift guide entry * Clarify drift warning for storage account migration Updated warning message for storage account migration to clarify the handling of account replication type changes. * Fix include syntax for storage account migration warning * Fix note formatting in Terraform overview * Remove Azure storage account migration example Removed example section about Azure storage account migration. * Update documentation on prevent_destroy and ignore_changes Clarify the behavior of prevent_destroy and introduce ignore_changes for stateful resources. * Update guidance on storage account migration and Terraform state Clarify conditions under which Terraform replaces storage accounts during redundancy changes and update instructions for reconciling Terraform state after out-of-band changes. * Clarify post-migration steps for Terraform configuration Updated instructions for reconciling Terraform configuration after storage account migration. * Update troubleshooting guidance for Azure storage accounts Clarified the conditions under which Terraform may plan to delete and recreate an Azure storage account, specifying the impact of redundancy migrations on the `account_replication_type`. Updated recommendations for managing storage account migrations. * Fix markdown syntax for include directive * Update guidance on Terraform state reconciliation and locks Clarified the process for reconciling Terraform state after cross-family redundancy changes and emphasized the use of Azure resource locks for protection. * Clarify instructions for reconciling Terraform state * Apply suggestion from @learn-build-service-prod-04[bot] Co-authored-by: learn-build-service-prod-04[bot] <274428985+learn-build-service-prod-04[bot]@users.noreply.github.com> * Update migration instructions for Terraform state management Clarified steps for reconciling Terraform configuration after storage account migrations, including handling same-family and cross-family redundancy updates. * Revise storage account migration steps in troubleshoot.md Updated migration instructions for storage accounts to include running 'terraform apply -refresh-only' and confirming no unexpected changes before removing 'ignore_changes'. * Apply suggestion from @learn-build-service-prod-02[bot] Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-02[bot] Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Clarify note on Azure Storage account changes Updated note on Azure Storage account migrations to refer to conversions instead. * Fix note on Azure Storage account conversions Corrected capitalization and formatting for clarity. * Update warning for storage account conversion process * Update drift warning include in AVD storage guide * Update drift warning include for storage account * Update note on Azure Storage account changes * Clarify terminology from migration to conversion Updated references from 'migration' to 'conversion' throughout the article to clarify the context of Azure Storage account changes. * Update drift warning include in Azure storage guide * Update troubleshooting section for storage account changes * Fix grammar and clarity in testing overview Correct grammatical errors and improve clarity in the overview of testing Terraform code. * Refine language in Azure Files Terraform article Updated wording for clarity and consistency in the article. * Update instructions for creating Terraform directory * Refine language and improve clarity in comparison article Updated language for clarity and consistency throughout the article, including changes to terminology and phrasing related to infrastructure as code, cloud environments, and deployment processes. * Update storage-account-conversion-drift-warning.md * Improve clarity and conciseness in overview.md Refactor language for clarity and conciseness in the Terraform overview. * Refine Terraform Azure Storage documentation Updated wording for clarity and consistency in the documentation regarding Terraform state management in Azure Storage. * Update troubleshoot.md * Update troubleshoot.md * Update create-avd-azure-files-storage.md * Update storage account conversion drift warning metadata Added metadata properties for author, topic, date, and custom tracking. * Fix markdown syntax for Terraform abstract inclusion --------- Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-04[bot] <274428985+learn-build-service-prod-04[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com>

Confirm merge from repo_sync_working_branch to main to sync with https://github.com/MicrosoftDocs/azure-dev-docs (branch main) (#9658) * New article: Deploy and use Claude on Microsoft Foundry with Azure Developer CLI (#9262) (#9309) * Add new article * Add bash alternatives * Shorten TOC entry * Rename file due to warning * Fix the date * Apply Arun's feedback * Update articles/ai/how-to/deploy-claude-foundry.md * Update articles/ai/how-to/deploy-claude-foundry.md * Update articles/ai/how-to/deploy-claude-foundry.md * Update articles/ai/how-to/deploy-claude-foundry.md * Update articles/ai/how-to/deploy-claude-foundry.md * Update articles/ai/how-to/deploy-claude-foundry.md * Update articles/ai/how-to/deploy-claude-foundry.md * Update articles/ai/how-to/deploy-claude-foundry.md * Update articles/ai/how-to/deploy-claude-foundry.md * Update articles/ai/how-to/deploy-claude-foundry.md * Update articles/ai/how-to/deploy-claude-foundry.md * Update articles/ai/how-to/deploy-claude-foundry.md * Update articles/ai/how-to/deploy-claude-foundry.md * Update articles/ai/how-to/deploy-claude-foundry.md * Update articles/ai/how-to/deploy-claude-foundry.md * Dramatic changes based on Arun, Pamela feedback * Change title, h2 --------- Co-authored-by: Bob Tabor <bob.tabor@microsoft.com> Co-authored-by: Bob Tabor <bobtabor@outlook.com> Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> * Update AzureRM feature comparison values (#1504) * Update AzureRM feature comparison values * Update data plane management and validation details --------- Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com> Co-authored-by: Karl Erickson <1775795+KarlErickson@users.noreply.github.com> Co-authored-by: Bob Tabor <bob.tabor@microsoft.com> Co-authored-by: Bob Tabor <bobtabor@outlook.com> Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> Co-authored-by: Rebecca Calixte <v-rcalixte@microsoft.com>

Update resource-provider-overview.md (revives magodo's #7333 and #7342) (#9521) * Update resource-provider-overview.md Mention the CLI RP registration needs to wait. (cherry picked from commit 6bd9da6e10c828ef44a7d856c155ba65b7c31210) * Update resource-provider-overview.md (cherry picked from commit 0b25da0105e0d785b975eb3a9204bf6a7ffb9444) * Update resource-provider-overview.md Add one limitation about resource amount in RG. (cherry picked from commit 9f644ade556335ff6c3335309ae228cd3abba76c) * Update resource-provider-overview.md (cherry picked from commit abbeb0e81b4449ed19ea4c98f8d95acd3f078835) * docs: apply OPS build style and grammar suggestions * docs: add missing period to portal export sentence * terminology --------- Co-authored-by: magodo <wztdyl@sina.com> Co-authored-by: vranade-microsoft <269690592+vranade-microsoft@users.noreply.github.com> Co-authored-by: Diana Richards <103777760+v-dirichards@users.noreply.github.com>

updated ownership metadata (#9471) * updated ownership metadata * update to azd-zone-pivot-groups.yml ownership

update ownership metadata (#9469)

Additional fix.

Address warnings for publishing.

Fix formatting for Azure CLI and PowerShell commands

Update get-started-azapi-data-plane-resource.md

Reframe AzAPI language to emphasize direct ARM API access Remove gap-filler framing that positions AzAPI as a fallback for AzureRM. Describe AzAPI by what it does (direct ARM API access) rather than by what AzureRM lacks. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Address PR review feedback from Rebecca-Calixte - Rephrase AzAPI intro to clarify it works via ARM API and is especially useful for unsupported resources/properties/API versions - Add brief context sentence about aztfexport and aztfmigrate tools before the migration paths table - Add 'Use this when' sentences to AzAPI language features and Generate required permissions sections for consistency - Standardize TOC naming to 'Visual Studio Code extension' (not 'VS Code') Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Fix style: replace 'may' with 'might' per MS writing guidelines Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Fix review issues in AzAPI docs (PR #8906) - Fix parse_resource_id attribute: .resource_name -> .name (terraform validate failure) - Fix Key Vault data plane resource type: certificatecontacts -> certificates/contacts - Fix parent_id: add trimsuffix to strip trailing slash from vault_uri - Fix PowerShell line continuation: backslash -> backtick - Remove misleading re-apply claim in action-mutation quickstart - Remove duplicate checklist in resource-action quickstart - Remove duplicate include in resource quickstart - Remove duplicate TOC entry for data-plane-framework concept article - Rewrite parse_resource_id return fields list to match provider source Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

fixed image references

adding vscode ectension updates and fixing some acrolinx issues

fixing acrolinx comments and issues

created additional guides based on azapi updates

Merge pull request #8735 from v-thpra/tjp-fresh-appsrvc-009 Q&M Freshness - App Service - TJP009

PR review fixes

Minor edits for style guide