docs: update a few doc comments

Google APIs · copybara-github · commit 5f8a02d6b7e7 · 2024-02-29T15:05:34.000-08:00
PiperOrigin-RevId: 611608182
diff --git a/google/cloud/sql/v1/cloud_sql_instances.proto b/google/cloud/sql/v1/cloud_sql_instances.proto
@@ -1115,13 +1115,14 @@ message DatabaseInstance {
   // Name of the Cloud SQL instance. This does not include the project ID.
   string name = 23;
 
-  // The geographical region. Can be:
-  // *  `us-central` (`FIRST_GEN` instances only)
-  // *  `us-central1` (`SECOND_GEN` instances only)
-  // *  `asia-east1` or `europe-west1`.
+  // The geographical region of the Cloud SQL instance.
   //
-  // Defaults to `us-central` or `us-central1` depending on the instance
-  // type. The region cannot be changed after instance creation.
+  // It can be one of the
+  // [regions](https://cloud.google.com/sql/docs/mysql/locations#location-r)
+  // where Cloud SQL operates:
+  //
+  // For example,  `asia-east1`, `europe-west1`, and  `us-central1`.
+  // The default value is `us-central1`.
   string region = 24;
 
   // The Compute Engine zone that the instance is currently serving from. This
diff --git a/google/cloud/sql/v1/cloud_sql_resources.proto b/google/cloud/sql/v1/cloud_sql_resources.proto
@@ -540,6 +540,13 @@ message IpConfiguration {
     // client certificates.
     // When this value is used, the legacy `require_ssl` flag must be true or
     // cleared to avoid the conflict between values of two flags.
+    // PostgreSQL clients or users that connect using IAM database
+    // authentication must use either the
+    // [Cloud SQL Auth
+    // Proxy](https://cloud.google.com/sql/docs/postgres/connect-auth-proxy) or
+    // [Cloud SQL
+    // Connectors](https://cloud.google.com/sql/docs/postgres/connect-connectors)
+    // to enforce client identity verification.
     TRUSTED_CLIENT_CERTIFICATE_REQUIRED = 3;
   }
 
