4646 * <p>This class provides the ability to make remote calls to the backing service through method
4747 * calls that map to API methods. Sample code to get started:
4848 *
49+ * <pre>{@code
50+ * try (MigrationServiceClient migrationServiceClient = MigrationServiceClient.create()) {
51+ * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
52+ * for (MigratableResource element :
53+ * migrationServiceClient.searchMigratableResources(parent).iterateAll()) {
54+ * // doThingsWith(element);
55+ * }
56+ * }
57+ * }</pre>
58+ *
4959 * <p>Note: close() needs to be called on the MigrationServiceClient object to clean up resources
5060 * such as threads. In the example above, try-with-resources is used, which automatically calls
5161 * close().
@@ -165,6 +175,18 @@ public final OperationsClient getOperationsClient() {
165175 * Searches all of the resources in automl.googleapis.com, datalabeling.googleapis.com and
166176 * ml.googleapis.com that can be migrated to AI Platform's given location.
167177 *
178+ * <p>Sample code:
179+ *
180+ * <pre>{@code
181+ * try (MigrationServiceClient migrationServiceClient = MigrationServiceClient.create()) {
182+ * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
183+ * for (MigratableResource element :
184+ * migrationServiceClient.searchMigratableResources(parent).iterateAll()) {
185+ * // doThingsWith(element);
186+ * }
187+ * }
188+ * }</pre>
189+ *
168190 * @param parent Required. The location that the migratable resources should be searched from.
169191 * It's the AI Platform location that the resources can be migrated to, not the resources'
170192 * original location. Format: `projects/{project}/locations/{location}`
@@ -184,6 +206,18 @@ public final SearchMigratableResourcesPagedResponse searchMigratableResources(
184206 * Searches all of the resources in automl.googleapis.com, datalabeling.googleapis.com and
185207 * ml.googleapis.com that can be migrated to AI Platform's given location.
186208 *
209+ * <p>Sample code:
210+ *
211+ * <pre>{@code
212+ * try (MigrationServiceClient migrationServiceClient = MigrationServiceClient.create()) {
213+ * String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
214+ * for (MigratableResource element :
215+ * migrationServiceClient.searchMigratableResources(parent).iterateAll()) {
216+ * // doThingsWith(element);
217+ * }
218+ * }
219+ * }</pre>
220+ *
187221 * @param parent Required. The location that the migratable resources should be searched from.
188222 * It's the AI Platform location that the resources can be migrated to, not the resources'
189223 * original location. Format: `projects/{project}/locations/{location}`
@@ -200,6 +234,24 @@ public final SearchMigratableResourcesPagedResponse searchMigratableResources(St
200234 * Searches all of the resources in automl.googleapis.com, datalabeling.googleapis.com and
201235 * ml.googleapis.com that can be migrated to AI Platform's given location.
202236 *
237+ * <p>Sample code:
238+ *
239+ * <pre>{@code
240+ * try (MigrationServiceClient migrationServiceClient = MigrationServiceClient.create()) {
241+ * SearchMigratableResourcesRequest request =
242+ * SearchMigratableResourcesRequest.newBuilder()
243+ * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
244+ * .setPageSize(883849137)
245+ * .setPageToken("pageToken873572522")
246+ * .setFilter("filter-1274492040")
247+ * .build();
248+ * for (MigratableResource element :
249+ * migrationServiceClient.searchMigratableResources(request).iterateAll()) {
250+ * // doThingsWith(element);
251+ * }
252+ * }
253+ * }</pre>
254+ *
203255 * @param request The request object containing all of the parameters for the API call.
204256 * @throws com.google.api.gax.rpc.ApiException if the remote call fails
205257 */
@@ -214,6 +266,24 @@ public final SearchMigratableResourcesPagedResponse searchMigratableResources(
214266 * ml.googleapis.com that can be migrated to AI Platform's given location.
215267 *
216268 * <p>Sample code:
269+ *
270+ * <pre>{@code
271+ * try (MigrationServiceClient migrationServiceClient = MigrationServiceClient.create()) {
272+ * SearchMigratableResourcesRequest request =
273+ * SearchMigratableResourcesRequest.newBuilder()
274+ * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
275+ * .setPageSize(883849137)
276+ * .setPageToken("pageToken873572522")
277+ * .setFilter("filter-1274492040")
278+ * .build();
279+ * ApiFuture<MigratableResource> future =
280+ * migrationServiceClient.searchMigratableResourcesPagedCallable().futureCall(request);
281+ * // Do something.
282+ * for (MigratableResource element : future.get().iterateAll()) {
283+ * // doThingsWith(element);
284+ * }
285+ * }
286+ * }</pre>
217287 */
218288 public final UnaryCallable <
219289 SearchMigratableResourcesRequest , SearchMigratableResourcesPagedResponse >
@@ -227,6 +297,24 @@ public final SearchMigratableResourcesPagedResponse searchMigratableResources(
227297 * ml.googleapis.com that can be migrated to AI Platform's given location.
228298 *
229299 * <p>Sample code:
300+ *
301+ * <pre>{@code
302+ * try (MigrationServiceClient migrationServiceClient = MigrationServiceClient.create()) {
303+ * while (true) {
304+ * SearchMigratableResourcesResponse response =
305+ * migrationServiceClient.searchMigratableResourcesCallable().call(request);
306+ * for (MigratableResource element : response.getResponsesList()) {
307+ * // doThingsWith(element);
308+ * }
309+ * String nextPageToken = response.getNextPageToken();
310+ * if (!Strings.isNullOrEmpty(nextPageToken)) {
311+ * request = request.toBuilder().setPageToken(nextPageToken).build();
312+ * } else {
313+ * break;
314+ * }
315+ * }
316+ * }
317+ * }</pre>
230318 */
231319 public final UnaryCallable <SearchMigratableResourcesRequest , SearchMigratableResourcesResponse >
232320 searchMigratableResourcesCallable () {
@@ -238,6 +326,17 @@ public final SearchMigratableResourcesPagedResponse searchMigratableResources(
238326 * Batch migrates resources from ml.googleapis.com, automl.googleapis.com, and
239327 * datalabeling.googleapis.com to AI Platform (Unified).
240328 *
329+ * <p>Sample code:
330+ *
331+ * <pre>{@code
332+ * try (MigrationServiceClient migrationServiceClient = MigrationServiceClient.create()) {
333+ * LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
334+ * List<MigrateResourceRequest> migrateResourceRequests = new ArrayList<>();
335+ * BatchMigrateResourcesResponse response =
336+ * migrationServiceClient.batchMigrateResourcesAsync(parent, migrateResourceRequests).get();
337+ * }
338+ * }</pre>
339+ *
241340 * @param parent Required. The location of the migrated resource will live in. Format:
242341 * `projects/{project}/locations/{location}`
243342 * @param migrateResourceRequests Required. The request messages specifying the resources to
@@ -262,6 +361,17 @@ public final SearchMigratableResourcesPagedResponse searchMigratableResources(
262361 * Batch migrates resources from ml.googleapis.com, automl.googleapis.com, and
263362 * datalabeling.googleapis.com to AI Platform (Unified).
264363 *
364+ * <p>Sample code:
365+ *
366+ * <pre>{@code
367+ * try (MigrationServiceClient migrationServiceClient = MigrationServiceClient.create()) {
368+ * String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
369+ * List<MigrateResourceRequest> migrateResourceRequests = new ArrayList<>();
370+ * BatchMigrateResourcesResponse response =
371+ * migrationServiceClient.batchMigrateResourcesAsync(parent, migrateResourceRequests).get();
372+ * }
373+ * }</pre>
374+ *
265375 * @param parent Required. The location of the migrated resource will live in. Format:
266376 * `projects/{project}/locations/{location}`
267377 * @param migrateResourceRequests Required. The request messages specifying the resources to
@@ -286,6 +396,20 @@ public final SearchMigratableResourcesPagedResponse searchMigratableResources(
286396 * Batch migrates resources from ml.googleapis.com, automl.googleapis.com, and
287397 * datalabeling.googleapis.com to AI Platform (Unified).
288398 *
399+ * <p>Sample code:
400+ *
401+ * <pre>{@code
402+ * try (MigrationServiceClient migrationServiceClient = MigrationServiceClient.create()) {
403+ * BatchMigrateResourcesRequest request =
404+ * BatchMigrateResourcesRequest.newBuilder()
405+ * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
406+ * .addAllMigrateResourceRequests(new ArrayList<MigrateResourceRequest>())
407+ * .build();
408+ * BatchMigrateResourcesResponse response =
409+ * migrationServiceClient.batchMigrateResourcesAsync(request).get();
410+ * }
411+ * }</pre>
412+ *
289413 * @param request The request object containing all of the parameters for the API call.
290414 * @throws com.google.api.gax.rpc.ApiException if the remote call fails
291415 */
@@ -301,6 +425,21 @@ public final SearchMigratableResourcesPagedResponse searchMigratableResources(
301425 * datalabeling.googleapis.com to AI Platform (Unified).
302426 *
303427 * <p>Sample code:
428+ *
429+ * <pre>{@code
430+ * try (MigrationServiceClient migrationServiceClient = MigrationServiceClient.create()) {
431+ * BatchMigrateResourcesRequest request =
432+ * BatchMigrateResourcesRequest.newBuilder()
433+ * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
434+ * .addAllMigrateResourceRequests(new ArrayList<MigrateResourceRequest>())
435+ * .build();
436+ * OperationFuture<BatchMigrateResourcesResponse, BatchMigrateResourcesOperationMetadata>
437+ * future =
438+ * migrationServiceClient.batchMigrateResourcesOperationCallable().futureCall(request);
439+ * // Do something.
440+ * BatchMigrateResourcesResponse response = future.get();
441+ * }
442+ * }</pre>
304443 */
305444 public final OperationCallable <
306445 BatchMigrateResourcesRequest ,
@@ -316,6 +455,20 @@ public final SearchMigratableResourcesPagedResponse searchMigratableResources(
316455 * datalabeling.googleapis.com to AI Platform (Unified).
317456 *
318457 * <p>Sample code:
458+ *
459+ * <pre>{@code
460+ * try (MigrationServiceClient migrationServiceClient = MigrationServiceClient.create()) {
461+ * BatchMigrateResourcesRequest request =
462+ * BatchMigrateResourcesRequest.newBuilder()
463+ * .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
464+ * .addAllMigrateResourceRequests(new ArrayList<MigrateResourceRequest>())
465+ * .build();
466+ * ApiFuture<Operation> future =
467+ * migrationServiceClient.batchMigrateResourcesCallable().futureCall(request);
468+ * // Do something.
469+ * Operation response = future.get();
470+ * }
471+ * }</pre>
319472 */
320473 public final UnaryCallable <BatchMigrateResourcesRequest , Operation >
321474 batchMigrateResourcesCallable () {
0 commit comments