feat: [kms] added VerifyConnectivity RPC (#4274)

* feat: added VerifyConnectivity RPC

PiperOrigin-RevId: 530991686

Source-Link: googleapis/googleapis@be2600e

Source-Link: googleapis/googleapis-gen@7eadc0e
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWttcy8uT3dsQm90LnlhbWwiLCJoIjoiN2VhZGMwZTBhYWVjZTJiY2NiNGU1NjFmM2IyOWIwNTg0ZmJjZjkwNiJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Denis DelGrosso <[email protected]>

Author: gcf-owl-bot[bot]

packages/google-cloud-kms/README.md

@@ -102,6 +102,19 @@ service EkmService {
     };
     option (google.api.method_signature) = "ekm_config,update_mask";
   }
+
+  // Verifies that Cloud KMS can successfully connect to the external key
+  // manager specified by an [EkmConnection][google.cloud.kms.v1.EkmConnection].
+  // If there is an error connecting to the EKM, this method returns a
+  // FAILED_PRECONDITION status containing structured information as described
+  // at https://cloud.google.com/kms/docs/reference/ekm_errors.
+  rpc VerifyConnectivity(VerifyConnectivityRequest)
+      returns (VerifyConnectivityResponse) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/ekmConnections/*}:verifyConnectivity"
+    };
+    option (google.api.method_signature) = "name";
+  }
 }
 
 // Request message for
@@ -419,3 +432,20 @@ message EkmConfig {
     }
   ];
 }
+
+// Request message for
+// [EkmService.VerifyConnectivity][google.cloud.kms.v1.EkmService.VerifyConnectivity].
+message VerifyConnectivityRequest {
+  // Required. The [name][google.cloud.kms.v1.EkmConnection.name] of the
+  // [EkmConnection][google.cloud.kms.v1.EkmConnection] to verify.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/EkmConnection"
+    }
+  ];
+}
+
+// Response message for
+// [EkmService.VerifyConnectivity][google.cloud.kms.v1.EkmService.VerifyConnectivity].
+message VerifyConnectivityResponse {}