feat: [securitycenter] Mark the Asset APIs as deprecated in client li…

…braries (#9575) - [ ] Regenerate this pull request now. PiperOrigin-RevId: 542687834 Source-Link: https://togithub.com/googleapis/googleapis/commit/a7e10550cbaaa339f081cef973c4af2fea94cdd9 Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/b1e231aa3e597eee952f3940d7743b660c6eaed5 Copy-Tag: eyJwIjoiamF2YS1zZWN1cml0eWNlbnRlci8uT3dsQm90LnlhbWwiLCJoIjoiYjFlMjMxYWEzZTU5N2VlZTk1MmYzOTQwZDc3NDNiNjYwYzZlYWVkNSJ9
googleapis · Jun 23, 2023 · 0b25cfa · 0b25cfa
1 parent 53e7f84
commit 0b25cfa
Show file tree

Hide file tree

Showing 10 changed files with 387 additions and 268 deletions.
diff --git a/java-securitycenter/README.md b/java-securitycenter/README.md
@@ -20,7 +20,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>libraries-bom</artifactId>
-      <version>26.16.0</version>
+      <version>26.17.0</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>

diff --git a/...securitycenter/src/main/java/com/google/cloud/securitycenter/v1/SecurityCenterClient.java b/...securitycenter/src/main/java/com/google/cloud/securitycenter/v1/SecurityCenterClient.java
@@ -2930,7 +2930,9 @@ public final UnaryCallable<GetSourceRequest, Source> getSourceCallable() {
    *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final GroupAssetsPagedResponse groupAssets(GroupAssetsRequest request) {
     return groupAssetsPagedCallable().call(request);
   }
@@ -2966,7 +2968,10 @@ public final GroupAssetsPagedResponse groupAssets(GroupAssetsRequest request) {
    *   }
    * }
    * }</pre>
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final UnaryCallable<GroupAssetsRequest, GroupAssetsPagedResponse>
       groupAssetsPagedCallable() {
     return stub.groupAssetsPagedCallable();
@@ -3009,7 +3014,10 @@ public final GroupAssetsPagedResponse groupAssets(GroupAssetsRequest request) {
    *   }
    * }
    * }</pre>
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final UnaryCallable<GroupAssetsRequest, GroupAssetsResponse> groupAssetsCallable() {
     return stub.groupAssetsCallable();
   }
@@ -3290,7 +3298,9 @@ public final UnaryCallable<GroupFindingsRequest, GroupFindingsResponse> groupFin
    *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final ListAssetsPagedResponse listAssets(ListAssetsRequest request) {
     return listAssetsPagedCallable().call(request);
   }
@@ -3327,7 +3337,10 @@ public final ListAssetsPagedResponse listAssets(ListAssetsRequest request) {
    *   }
    * }
    * }</pre>
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final UnaryCallable<ListAssetsRequest, ListAssetsPagedResponse> listAssetsPagedCallable() {
     return stub.listAssetsPagedCallable();
   }
@@ -3370,7 +3383,10 @@ public final UnaryCallable<ListAssetsRequest, ListAssetsPagedResponse> listAsset
    *   }
    * }
    * }</pre>
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final UnaryCallable<ListAssetsRequest, ListAssetsResponse> listAssetsCallable() {
     return stub.listAssetsCallable();
   }
