@@ -119,7 +119,7 @@ class BatchServiceClient {
119119 // / [`future`]: @ref google::cloud::future
120120 // / [`StatusOr`]: @ref google::cloud::StatusOr
121121 // / [`Status`]: @ref google::cloud::Status
122- // / [google.cloud.batch.v1.CreateJobRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L102 }
122+ // / [google.cloud.batch.v1.CreateJobRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L115 }
123123 // / [google.cloud.batch.v1.Job]: @googleapis_reference_link{google/cloud/batch/v1/job.proto#L35}
124124 // /
125125 // clang-format on
@@ -150,7 +150,7 @@ class BatchServiceClient {
150150 // / [`future`]: @ref google::cloud::future
151151 // / [`StatusOr`]: @ref google::cloud::StatusOr
152152 // / [`Status`]: @ref google::cloud::Status
153- // / [google.cloud.batch.v1.CreateJobRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L102 }
153+ // / [google.cloud.batch.v1.CreateJobRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L115 }
154154 // / [google.cloud.batch.v1.Job]: @googleapis_reference_link{google/cloud/batch/v1/job.proto#L35}
155155 // /
156156 // clang-format on
@@ -176,7 +176,7 @@ class BatchServiceClient {
176176 // / [`future`]: @ref google::cloud::future
177177 // / [`StatusOr`]: @ref google::cloud::StatusOr
178178 // / [`Status`]: @ref google::cloud::Status
179- // / [google.cloud.batch.v1.GetJobRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L141 }
179+ // / [google.cloud.batch.v1.GetJobRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L154 }
180180 // / [google.cloud.batch.v1.Job]: @googleapis_reference_link{google/cloud/batch/v1/job.proto#L35}
181181 // /
182182 // clang-format on
@@ -206,7 +206,7 @@ class BatchServiceClient {
206206 // / [`future`]: @ref google::cloud::future
207207 // / [`StatusOr`]: @ref google::cloud::StatusOr
208208 // / [`Status`]: @ref google::cloud::Status
209- // / [google.cloud.batch.v1.GetJobRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L141 }
209+ // / [google.cloud.batch.v1.GetJobRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L154 }
210210 // / [google.cloud.batch.v1.Job]: @googleapis_reference_link{google/cloud/batch/v1/job.proto#L35}
211211 // /
212212 // clang-format on
@@ -239,8 +239,8 @@ class BatchServiceClient {
239239 // / [`future`]: @ref google::cloud::future
240240 // / [`StatusOr`]: @ref google::cloud::StatusOr
241241 // / [`Status`]: @ref google::cloud::Status
242- // / [google.cloud.batch.v1.DeleteJobRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L150 }
243- // / [google.cloud.batch.v1.OperationMetadata]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L248 }
242+ // / [google.cloud.batch.v1.DeleteJobRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L163 }
243+ // / [google.cloud.batch.v1.OperationMetadata]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L291 }
244244 // /
245245 // clang-format on
246246 future<StatusOr<google::cloud::batch::v1::OperationMetadata>> DeleteJob (
@@ -291,8 +291,8 @@ class BatchServiceClient {
291291 // / [`future`]: @ref google::cloud::future
292292 // / [`StatusOr`]: @ref google::cloud::StatusOr
293293 // / [`Status`]: @ref google::cloud::Status
294- // / [google.cloud.batch.v1.DeleteJobRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L150 }
295- // / [google.cloud.batch.v1.OperationMetadata]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L248 }
294+ // / [google.cloud.batch.v1.DeleteJobRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L163 }
295+ // / [google.cloud.batch.v1.OperationMetadata]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L291 }
296296 // /
297297 // clang-format on
298298 future<StatusOr<google::cloud::batch::v1::OperationMetadata>> DeleteJob (
@@ -326,6 +326,118 @@ class BatchServiceClient {
326326 future<StatusOr<google::cloud::batch::v1::OperationMetadata>> DeleteJob (
327327 google::longrunning::Operation const & operation, Options opts = {});
328328
329+ // clang-format off
330+ // /
331+ // / Cancel a Job.
332+ // /
333+ // / @param name Required. Job name.
334+ // / @param opts Optional. Override the class-level options, such as retry and
335+ // / backoff policies.
336+ // / @return A [`future`] that becomes satisfied when the LRO
337+ // / ([Long Running Operation]) completes or the polling policy in effect
338+ // / for this call is exhausted. The future is satisfied with an error if
339+ // / the LRO completes with an error or the polling policy is exhausted.
340+ // / In this case the [`StatusOr`] returned by the future contains the
341+ // / error. If the LRO completes successfully the value of the future
342+ // / contains the LRO's result. For this RPC the result is a
343+ // / [google.cloud.batch.v1.CancelJobResponse] proto message.
344+ // / The C++ class representing this message is created by Protobuf, using
345+ // / the [Protobuf mapping rules].
346+ // /
347+ // / [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/
348+ // / [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator
349+ // / [Long Running Operation]: https://google.aip.dev/151
350+ // / [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string
351+ // / [`future`]: @ref google::cloud::future
352+ // / [`StatusOr`]: @ref google::cloud::StatusOr
353+ // / [`Status`]: @ref google::cloud::Status
354+ // / [google.cloud.batch.v1.CancelJobRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L187}
355+ // / [google.cloud.batch.v1.CancelJobResponse]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L214}
356+ // /
357+ // clang-format on
358+ future<StatusOr<google::cloud::batch::v1::CancelJobResponse>> CancelJob (
359+ std::string const & name, Options opts = {});
360+
361+ // clang-format off
362+ // /
363+ // / @copybrief CancelJob
364+ // /
365+ // / Specifying the [`NoAwaitTag`] immediately returns the
366+ // / [`google::longrunning::Operation`] that corresponds to the Long Running
367+ // / Operation that has been started. No polling for operation status occurs.
368+ // /
369+ // / [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag
370+ // /
371+ // clang-format on
372+ StatusOr<google::longrunning::Operation> CancelJob (NoAwaitTag,
373+ std::string const & name,
374+ Options opts = {});
375+
376+ // clang-format off
377+ // /
378+ // / Cancel a Job.
379+ // /
380+ // / @param request Unary RPCs, such as the one wrapped by this
381+ // / function, receive a single `request` proto message which includes all
382+ // / the inputs for the RPC. In this case, the proto message is a
383+ // / [google.cloud.batch.v1.CancelJobRequest].
384+ // / Proto messages are converted to C++ classes by Protobuf, using the
385+ // / [Protobuf mapping rules].
386+ // / @param opts Optional. Override the class-level options, such as retry and
387+ // / backoff policies.
388+ // / @return A [`future`] that becomes satisfied when the LRO
389+ // / ([Long Running Operation]) completes or the polling policy in effect
390+ // / for this call is exhausted. The future is satisfied with an error if
391+ // / the LRO completes with an error or the polling policy is exhausted.
392+ // / In this case the [`StatusOr`] returned by the future contains the
393+ // / error. If the LRO completes successfully the value of the future
394+ // / contains the LRO's result. For this RPC the result is a
395+ // / [google.cloud.batch.v1.CancelJobResponse] proto message.
396+ // / The C++ class representing this message is created by Protobuf, using
397+ // / the [Protobuf mapping rules].
398+ // /
399+ // / [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/
400+ // / [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator
401+ // / [Long Running Operation]: https://google.aip.dev/151
402+ // / [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string
403+ // / [`future`]: @ref google::cloud::future
404+ // / [`StatusOr`]: @ref google::cloud::StatusOr
405+ // / [`Status`]: @ref google::cloud::Status
406+ // / [google.cloud.batch.v1.CancelJobRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L187}
407+ // / [google.cloud.batch.v1.CancelJobResponse]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L214}
408+ // /
409+ // clang-format on
410+ future<StatusOr<google::cloud::batch::v1::CancelJobResponse>> CancelJob (
411+ google::cloud::batch::v1::CancelJobRequest const & request,
412+ Options opts = {});
413+
414+ // clang-format off
415+ // /
416+ // / @copybrief CancelJob
417+ // /
418+ // / Specifying the [`NoAwaitTag`] immediately returns the
419+ // / [`google::longrunning::Operation`] that corresponds to the Long Running
420+ // / Operation that has been started. No polling for operation status occurs.
421+ // /
422+ // / [`NoAwaitTag`]: @ref google::cloud::NoAwaitTag
423+ // /
424+ // clang-format on
425+ StatusOr<google::longrunning::Operation> CancelJob (
426+ NoAwaitTag, google::cloud::batch::v1::CancelJobRequest const & request,
427+ Options opts = {});
428+
429+ // clang-format off
430+ // /
431+ // / @copybrief CancelJob
432+ // /
433+ // / This method accepts a `google::longrunning::Operation` that corresponds
434+ // / to a previously started Long Running Operation (LRO) and polls the status
435+ // / of the LRO in the background.
436+ // /
437+ // clang-format on
438+ future<StatusOr<google::cloud::batch::v1::CancelJobResponse>> CancelJob (
439+ google::longrunning::Operation const & operation, Options opts = {});
440+
329441 // clang-format off
330442 // /
331443 // / List all Jobs for a project within a region.
@@ -354,7 +466,7 @@ class BatchServiceClient {
354466 // / [`StatusOr`]: @ref google::cloud::StatusOr
355467 // / [`Status`]: @ref google::cloud::Status
356468 // / [google.cloud.batch.v1.Job]: @googleapis_reference_link{google/cloud/batch/v1/job.proto#L35}
357- // / [google.cloud.batch.v1.ListJobsRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L174 }
469+ // / [google.cloud.batch.v1.ListJobsRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L217 }
358470 // /
359471 // clang-format on
360472 StreamRange<google::cloud::batch::v1::Job> ListJobs (std::string const & parent,
@@ -393,7 +505,7 @@ class BatchServiceClient {
393505 // / [`StatusOr`]: @ref google::cloud::StatusOr
394506 // / [`Status`]: @ref google::cloud::Status
395507 // / [google.cloud.batch.v1.Job]: @googleapis_reference_link{google/cloud/batch/v1/job.proto#L35}
396- // / [google.cloud.batch.v1.ListJobsRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L174 }
508+ // / [google.cloud.batch.v1.ListJobsRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L217 }
397509 // /
398510 // clang-format on
399511 StreamRange<google::cloud::batch::v1::Job> ListJobs (
@@ -417,7 +529,7 @@ class BatchServiceClient {
417529 // / [`future`]: @ref google::cloud::future
418530 // / [`StatusOr`]: @ref google::cloud::StatusOr
419531 // / [`Status`]: @ref google::cloud::Status
420- // / [google.cloud.batch.v1.GetTaskRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L239 }
532+ // / [google.cloud.batch.v1.GetTaskRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L282 }
421533 // / [google.cloud.batch.v1.Task]: @googleapis_reference_link{google/cloud/batch/v1/task.proto#L437}
422534 // /
423535 // clang-format on
@@ -447,7 +559,7 @@ class BatchServiceClient {
447559 // / [`future`]: @ref google::cloud::future
448560 // / [`StatusOr`]: @ref google::cloud::StatusOr
449561 // / [`Status`]: @ref google::cloud::Status
450- // / [google.cloud.batch.v1.GetTaskRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L239 }
562+ // / [google.cloud.batch.v1.GetTaskRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L282 }
451563 // / [google.cloud.batch.v1.Task]: @googleapis_reference_link{google/cloud/batch/v1/task.proto#L437}
452564 // /
453565 // clang-format on
@@ -484,7 +596,7 @@ class BatchServiceClient {
484596 // / [`future`]: @ref google::cloud::future
485597 // / [`StatusOr`]: @ref google::cloud::StatusOr
486598 // / [`Status`]: @ref google::cloud::Status
487- // / [google.cloud.batch.v1.ListTasksRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L205 }
599+ // / [google.cloud.batch.v1.ListTasksRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L248 }
488600 // / [google.cloud.batch.v1.Task]: @googleapis_reference_link{google/cloud/batch/v1/task.proto#L437}
489601 // /
490602 // clang-format on
@@ -523,7 +635,7 @@ class BatchServiceClient {
523635 // / [`future`]: @ref google::cloud::future
524636 // / [`StatusOr`]: @ref google::cloud::StatusOr
525637 // / [`Status`]: @ref google::cloud::Status
526- // / [google.cloud.batch.v1.ListTasksRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L205 }
638+ // / [google.cloud.batch.v1.ListTasksRequest]: @googleapis_reference_link{google/cloud/batch/v1/batch.proto#L248 }
527639 // / [google.cloud.batch.v1.Task]: @googleapis_reference_link{google/cloud/batch/v1/task.proto#L437}
528640 // /
529641 // clang-format on
0 commit comments