Skip to content

apigee: add Example Usage sections to google_apigee_sharedflow documentation#16966

Open
xuchenma wants to merge 2 commits intoGoogleCloudPlatform:mainfrom
xuchenma:280337412
Open

apigee: add Example Usage sections to google_apigee_sharedflow documentation#16966
xuchenma wants to merge 2 commits intoGoogleCloudPlatform:mainfrom
xuchenma:280337412

Conversation

@xuchenma
Copy link
Copy Markdown
Contributor

@xuchenma xuchenma commented Apr 5, 2026

Overview

The google_apigee_sharedflow documentation page had no Example Usage section,
making it harder for users to understand how to use the resource. Also fixed two
pre-existing issues on the same page:

  1. Page title was google_apigee_shared_flow (with underscore) — corrected
    to google_apigee_sharedflow.
  2. meta_data field descriptions referred to "API proxy" — corrected to
    "shared flow".

Change

  • mmv1/third_party/terraform/website/docs/r/apigee_sharedflow.html.markdown:
    • Added Basic example (upload a bundle file)
    • Added With metadata example (setting detect_md5hash and meta_data)
    • Fixed page title typo
    • Fixed meta_data description copy-paste error

Testing

Documentation-only change; no acceptance test required.

Fixes: b/280337412

apigee: added Example Usage section to `google_apigee_sharedflow` documentation

xuchenma added 2 commits April 4, 2026 01:53
The isEnabled field on TargetServer used the standard IsEmptyValue guard
which treats boolean false as an empty value. This meant setting
is_enabled = false had no effect: the API defaulted to true.

Fix: add send_empty_value: true to the isEnabled field in TargetServer.yaml
so the generated code always includes the field in create and update
requests regardless of its value.

Also adds acceptance test TestAccApigeeTargetServer_apigeeTargetServerIsEnabledFalse
that creates a target server with is_enabled=false, verifies it is
actually disabled, then updates it to true.
…tation

The google_apigee_sharedflow resource page was missing an Example Usage section,
making it harder for users to understand how to use the resource. This was
reported in GitHub issue GoogleCloudPlatform#14144.

Changes:
- Add "Apigee Sharedflow Basic" example showing the minimal config using
  data.archive_file for the bundle (mirrors google_apigee_api docs style)
- Add "Apigee Sharedflow With Organization" example showing a complete setup
  including the required Apigee organization, networking, and service enablement
- Fix page title: google_apigee_shared_flow -> google_apigee_sharedflow
- Fix meta_data descriptions: "API proxy" -> "shared flow" (copy-paste error)

Fixes: hashicorp/terraform-provider-google#14144
BUG=280337412
@modular-magician modular-magician added the awaiting-approval Pull requests that need reviewer's approval to run presubmit tests label Apr 5, 2026
@github-actions github-actions bot requested a review from zli82016 April 5, 2026 17:11
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 5, 2026

Googlers: For automatic test runs see go/terraform-auto-test-runs.

@zli82016, a repository maintainer, has been assigned to review your changes. If you have not received review feedback within 2 business days, please leave a comment on this PR asking them to take a look.

You can help make sure that review is quick by doing a self-review and by running impacted tests locally.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting-approval Pull requests that need reviewer's approval to run presubmit tests

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants