docs: update the comments of various networksecurity resources

fix!: fix annotation of parent in Create*Request

PiperOrigin-RevId: 462271672

Source-Link: googleapis/googleapis@9213efa

Source-Link: https://github.com/googleapis/googleapis-gen/commit/eb69561e8c95031d2f799285ed21bc65608eee96
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZWI2OTU2MWU4Yzk1MDMxZDJmNzk5Mjg1ZWQyMWJjNjU2MDhlZWU5NiJ9

google-cloud-network-security/src/main/java/com/google/cloud/networksecurity/v1/NetworkSecurityClient.java → owl-bot-staging/v1/google-cloud-network-security/src/main/java/com/google/cloud/networksecurity/v1/NetworkSecurityClient.java

@@ -64,13 +64,13 @@
  * methods:
  *
  * <ol>
- *   <li>A "flattened" method. With this type of method, the fields of the request type have been
+ *   <li> A "flattened" method. With this type of method, the fields of the request type have been
  *       converted into function parameters. It may be the case that not all fields are available as
  *       parameters, and not every API method will have a flattened method entry point.
- *   <li>A "request object" method. This type of method only takes one parameter, a request object,
+ *   <li> A "request object" method. This type of method only takes one parameter, a request object,
  *       which must be constructed before the call. Not every API method will have a request object
  *       method.
- *   <li>A "callable" method. This type of method takes no parameters and returns an immutable API
+ *   <li> A "callable" method. This type of method takes no parameters and returns an immutable API
  *       callable object, which can be used to initiate calls to the service.
  * </ol>
  *
@@ -2261,16 +2261,12 @@ public boolean awaitTermination(long duration, TimeUnit unit) throws Interrupted
 
   public static class ListAuthorizationPoliciesPagedResponse
       extends AbstractPagedListResponse<
-          ListAuthorizationPoliciesRequest,
-          ListAuthorizationPoliciesResponse,
-          AuthorizationPolicy,
-          ListAuthorizationPoliciesPage,
-          ListAuthorizationPoliciesFixedSizeCollection> {
+          ListAuthorizationPoliciesRequest, ListAuthorizationPoliciesResponse, AuthorizationPolicy,
+          ListAuthorizationPoliciesPage, ListAuthorizationPoliciesFixedSizeCollection> {
 
     public static ApiFuture<ListAuthorizationPoliciesPagedResponse> createAsync(
         PageContext<
-                ListAuthorizationPoliciesRequest,
-                ListAuthorizationPoliciesResponse,
+                ListAuthorizationPoliciesRequest, ListAuthorizationPoliciesResponse,
                 AuthorizationPolicy>
             context,
         ApiFuture<ListAuthorizationPoliciesResponse> futureResponse) {
@@ -2289,15 +2285,12 @@ private ListAuthorizationPoliciesPagedResponse(ListAuthorizationPoliciesPage pag
 
   public static class ListAuthorizationPoliciesPage
       extends AbstractPage<
-          ListAuthorizationPoliciesRequest,
-          ListAuthorizationPoliciesResponse,
-          AuthorizationPolicy,
+          ListAuthorizationPoliciesRequest, ListAuthorizationPoliciesResponse, AuthorizationPolicy,
           ListAuthorizationPoliciesPage> {
 
     private ListAuthorizationPoliciesPage(
         PageContext<
-                ListAuthorizationPoliciesRequest,
-                ListAuthorizationPoliciesResponse,
+                ListAuthorizationPoliciesRequest, ListAuthorizationPoliciesResponse,
                 AuthorizationPolicy>
             context,
         ListAuthorizationPoliciesResponse response) {
@@ -2311,8 +2304,7 @@ private static ListAuthorizationPoliciesPage createEmptyPage() {
     @Override
     protected ListAuthorizationPoliciesPage createPage(
         PageContext<
-                ListAuthorizationPoliciesRequest,
-                ListAuthorizationPoliciesResponse,
+                ListAuthorizationPoliciesRequest, ListAuthorizationPoliciesResponse,
                 AuthorizationPolicy>
             context,
         ListAuthorizationPoliciesResponse response) {
@@ -2322,8 +2314,7 @@ protected ListAuthorizationPoliciesPage createPage(
     @Override
     public ApiFuture<ListAuthorizationPoliciesPage> createPageAsync(
         PageContext<
-                ListAuthorizationPoliciesRequest,
-                ListAuthorizationPoliciesResponse,
+                ListAuthorizationPoliciesRequest, ListAuthorizationPoliciesResponse,
                 AuthorizationPolicy>
             context,
         ApiFuture<ListAuthorizationPoliciesResponse> futureResponse) {
@@ -2333,11 +2324,8 @@ public ApiFuture<ListAuthorizationPoliciesPage> createPageAsync(
 
   public static class ListAuthorizationPoliciesFixedSizeCollection
       extends AbstractFixedSizeCollection<
-          ListAuthorizationPoliciesRequest,
-          ListAuthorizationPoliciesResponse,
-          AuthorizationPolicy,
-          ListAuthorizationPoliciesPage,
-          ListAuthorizationPoliciesFixedSizeCollection> {
+          ListAuthorizationPoliciesRequest, ListAuthorizationPoliciesResponse, AuthorizationPolicy,
+          ListAuthorizationPoliciesPage, ListAuthorizationPoliciesFixedSizeCollection> {
 
     private ListAuthorizationPoliciesFixedSizeCollection(
         List<ListAuthorizationPoliciesPage> pages, int collectionSize) {
@@ -2357,11 +2345,8 @@ protected ListAuthorizationPoliciesFixedSizeCollection createCollection(
 
   public static class ListServerTlsPoliciesPagedResponse
       extends AbstractPagedListResponse<
-          ListServerTlsPoliciesRequest,
-          ListServerTlsPoliciesResponse,
-          ServerTlsPolicy,
-          ListServerTlsPoliciesPage,
-          ListServerTlsPoliciesFixedSizeCollection> {
+          ListServerTlsPoliciesRequest, ListServerTlsPoliciesResponse, ServerTlsPolicy,
+          ListServerTlsPoliciesPage, ListServerTlsPoliciesFixedSizeCollection> {
 
     public static ApiFuture<ListServerTlsPoliciesPagedResponse> createAsync(
         PageContext<ListServerTlsPoliciesRequest, ListServerTlsPoliciesResponse, ServerTlsPolicy>
@@ -2382,9 +2367,7 @@ private ListServerTlsPoliciesPagedResponse(ListServerTlsPoliciesPage page) {
 
   public static class ListServerTlsPoliciesPage
       extends AbstractPage<
-          ListServerTlsPoliciesRequest,
-          ListServerTlsPoliciesResponse,
-          ServerTlsPolicy,
+          ListServerTlsPoliciesRequest, ListServerTlsPoliciesResponse, ServerTlsPolicy,
           ListServerTlsPoliciesPage> {
 
     private ListServerTlsPoliciesPage(
@@ -2417,11 +2400,8 @@ public ApiFuture<ListServerTlsPoliciesPage> createPageAsync(
 
   public static class ListServerTlsPoliciesFixedSizeCollection
       extends AbstractFixedSizeCollection<
-          ListServerTlsPoliciesRequest,
-          ListServerTlsPoliciesResponse,
-          ServerTlsPolicy,
-          ListServerTlsPoliciesPage,
-          ListServerTlsPoliciesFixedSizeCollection> {
+          ListServerTlsPoliciesRequest, ListServerTlsPoliciesResponse, ServerTlsPolicy,
+          ListServerTlsPoliciesPage, ListServerTlsPoliciesFixedSizeCollection> {
 
     private ListServerTlsPoliciesFixedSizeCollection(
         List<ListServerTlsPoliciesPage> pages, int collectionSize) {
@@ -2441,11 +2421,8 @@ protected ListServerTlsPoliciesFixedSizeCollection createCollection(
 
   public static class ListClientTlsPoliciesPagedResponse
       extends AbstractPagedListResponse<
-          ListClientTlsPoliciesRequest,
-          ListClientTlsPoliciesResponse,
-          ClientTlsPolicy,
-          ListClientTlsPoliciesPage,
-          ListClientTlsPoliciesFixedSizeCollection> {
+          ListClientTlsPoliciesRequest, ListClientTlsPoliciesResponse, ClientTlsPolicy,
+          ListClientTlsPoliciesPage, ListClientTlsPoliciesFixedSizeCollection> {
 
     public static ApiFuture<ListClientTlsPoliciesPagedResponse> createAsync(
         PageContext<ListClientTlsPoliciesRequest, ListClientTlsPoliciesResponse, ClientTlsPolicy>
@@ -2466,9 +2443,7 @@ private ListClientTlsPoliciesPagedResponse(ListClientTlsPoliciesPage page) {
 
   public static class ListClientTlsPoliciesPage
       extends AbstractPage<
-          ListClientTlsPoliciesRequest,
-          ListClientTlsPoliciesResponse,
-          ClientTlsPolicy,
+          ListClientTlsPoliciesRequest, ListClientTlsPoliciesResponse, ClientTlsPolicy,
           ListClientTlsPoliciesPage> {
 
     private ListClientTlsPoliciesPage(
@@ -2501,11 +2476,8 @@ public ApiFuture<ListClientTlsPoliciesPage> createPageAsync(
 
   public static class ListClientTlsPoliciesFixedSizeCollection
       extends AbstractFixedSizeCollection<
-          ListClientTlsPoliciesRequest,
-          ListClientTlsPoliciesResponse,
-          ClientTlsPolicy,
-          ListClientTlsPoliciesPage,
-          ListClientTlsPoliciesFixedSizeCollection> {
+          ListClientTlsPoliciesRequest, ListClientTlsPoliciesResponse, ClientTlsPolicy,
+          ListClientTlsPoliciesPage, ListClientTlsPoliciesFixedSizeCollection> {
 
     private ListClientTlsPoliciesFixedSizeCollection(
         List<ListClientTlsPoliciesPage> pages, int collectionSize) {

google-cloud-network-security/src/main/java/com/google/cloud/networksecurity/v1/NetworkSecuritySettings.java → owl-bot-staging/v1/google-cloud-network-security/src/main/java/com/google/cloud/networksecurity/v1/NetworkSecuritySettings.java

@@ -30,6 +30,7 @@
 import com.google.api.gax.rpc.ClientSettings;
 import com.google.api.gax.rpc.OperationCallSettings;
 import com.google.api.gax.rpc.PagedCallSettings;
+import com.google.api.gax.rpc.StubSettings;
 import com.google.api.gax.rpc.TransportChannelProvider;
 import com.google.api.gax.rpc.UnaryCallSettings;
 import com.google.cloud.networksecurity.v1.stub.NetworkSecurityStubSettings;
@@ -46,10 +47,10 @@
  * <p>The default instance has everything set to sensible defaults:
  *
  * <ul>
- *   <li>The default service address (networksecurity.googleapis.com) and default port (443) are
+ *   <li> The default service address (networksecurity.googleapis.com) and default port (443) are
  *       used.
- *   <li>Credentials are acquired automatically through Application Default Credentials.
- *   <li>Retries are configured for idempotent methods but not for non-idempotent methods.
+ *   <li> Credentials are acquired automatically through Application Default Credentials.
+ *   <li> Retries are configured for idempotent methods but not for non-idempotent methods.
  * </ul>
  *
  * <p>The builder of this class is recursive, so contained classes are themselves builders. When
@@ -79,8 +80,7 @@ public class NetworkSecuritySettings extends ClientSettings<NetworkSecuritySetti
 
   /** Returns the object with the settings used for calls to listAuthorizationPolicies. */
   public PagedCallSettings<
-          ListAuthorizationPoliciesRequest,
-          ListAuthorizationPoliciesResponse,
+          ListAuthorizationPoliciesRequest, ListAuthorizationPoliciesResponse,
           ListAuthorizationPoliciesPagedResponse>
       listAuthorizationPoliciesSettings() {
     return ((NetworkSecurityStubSettings) getStubSettings()).listAuthorizationPoliciesSettings();
@@ -135,8 +135,7 @@ public class NetworkSecuritySettings extends ClientSettings<NetworkSecuritySetti
 
   /** Returns the object with the settings used for calls to listServerTlsPolicies. */
   public PagedCallSettings<
-          ListServerTlsPoliciesRequest,
-          ListServerTlsPoliciesResponse,
+          ListServerTlsPoliciesRequest, ListServerTlsPoliciesResponse,
           ListServerTlsPoliciesPagedResponse>
       listServerTlsPoliciesSettings() {
     return ((NetworkSecurityStubSettings) getStubSettings()).listServerTlsPoliciesSettings();
@@ -189,8 +188,7 @@ public class NetworkSecuritySettings extends ClientSettings<NetworkSecuritySetti
 
   /** Returns the object with the settings used for calls to listClientTlsPolicies. */
   public PagedCallSettings<
-          ListClientTlsPoliciesRequest,
-          ListClientTlsPoliciesResponse,
+          ListClientTlsPoliciesRequest, ListClientTlsPoliciesResponse,
           ListClientTlsPoliciesPagedResponse>
       listClientTlsPoliciesSettings() {
     return ((NetworkSecurityStubSettings) getStubSettings()).listClientTlsPoliciesSettings();
@@ -340,8 +338,7 @@ public Builder applyToAllUnaryMethods(
 
     /** Returns the builder for the settings used for calls to listAuthorizationPolicies. */
     public PagedCallSettings.Builder<
-            ListAuthorizationPoliciesRequest,
-            ListAuthorizationPoliciesResponse,
+            ListAuthorizationPoliciesRequest, ListAuthorizationPoliciesResponse,
             ListAuthorizationPoliciesPagedResponse>
         listAuthorizationPoliciesSettings() {
       return getStubSettingsBuilder().listAuthorizationPoliciesSettings();
@@ -393,8 +390,7 @@ public Builder applyToAllUnaryMethods(
 
     /** Returns the builder for the settings used for calls to listServerTlsPolicies. */
     public PagedCallSettings.Builder<
-            ListServerTlsPoliciesRequest,
-            ListServerTlsPoliciesResponse,
+            ListServerTlsPoliciesRequest, ListServerTlsPoliciesResponse,
             ListServerTlsPoliciesPagedResponse>
         listServerTlsPoliciesSettings() {
       return getStubSettingsBuilder().listServerTlsPoliciesSettings();
@@ -446,8 +442,7 @@ public Builder applyToAllUnaryMethods(
 
     /** Returns the builder for the settings used for calls to listClientTlsPolicies. */
     public PagedCallSettings.Builder<
-            ListClientTlsPoliciesRequest,
-            ListClientTlsPoliciesResponse,
+            ListClientTlsPoliciesRequest, ListClientTlsPoliciesResponse,
             ListClientTlsPoliciesPagedResponse>
         listClientTlsPoliciesSettings() {
       return getStubSettingsBuilder().listClientTlsPoliciesSettings();

google-cloud-network-security/src/main/java/com/google/cloud/networksecurity/v1/stub/GrpcNetworkSecurityStub.java → owl-bot-staging/v1/google-cloud-network-security/src/main/java/com/google/cloud/networksecurity/v1/stub/GrpcNetworkSecurityStub.java

@@ -56,6 +56,7 @@
 import io.grpc.MethodDescriptor;
 import io.grpc.protobuf.ProtoUtils;
 import java.io.IOException;
+import java.util.Map;
 import java.util.concurrent.TimeUnit;
 import javax.annotation.Generated;