data.google_certificate_manager_certificates : explain attributes (#13706) (#22418)

[upstream:316513f8286967e7c0293a33445ece63f9233f76]

Signed-off-by: Modular Magician <[email protected]>

Author: modular-magician

website/docs/d/certificate_manager_certificates.html.markdown

@@ -12,6 +12,10 @@ List all certificates within Google Certificate Manager for a given project, reg
 ```tf
 data "google_certificate_manager_certificates" "default" {
 }
+
+output "certificates_names" {
+  value = [for cert in data.google_certificate_manager_certificates.default.certificates : cert.name]
+}
 ```
 
 ## Example Usage - with a filter
@@ -20,6 +24,23 @@ data "google_certificate_manager_certificates" "default" {
 data "google_certificate_manager_certificates" "default" {
   filter = "name:projects/PROJECT_ID/locations/REGION/certificates/certificate-name-*"
 }
+
+output "certificates_names" {
+  value = [for cert in data.google_certificate_manager_certificates.default.certificates : cert.name]
+}
+```
+
+## Example Usage - regional certificates with a filter
+
+```tf
+data "google_certificate_manager_certificates" "default" {
+  region = "REGION"
+  filter = "name:projects/PROJECT_ID/locations/REGION/certificates/certificate-name-*"
+}
+
+output "certificates_names" {
+  value = [for cert in data.google_certificate_manager_certificates.default.certificates : cert.name]
+}
 ```
 
 ## Argument Reference
@@ -33,4 +54,6 @@ The following arguments are supported:
 
 ## Attributes Reference
 
-See [google_certificate_manager_certificate](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/certificate_manager_certificate) resource for details of the available attributes.
+The following attributes are exported:
+
+* `certificates` - A list of all retrieved certificates. See [google_certificate_manager_certificate](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/certificate_manager_certificate) resource for details of the available attributes.