Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update google_iap_brand documentation about import and name formats #12633

Conversation

modular-magician
Copy link
Collaborator

Closes #12600

PR makes the two possible import formats for the google_iap_brand resource more explicit.

I also updated the description of the name attribute as I thought it'd be good to make it clear that it can take the two forms (but I think API returns project number for Read operations). Relevant documentation : https://cloud.google.com/iap/docs/reference/rest/v1/projects.brands/get#body.PATH_PARAMETERS.name

When I generated the downstream locally I saw that a third import format is added automatically : {{project_number}}/{{brand_id}} I couldn't figure out how to stop this happening, so I implemented the ability to import with that format of ID.

I currently don't know how we'd make acceptance tests to test import with the different import formats, because we'd require knowledge of the the project number of the project made in the acceptance test.

For now, I've tested the import manually. See image below.

  1. Removing the resource from state
  2. Attempting import with the latest provider release
  3. Attempting import with developer override using a build of this PR
    • The resource in state has an id of {{project}}/{{brand_id}} but the name is set as projects/{{project}}/brands/{{brand_id}}

Screenshot 2022-09-21 at 21 02 03


If this PR is for Terraform, I acknowledge that I have:

  • Searched through the issue tracker for an open issue that this either resolves or contributes to, commented on it to claim it, and written "fixes {url}" or "part of {url}" in this PR description. If there were no relevant open issues, I opened one and commented that I would like to work on it (not necessary for very small changes).
  • Generated Terraform, and ran make test and make lint to ensure it passes unit and linter tests.
  • Ensured that all new fields I added that can be set by a user appear in at least one example (for generated resources) or third_party test (for handwritten resources or update tests). N/A
  • Ran relevant acceptance tests (If the acceptance tests do not yet pass or you are unable to run them, please let your reviewer know). N/A
  • Read the Release Notes Guide before writing my release note below.

Release Note Template for Downstream PRs (will be copied)

iap: added ability to import `google_iap_brand` using ID in {{project}}/{{brand_id}} format

Derived from GoogleCloudPlatform/magic-modules#6586

…hashicorp#6586)

* Update import format for google_iap_brand resource

* Update documentation for google_iap_brand name attribute

* Clarify description of name attr; make more clear which format the API returns.

* Implement import of `google_iap_brand` using name in 2-part format

* Update import to set 4-part id, to match unimported resources

Signed-off-by: Modular Magician <[email protected]>
@modular-magician modular-magician merged commit 1e2e52c into hashicorp:main Sep 23, 2022
@github-actions
Copy link

I'm going to lock this pull request because it has been closed for 30 days ⏳. This helps our maintainers find and focus on the active issues.
If you have found a problem that seems related to this change, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.

@github-actions github-actions bot locked as resolved and limited conversation to collaborators Oct 24, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

google_iap_brand documentation is wrong about import
1 participant