feat!: replace java_outer_classname option with use_java_stubby_libra…

…ry, add DisableServiceAccountKey and EnableServiceAccountKey, and update comments

PiperOrigin-RevId: 474647927

Source-Link: googleapis/googleapis@a0a740c

Source-Link: https://github.com/googleapis/googleapis-gen/commit/5849ad110f25eef1e08daf29bd5a81f11fb65424
Copy-Tag: eyJwIjoiamF2YS1pYW0tYWRtaW4vLk93bEJvdC55YW1sIiwiaCI6IjU4NDlhZDExMGYyNWVlZjFlMDhkYWYyOWJkNWE4MWYxMWZiNjU0MjQifQ==

owl-bot-staging/java-iam-admin/v1/google-iam-admin/src/main/java/com/google/cloud/iam/admin/v1/gapic_metadata.json

@@ -0,0 +1,111 @@
+{
+  "schema": "1.0",
+  "comment": "This file maps proto services/RPCs to the corresponding library clients/methods",
+  "language": "java",
+  "protoPackage": "google.iam.admin.v1",
+  "libraryPackage": "com.google.cloud.iam.admin.v1",
+  "services": {
+    "IAM": {
+      "clients": {
+        "grpc": {
+          "libraryClient": "IAMClient",
+          "rpcs": {
+            "CreateRole": {
+              "methods": ["createRole", "createRoleCallable"]
+            },
+            "CreateServiceAccount": {
+              "methods": ["createServiceAccount", "createServiceAccount", "createServiceAccount", "createServiceAccountCallable"]
+            },
+            "CreateServiceAccountKey": {
+              "methods": ["createServiceAccountKey", "createServiceAccountKey", "createServiceAccountKey", "createServiceAccountKeyCallable"]
+            },
+            "DeleteRole": {
+              "methods": ["deleteRole", "deleteRoleCallable"]
+            },
+            "DeleteServiceAccount": {
+              "methods": ["deleteServiceAccount", "deleteServiceAccount", "deleteServiceAccount", "deleteServiceAccountCallable"]
+            },
+            "DeleteServiceAccountKey": {
+              "methods": ["deleteServiceAccountKey", "deleteServiceAccountKey", "deleteServiceAccountKey", "deleteServiceAccountKeyCallable"]
+            },
+            "DisableServiceAccount": {
+              "methods": ["disableServiceAccount", "disableServiceAccountCallable"]
+            },
+            "DisableServiceAccountKey": {
+              "methods": ["disableServiceAccountKey", "disableServiceAccountKey", "disableServiceAccountKey", "disableServiceAccountKeyCallable"]
+            },
+            "EnableServiceAccount": {
+              "methods": ["enableServiceAccount", "enableServiceAccountCallable"]
+            },
+            "EnableServiceAccountKey": {
+              "methods": ["enableServiceAccountKey", "enableServiceAccountKey", "enableServiceAccountKey", "enableServiceAccountKeyCallable"]
+            },
+            "GetIamPolicy": {
+              "methods": ["getIamPolicy", "getIamPolicy", "getIamPolicy", "getIamPolicyCallable"]
+            },
+            "GetRole": {
+              "methods": ["getRole", "getRoleCallable"]
+            },
+            "GetServiceAccount": {
+              "methods": ["getServiceAccount", "getServiceAccount", "getServiceAccount", "getServiceAccountCallable"]
+            },
+            "GetServiceAccountKey": {
+              "methods": ["getServiceAccountKey", "getServiceAccountKey", "getServiceAccountKey", "getServiceAccountKeyCallable"]
+            },
+            "LintPolicy": {
+              "methods": ["lintPolicy", "lintPolicyCallable"]
+            },
+            "ListRoles": {
+              "methods": ["listRoles", "listRolesPagedCallable", "listRolesCallable"]
+            },
+            "ListServiceAccountKeys": {
+              "methods": ["listServiceAccountKeys", "listServiceAccountKeys", "listServiceAccountKeys", "listServiceAccountKeysCallable"]
+            },
+            "ListServiceAccounts": {
+              "methods": ["listServiceAccounts", "listServiceAccounts", "listServiceAccounts", "listServiceAccountsPagedCallable", "listServiceAccountsCallable"]
+            },
+            "PatchServiceAccount": {
+              "methods": ["patchServiceAccount", "patchServiceAccountCallable"]
+            },
+            "QueryAuditableServices": {
+              "methods": ["queryAuditableServices", "queryAuditableServicesCallable"]
+            },
+            "QueryGrantableRoles": {
+              "methods": ["queryGrantableRoles", "queryGrantableRoles", "queryGrantableRolesPagedCallable", "queryGrantableRolesCallable"]
+            },
+            "QueryTestablePermissions": {
+              "methods": ["queryTestablePermissions", "queryTestablePermissionsPagedCallable", "queryTestablePermissionsCallable"]
+            },
+            "SetIamPolicy": {
+              "methods": ["setIamPolicy", "setIamPolicy", "setIamPolicy", "setIamPolicyCallable"]
+            },
+            "SignBlob": {
+              "methods": ["signBlob", "signBlob", "signBlob", "signBlobCallable"]
+            },
+            "SignJwt": {
+              "methods": ["signJwt", "signJwt", "signJwt", "signJwtCallable"]
+            },
+            "TestIamPermissions": {
+              "methods": ["testIamPermissions", "testIamPermissions", "testIamPermissions", "testIamPermissionsCallable"]
+            },
+            "UndeleteRole": {
+              "methods": ["undeleteRole", "undeleteRoleCallable"]
+            },
+            "UndeleteServiceAccount": {
+              "methods": ["undeleteServiceAccount", "undeleteServiceAccountCallable"]
+            },
+            "UpdateRole": {
+              "methods": ["updateRole", "updateRoleCallable"]
+            },
+            "UpdateServiceAccount": {
+              "methods": ["updateServiceAccount", "updateServiceAccountCallable"]
+            },
+            "UploadServiceAccountKey": {
+              "methods": ["uploadServiceAccountKey", "uploadServiceAccountKeyCallable"]
+            }
+          }
+        }
+      }
+    }
+  }
+}

owl-bot-staging/java-iam-admin/v1/google-iam-admin/src/main/java/com/google/cloud/iam/admin/v1/package-info.java

@@ -0,0 +1,72 @@
+/*
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * A client to Identity and Access Management (IAM) API
+ *
+ * <p>The interfaces provided are listed below, along with usage samples.
+ *
+ * <p>======================= IAMClient =======================
+ *
+ * <p>Service Description: Creates and manages Identity and Access Management (IAM) resources.
+ *
+ * <p>You can use this service to work with all of the following resources:
+ *
+ * <ul>
+ *   <li>&#42;&#42;Service accounts&#42;&#42;, which identify an application or a virtual machine
+ *       (VM) instance rather than a person
+ *   <li>&#42;&#42;Service account keys&#42;&#42;, which service accounts use to authenticate with
+ *       Google APIs
+ *   <li>&#42;&#42;IAM policies for service accounts&#42;&#42;, which specify the roles that a
+ *       principal has for the service account
+ *   <li>&#42;&#42;IAM custom roles&#42;&#42;, which help you limit the number of permissions that
+ *       you grant to principals
+ * </ul>
+ *
+ * <p>In addition, you can use this service to complete the following tasks, among others:
+ *
+ * <ul>
+ *   <li>Test whether a service account can use specific permissions
+ *   <li>Check which roles you can grant for a specific resource
+ *   <li>Lint, or validate, condition expressions in an IAM policy
+ * </ul>
+ *
+ * <p>When you read data from the IAM API, each read is eventually consistent. In other words, if
+ * you write data with the IAM API, then immediately read that data, the read operation might return
+ * an older version of the data. To deal with this behavior, your application can retry the request
+ * with truncated exponential backoff.
+ *
+ * <p>In contrast, writing data to the IAM API is sequentially consistent. In other words, write
+ * operations are always processed in the order in which they were received.
+ *
+ * <p>Sample for IAMClient:
+ *
+ * <pre>{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (IAMClient iAMClient = IAMClient.create()) {
+ *   ServiceAccountName name = ServiceAccountName.of("[PROJECT]", "[SERVICE_ACCOUNT]");
+ *   ServiceAccount response = iAMClient.getServiceAccount(name);
+ * }
+ * }</pre>
+ */
+@Generated("by gapic-generator-java")
+package com.google.cloud.iam.admin.v1;
+
+import javax.annotation.Generated;

owl-bot-staging/java-iam-admin/v1/google-iam-admin/src/main/java/com/google/cloud/iam/admin/v1/stub/GrpcIAMCallableFactory.java

