Document id field for resources

[rileykarson]

In 3.0.0, we changed Terraform's internal id field from formats like {{project}}/{{region}}/{{name}} to projects/{{project}}/regions/{{region}}/resources/{{name}}, a valid reference value.

Historically we've encouraged users to use name or self_link as the reference value, however these values should be preferred going forward. We've since documented the field on generated resources, but no examples or tests have been updated and neither have handwritten resources.

For this issue:

• Update every resource's documentation to include an id output-only attribute including the expected format (see Add docs for the id field GoogleCloudPlatform/magic-modules#3040 downstreams for samples)
• Update every example at https://github.com/GoogleCloudPlatform/magic-modules/tree/master/templates/terraform/examples to use id as the reference value if it makes sense / works
• Update every handwritten docs page following the same criteria

This should happen in small groups (~3-7 resources) so the PRs are easy to test and not overwhelming.

[danawillow]

We should also probably update our examples/tests to use it

cc @slevenick since we were talking about this for a bit earlier

[danawillow]

Riley to add more details before this goes to bug triage folks

[rileykarson]

@edwardmedia did GoogleCloudPlatform/magic-modules#3205 fix every id, or are some remaining?

[ghost]

I'm going to lock this issue because it has been closed for 30 days ⏳. This helps our maintainers find and focus on the active issues.

If you feel this issue should be reopened, we encourage creating a new issue linking back to this one for added context. If you feel I made an error 🤖 🙉 , please reach out to my human friends 👉 [email protected]. Thanks!

[edwardmedia]

The work is complete. Some examples remain unchanged as their tests are failing.

[danawillow]

@edwardmedia do you have a list of examples that this doesn't work for? It would be worth having that so we can fix the resources in question.