@@ -4858,7 +4874,9 @@ public final UnaryCallable<ListSourcesRequest, ListSourcesResponse> listSourcesC
    * @param parent Required. Name of the organization to run asset discovery for. Its format is
    *     "organizations/[organization_id]".
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final OperationFuture<RunAssetDiscoveryResponse, Empty> runAssetDiscoveryAsync(
       OrganizationName parent) {
     RunAssetDiscoveryRequest request =
@@ -4893,7 +4911,9 @@ public final OperationFuture<RunAssetDiscoveryResponse, Empty> runAssetDiscovery
    * @param parent Required. Name of the organization to run asset discovery for. Its format is
    *     "organizations/[organization_id]".
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final OperationFuture<RunAssetDiscoveryResponse, Empty> runAssetDiscoveryAsync(
       String parent) {
     RunAssetDiscoveryRequest request =
@@ -4928,7 +4948,9 @@ public final OperationFuture<RunAssetDiscoveryResponse, Empty> runAssetDiscovery
    *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final OperationFuture<RunAssetDiscoveryResponse, Empty> runAssetDiscoveryAsync(
       RunAssetDiscoveryRequest request) {
     return runAssetDiscoveryOperationCallable().futureCall(request);
@@ -4960,7 +4982,10 @@ public final OperationFuture<RunAssetDiscoveryResponse, Empty> runAssetDiscovery
    *   RunAssetDiscoveryResponse response = future.get();
    * }
    * }</pre>
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final OperationCallable<RunAssetDiscoveryRequest, RunAssetDiscoveryResponse, Empty>
       runAssetDiscoveryOperationCallable() {
     return stub.runAssetDiscoveryOperationCallable();
@@ -4992,7 +5017,10 @@ public final OperationFuture<RunAssetDiscoveryResponse, Empty> runAssetDiscovery
    *   Operation response = future.get();
    * }
    * }</pre>
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
    */
+  @Deprecated
   public final UnaryCallable<RunAssetDiscoveryRequest, Operation> runAssetDiscoveryCallable() {
     return stub.runAssetDiscoveryCallable();
   }

diff --git a/...curitycenter/src/main/java/com/google/cloud/securitycenter/v1/SecurityCenterSettings.java b/...curitycenter/src/main/java/com/google/cloud/securitycenter/v1/SecurityCenterSettings.java
@@ -213,7 +213,12 @@ public UnaryCallSettings<GetSourceRequest, Source> getSourceSettings() {
     return ((SecurityCenterStubSettings) getStubSettings()).getSourceSettings();
   }
 
-  /** Returns the object with the settings used for calls to groupAssets. */
+  /**
+   * Returns the object with the settings used for calls to groupAssets.
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
+   */
+  @Deprecated
   public PagedCallSettings<GroupAssetsRequest, GroupAssetsResponse, GroupAssetsPagedResponse>
       groupAssetsSettings() {
     return ((SecurityCenterStubSettings) getStubSettings()).groupAssetsSettings();
@@ -225,7 +230,12 @@ public UnaryCallSettings<GetSourceRequest, Source> getSourceSettings() {
     return ((SecurityCenterStubSettings) getStubSettings()).groupFindingsSettings();
   }
 
-  /** Returns the object with the settings used for calls to listAssets. */
+  /**
+   * Returns the object with the settings used for calls to listAssets.
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
+   */
+  @Deprecated
   public PagedCallSettings<ListAssetsRequest, ListAssetsResponse, ListAssetsPagedResponse>
       listAssetsSettings() {
     return ((SecurityCenterStubSettings) getStubSettings()).listAssetsSettings();
@@ -298,12 +308,22 @@ public UnaryCallSettings<GetSourceRequest, Source> getSourceSettings() {
     return ((SecurityCenterStubSettings) getStubSettings()).listSourcesSettings();
   }
 
-  /** Returns the object with the settings used for calls to runAssetDiscovery. */
+  /**
+   * Returns the object with the settings used for calls to runAssetDiscovery.
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
+   */
+  @Deprecated
   public UnaryCallSettings<RunAssetDiscoveryRequest, Operation> runAssetDiscoverySettings() {
     return ((SecurityCenterStubSettings) getStubSettings()).runAssetDiscoverySettings();
   }
 
-  /** Returns the object with the settings used for calls to runAssetDiscovery. */
+  /**
+   * Returns the object with the settings used for calls to runAssetDiscovery.
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
+   */
+  @Deprecated
   public OperationCallSettings<RunAssetDiscoveryRequest, RunAssetDiscoveryResponse, Empty>
       runAssetDiscoveryOperationSettings() {
     return ((SecurityCenterStubSettings) getStubSettings()).runAssetDiscoveryOperationSettings();
@@ -637,7 +657,12 @@ public UnaryCallSettings.Builder<GetSourceRequest, Source> getSourceSettings() {
       return getStubSettingsBuilder().getSourceSettings();
     }
 
-    /** Returns the builder for the settings used for calls to groupAssets. */
+    /**
+     * Returns the builder for the settings used for calls to groupAssets.
+     *
+     * @deprecated This method is deprecated and will be removed in the next major version update.
+     */
+    @Deprecated
     public PagedCallSettings.Builder<
             GroupAssetsRequest, GroupAssetsResponse, GroupAssetsPagedResponse>
         groupAssetsSettings() {
@@ -651,7 +676,12 @@ public UnaryCallSettings.Builder<GetSourceRequest, Source> getSourceSettings() {
       return getStubSettingsBuilder().groupFindingsSettings();
     }
 
-    /** Returns the builder for the settings used for calls to listAssets. */
+    /**
+     * Returns the builder for the settings used for calls to listAssets.
+     *
+     * @deprecated This method is deprecated and will be removed in the next major version update.
+     */
+    @Deprecated
     public PagedCallSettings.Builder<ListAssetsRequest, ListAssetsResponse, ListAssetsPagedResponse>
         listAssetsSettings() {
       return getStubSettingsBuilder().listAssetsSettings();
@@ -723,13 +753,23 @@ public UnaryCallSettings.Builder<GetSourceRequest, Source> getSourceSettings() {
       return getStubSettingsBuilder().listSourcesSettings();
     }
 
-    /** Returns the builder for the settings used for calls to runAssetDiscovery. */
+    /**
+     * Returns the builder for the settings used for calls to runAssetDiscovery.
+     *
+     * @deprecated This method is deprecated and will be removed in the next major version update.
+     */
+    @Deprecated
     public UnaryCallSettings.Builder<RunAssetDiscoveryRequest, Operation>
         runAssetDiscoverySettings() {
       return getStubSettingsBuilder().runAssetDiscoverySettings();
     }
 
-    /** Returns the builder for the settings used for calls to runAssetDiscovery. */
+    /**
+     * Returns the builder for the settings used for calls to runAssetDiscovery.
+     *
+     * @deprecated This method is deprecated and will be removed in the next major version update.
+     */
+    @Deprecated
     public OperationCallSettings.Builder<RunAssetDiscoveryRequest, RunAssetDiscoveryResponse, Empty>
         runAssetDiscoveryOperationSettings() {
       return getStubSettingsBuilder().runAssetDiscoveryOperationSettings();

diff --git a/...uritycenter/src/main/java/com/google/cloud/securitycenter/v1/stub/SecurityCenterStub.java b/...uritycenter/src/main/java/com/google/cloud/securitycenter/v1/stub/SecurityCenterStub.java
@@ -210,10 +210,12 @@ public UnaryCallable<GetSourceRequest, Source> getSourceCallable() {
     throw new UnsupportedOperationException("Not implemented: getSourceCallable()");
   }
 
+  @Deprecated
   public UnaryCallable<GroupAssetsRequest, GroupAssetsPagedResponse> groupAssetsPagedCallable() {
     throw new UnsupportedOperationException("Not implemented: groupAssetsPagedCallable()");
   }
 
+  @Deprecated
   public UnaryCallable<GroupAssetsRequest, GroupAssetsResponse> groupAssetsCallable() {
     throw new UnsupportedOperationException("Not implemented: groupAssetsCallable()");
   }
@@ -227,10 +229,12 @@ public UnaryCallable<GroupFindingsRequest, GroupFindingsResponse> groupFindingsC
     throw new UnsupportedOperationException("Not implemented: groupFindingsCallable()");
   }
 
+  @Deprecated
   public UnaryCallable<ListAssetsRequest, ListAssetsPagedResponse> listAssetsPagedCallable() {
     throw new UnsupportedOperationException("Not implemented: listAssetsPagedCallable()");
   }
 
+  @Deprecated
   public UnaryCallable<ListAssetsRequest, ListAssetsResponse> listAssetsCallable() {
     throw new UnsupportedOperationException("Not implemented: listAssetsCallable()");
   }
@@ -319,12 +323,14 @@ public UnaryCallable<ListSourcesRequest, ListSourcesResponse> listSourcesCallabl
     throw new UnsupportedOperationException("Not implemented: listSourcesCallable()");
   }
 
+  @Deprecated
   public OperationCallable<RunAssetDiscoveryRequest, RunAssetDiscoveryResponse, Empty>
       runAssetDiscoveryOperationCallable() {
     throw new UnsupportedOperationException(
         "Not implemented: runAssetDiscoveryOperationCallable()");
   }
 
+  @Deprecated
   public UnaryCallable<RunAssetDiscoveryRequest, Operation> runAssetDiscoveryCallable() {
     throw new UnsupportedOperationException("Not implemented: runAssetDiscoveryCallable()");
   }

diff --git a/...ter/src/main/java/com/google/cloud/securitycenter/v1/stub/SecurityCenterStubSettings.java b/...ter/src/main/java/com/google/cloud/securitycenter/v1/stub/SecurityCenterStubSettings.java
@@ -1120,7 +1120,12 @@ public UnaryCallSettings<GetSourceRequest, Source> getSourceSettings() {
     return getSourceSettings;
   }
 
-  /** Returns the object with the settings used for calls to groupAssets. */
+  /**
+   * Returns the object with the settings used for calls to groupAssets.
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
+   */
+  @Deprecated
   public PagedCallSettings<GroupAssetsRequest, GroupAssetsResponse, GroupAssetsPagedResponse>
       groupAssetsSettings() {
     return groupAssetsSettings;
@@ -1132,7 +1137,12 @@ public UnaryCallSettings<GetSourceRequest, Source> getSourceSettings() {
     return groupFindingsSettings;
   }
 
-  /** Returns the object with the settings used for calls to listAssets. */
+  /**
+   * Returns the object with the settings used for calls to listAssets.
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
+   */
+  @Deprecated
   public PagedCallSettings<ListAssetsRequest, ListAssetsResponse, ListAssetsPagedResponse>
       listAssetsSettings() {
     return listAssetsSettings;
@@ -1202,7 +1212,12 @@ public UnaryCallSettings<GetSourceRequest, Source> getSourceSettings() {
     return listSourcesSettings;
   }
 
-  /** Returns the object with the settings used for calls to runAssetDiscovery. */
+  /**
+   * Returns the object with the settings used for calls to runAssetDiscovery.
+   *
+   * @deprecated This method is deprecated and will be removed in the next major version update.
+   */
+  @Deprecated
   public UnaryCallSettings<RunAssetDiscoveryRequest, Operation> runAssetDiscoverySettings() {
     return runAssetDiscoverySettings;
   }
@@ -2312,7 +2327,12 @@ public UnaryCallSettings.Builder<GetSourceRequest, Source> getSourceSettings() {
       return getSourceSettings;
     }
 
-    /** Returns the builder for the settings used for calls to groupAssets. */
+    /**
+     * Returns the builder for the settings used for calls to groupAssets.
+     *
+     * @deprecated This method is deprecated and will be removed in the next major version update.
+     */
+    @Deprecated
     public PagedCallSettings.Builder<
             GroupAssetsRequest, GroupAssetsResponse, GroupAssetsPagedResponse>
         groupAssetsSettings() {
@@ -2326,7 +2346,12 @@ public UnaryCallSettings.Builder<GetSourceRequest, Source> getSourceSettings() {
       return groupFindingsSettings;
     }
 
-    /** Returns the builder for the settings used for calls to listAssets. */
+    /**
+     * Returns the builder for the settings used for calls to listAssets.
+     *
+     * @deprecated This method is deprecated and will be removed in the next major version update.
+     */
+    @Deprecated
     public PagedCallSettings.Builder<ListAssetsRequest, ListAssetsResponse, ListAssetsPagedResponse>
         listAssetsSettings() {
       return listAssetsSettings;
@@ -2398,7 +2423,12 @@ public UnaryCallSettings.Builder<GetSourceRequest, Source> getSourceSettings() {
       return listSourcesSettings;
     }
 
-    /** Returns the builder for the settings used for calls to runAssetDiscovery. */
+    /**
+     * Returns the builder for the settings used for calls to runAssetDiscovery.
+     *
+     * @deprecated This method is deprecated and will be removed in the next major version update.
+     */
+    @Deprecated
     public UnaryCallSettings.Builder<RunAssetDiscoveryRequest, Operation>
         runAssetDiscoverySettings() {
       return runAssetDiscoverySettings;