@@ -0,0 +1,113 @@
+/*
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.cloud.iam.admin.v1.stub;
+
+import com.google.api.gax.grpc.GrpcCallSettings;
+import com.google.api.gax.grpc.GrpcCallableFactory;
+import com.google.api.gax.grpc.GrpcStubCallableFactory;
+import com.google.api.gax.rpc.BatchingCallSettings;
+import com.google.api.gax.rpc.BidiStreamingCallable;
+import com.google.api.gax.rpc.ClientContext;
+import com.google.api.gax.rpc.ClientStreamingCallable;
+import com.google.api.gax.rpc.OperationCallSettings;
+import com.google.api.gax.rpc.OperationCallable;
+import com.google.api.gax.rpc.PagedCallSettings;
+import com.google.api.gax.rpc.ServerStreamingCallSettings;
+import com.google.api.gax.rpc.ServerStreamingCallable;
+import com.google.api.gax.rpc.StreamingCallSettings;
+import com.google.api.gax.rpc.UnaryCallSettings;
+import com.google.api.gax.rpc.UnaryCallable;
+import com.google.longrunning.Operation;
+import com.google.longrunning.stub.OperationsStub;
+import javax.annotation.Generated;
+
+// AUTO-GENERATED DOCUMENTATION AND CLASS.
+/**
+ * gRPC callable factory implementation for the IAM service API.
+ *
+ * <p>This class is for advanced usage.
+ */
+@Generated("by gapic-generator-java")
+public class GrpcIAMCallableFactory implements GrpcStubCallableFactory {
+
+  @Override
+  public <RequestT, ResponseT> UnaryCallable<RequestT, ResponseT> createUnaryCallable(
+      GrpcCallSettings<RequestT, ResponseT> grpcCallSettings,
+      UnaryCallSettings<RequestT, ResponseT> callSettings,
+      ClientContext clientContext) {
+    return GrpcCallableFactory.createUnaryCallable(grpcCallSettings, callSettings, clientContext);
+  }
+
+  @Override
+  public <RequestT, ResponseT, PagedListResponseT>
+      UnaryCallable<RequestT, PagedListResponseT> createPagedCallable(
+          GrpcCallSettings<RequestT, ResponseT> grpcCallSettings,
+          PagedCallSettings<RequestT, ResponseT, PagedListResponseT> callSettings,
+          ClientContext clientContext) {
+    return GrpcCallableFactory.createPagedCallable(grpcCallSettings, callSettings, clientContext);
+  }
+
+  @Override
+  public <RequestT, ResponseT> UnaryCallable<RequestT, ResponseT> createBatchingCallable(
+      GrpcCallSettings<RequestT, ResponseT> grpcCallSettings,
+      BatchingCallSettings<RequestT, ResponseT> callSettings,
+      ClientContext clientContext) {
+    return GrpcCallableFactory.createBatchingCallable(
+        grpcCallSettings, callSettings, clientContext);
+  }
+
+  @Override
+  public <RequestT, ResponseT, MetadataT>
+      OperationCallable<RequestT, ResponseT, MetadataT> createOperationCallable(
+          GrpcCallSettings<RequestT, Operation> grpcCallSettings,
+          OperationCallSettings<RequestT, ResponseT, MetadataT> callSettings,
+          ClientContext clientContext,
+          OperationsStub operationsStub) {
+    return GrpcCallableFactory.createOperationCallable(
+        grpcCallSettings, callSettings, clientContext, operationsStub);
+  }
+
+  @Override
+  public <RequestT, ResponseT>
+      BidiStreamingCallable<RequestT, ResponseT> createBidiStreamingCallable(
+          GrpcCallSettings<RequestT, ResponseT> grpcCallSettings,
+          StreamingCallSettings<RequestT, ResponseT> callSettings,
+          ClientContext clientContext) {
+    return GrpcCallableFactory.createBidiStreamingCallable(
+        grpcCallSettings, callSettings, clientContext);
+  }
+
+  @Override
+  public <RequestT, ResponseT>
+      ServerStreamingCallable<RequestT, ResponseT> createServerStreamingCallable(
+          GrpcCallSettings<RequestT, ResponseT> grpcCallSettings,
+          ServerStreamingCallSettings<RequestT, ResponseT> callSettings,
+          ClientContext clientContext) {
+    return GrpcCallableFactory.createServerStreamingCallable(
+        grpcCallSettings, callSettings, clientContext);
+  }
+
+  @Override
+  public <RequestT, ResponseT>
+      ClientStreamingCallable<RequestT, ResponseT> createClientStreamingCallable(
+          GrpcCallSettings<RequestT, ResponseT> grpcCallSettings,
+          StreamingCallSettings<RequestT, ResponseT> callSettings,
+          ClientContext clientContext) {
+    return GrpcCallableFactory.createClientStreamingCallable(
+        grpcCallSettings, callSettings, clientContext);
+  }
+}