Skip to content

Document reserved tracking tag in caching guide - #2317

Open
yuanyouyao wants to merge 1 commit into
vmware:masterfrom
yuanyouyao:docs/cache-reserved-tag-limitation
Open

Document reserved tracking tag in caching guide#2317
yuanyouyao wants to merge 1 commit into
vmware:masterfrom
yuanyouyao:docs/cache-reserved-tag-limitation

Conversation

@yuanyouyao

Copy link
Copy Markdown
Contributor

Add an explicit warning and troubleshooting entry to the in-memory caching guide regarding the reserved 'nsx-tf/tf-run-id' tag scope.

In config_scope mode, the provider automatically injects and filters this tracking tag on NSX objects for Search API scoping, while intentionally stripping it from Terraform state upon read to prevent internal metadata from polluting user state files.

Manually specifying 'nsx-tf/tf-run-id' in HCL tag blocks creates an unresolved mismatch against the stripped state, causing persistent plan drift on subsequent runs. Explicitly document this limitation.

Add an explicit warning and troubleshooting entry to the in-memory
caching guide regarding the reserved 'nsx-tf/tf-run-id' tag scope.

In config_scope mode, the provider automatically injects and filters
this tracking tag on NSX objects for Search API scoping, while
intentionally stripping it from Terraform state upon read to prevent
internal metadata from polluting user state files.

Manually specifying 'nsx-tf/tf-run-id' in HCL tag blocks creates an
unresolved mismatch against the stripped state, causing persistent
plan drift on subsequent runs. Explicitly document this limitation.
@yuanyouyao
yuanyouyao requested a review from a team September 7, 2026 01:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant