google-apis-dataproc_v1 0.72.0 → 0.73.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -562,16 +562,13 @@ module Google
562
562
  execute_or_queue_command(command, &block)
563
563
  end
564
564
 
565
- # Starts asynchronous cancellation on a long-running operation. The server makes
566
- # a best effort to cancel the operation, but success is not guaranteed. If the
567
- # server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
568
- # Clients can use Operations.GetOperation or other methods to check whether the
569
- # cancellation succeeded or whether the operation completed despite cancellation.
570
- # On successful cancellation, the operation is not deleted; instead, it becomes
571
- # an operation with an Operation.error value with a google.rpc.Status.code of 1,
572
- # corresponding to Code.CANCELLED.
565
+ # Obtain high level information corresponding to a single Spark Application.
573
566
  # @param [String] name
574
- # The name of the operation resource to be cancelled.
567
+ # Required. The fully qualified name of the batch to retrieve in the format "
568
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/
569
+ # sparkApplications/APPLICATION_ID"
570
+ # @param [String] parent
571
+ # Required. Parent (Batch) resource reference.
575
572
  # @param [String] fields
576
573
  # Selector specifying which fields to include in a partial response.
577
574
  # @param [String] quota_user
@@ -581,30 +578,32 @@ module Google
581
578
  # Request-specific options
582
579
  #
583
580
  # @yield [result, err] Result & error if block supplied
584
- # @yieldparam result [Google::Apis::DataprocV1::Empty] parsed result object
581
+ # @yieldparam result [Google::Apis::DataprocV1::AccessSparkApplicationResponse] parsed result object
585
582
  # @yieldparam err [StandardError] error object if request failed
586
583
  #
587
- # @return [Google::Apis::DataprocV1::Empty]
584
+ # @return [Google::Apis::DataprocV1::AccessSparkApplicationResponse]
588
585
  #
589
586
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
590
587
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
591
588
  # @raise [Google::Apis::AuthorizationError] Authorization is required
592
- def cancel_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
593
- command = make_simple_command(:post, 'v1/{+name}:cancel', options)
594
- command.response_representation = Google::Apis::DataprocV1::Empty::Representation
595
- command.response_class = Google::Apis::DataprocV1::Empty
589
+ def access_project_location_batch_spark_application(name, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
590
+ command = make_simple_command(:get, 'v1/{+name}:access', options)
591
+ command.response_representation = Google::Apis::DataprocV1::AccessSparkApplicationResponse::Representation
592
+ command.response_class = Google::Apis::DataprocV1::AccessSparkApplicationResponse
596
593
  command.params['name'] = name unless name.nil?
594
+ command.query['parent'] = parent unless parent.nil?
597
595
  command.query['fields'] = fields unless fields.nil?
598
596
  command.query['quotaUser'] = quota_user unless quota_user.nil?
599
597
  execute_or_queue_command(command, &block)
600
598
  end
601
599
 
602
- # Deletes a long-running operation. This method indicates that the client is no
603
- # longer interested in the operation result. It does not cancel the operation.
604
- # If the server doesn't support this method, it returns google.rpc.Code.
605
- # UNIMPLEMENTED.
600
+ # Obtain environment details for a Spark Application
606
601
  # @param [String] name
607
- # The name of the operation resource to be deleted.
602
+ # Required. The fully qualified name of the batch to retrieve in the format "
603
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/
604
+ # sparkApplications/APPLICATION_ID"
605
+ # @param [String] parent
606
+ # Required. Parent (Batch) resource reference.
608
607
  # @param [String] fields
609
608
  # Selector specifying which fields to include in a partial response.
610
609
  # @param [String] quota_user
@@ -614,28 +613,34 @@ module Google
614
613
  # Request-specific options
615
614
  #
616
615
  # @yield [result, err] Result & error if block supplied
617
- # @yieldparam result [Google::Apis::DataprocV1::Empty] parsed result object
616
+ # @yieldparam result [Google::Apis::DataprocV1::AccessSparkApplicationEnvironmentInfoResponse] parsed result object
618
617
  # @yieldparam err [StandardError] error object if request failed
619
618
  #
620
- # @return [Google::Apis::DataprocV1::Empty]
619
+ # @return [Google::Apis::DataprocV1::AccessSparkApplicationEnvironmentInfoResponse]
621
620
  #
622
621
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
623
622
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
624
623
  # @raise [Google::Apis::AuthorizationError] Authorization is required
625
- def delete_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
626
- command = make_simple_command(:delete, 'v1/{+name}', options)
627
- command.response_representation = Google::Apis::DataprocV1::Empty::Representation
628
- command.response_class = Google::Apis::DataprocV1::Empty
624
+ def access_project_location_batch_spark_application_environment_info(name, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
625
+ command = make_simple_command(:get, 'v1/{+name}:accessEnvironmentInfo', options)
626
+ command.response_representation = Google::Apis::DataprocV1::AccessSparkApplicationEnvironmentInfoResponse::Representation
627
+ command.response_class = Google::Apis::DataprocV1::AccessSparkApplicationEnvironmentInfoResponse
629
628
  command.params['name'] = name unless name.nil?
629
+ command.query['parent'] = parent unless parent.nil?
630
630
  command.query['fields'] = fields unless fields.nil?
631
631
  command.query['quotaUser'] = quota_user unless quota_user.nil?
632
632
  execute_or_queue_command(command, &block)
633
633
  end
634
634
 
635
- # Gets the latest state of a long-running operation. Clients can use this method
636
- # to poll the operation result at intervals as recommended by the API service.
635
+ # Obtain data corresponding to a spark job for a Spark Application.
637
636
  # @param [String] name
638
- # The name of the operation resource.
637
+ # Required. The fully qualified name of the batch to retrieve in the format "
638
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/
639
+ # sparkApplications/APPLICATION_ID"
640
+ # @param [Fixnum] job_id
641
+ # Required. Job ID to fetch data for.
642
+ # @param [String] parent
643
+ # Required. Parent (Batch) resource reference.
639
644
  # @param [String] fields
640
645
  # Selector specifying which fields to include in a partial response.
641
646
  # @param [String] quota_user
@@ -645,34 +650,36 @@ module Google
645
650
  # Request-specific options
646
651
  #
647
652
  # @yield [result, err] Result & error if block supplied
648
- # @yieldparam result [Google::Apis::DataprocV1::Operation] parsed result object
653
+ # @yieldparam result [Google::Apis::DataprocV1::AccessSparkApplicationJobResponse] parsed result object
649
654
  # @yieldparam err [StandardError] error object if request failed
650
655
  #
651
- # @return [Google::Apis::DataprocV1::Operation]
656
+ # @return [Google::Apis::DataprocV1::AccessSparkApplicationJobResponse]
652
657
  #
653
658
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
654
659
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
655
660
  # @raise [Google::Apis::AuthorizationError] Authorization is required
656
- def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
657
- command = make_simple_command(:get, 'v1/{+name}', options)
658
- command.response_representation = Google::Apis::DataprocV1::Operation::Representation
659
- command.response_class = Google::Apis::DataprocV1::Operation
661
+ def access_project_location_batch_spark_application_job(name, job_id: nil, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
662
+ command = make_simple_command(:get, 'v1/{+name}:accessJob', options)
663
+ command.response_representation = Google::Apis::DataprocV1::AccessSparkApplicationJobResponse::Representation
664
+ command.response_class = Google::Apis::DataprocV1::AccessSparkApplicationJobResponse
660
665
  command.params['name'] = name unless name.nil?
666
+ command.query['jobId'] = job_id unless job_id.nil?
667
+ command.query['parent'] = parent unless parent.nil?
661
668
  command.query['fields'] = fields unless fields.nil?
662
669
  command.query['quotaUser'] = quota_user unless quota_user.nil?
663
670
  execute_or_queue_command(command, &block)
664
671
  end
665
672
 
666
- # Lists operations that match the specified filter in the request. If the server
667
- # doesn't support this method, it returns UNIMPLEMENTED.
673
+ # Obtain Spark Plan Graph for a Spark Application SQL execution. Limits the
674
+ # number of clusters returned as part of the graph to 10000.
668
675
  # @param [String] name
669
- # The name of the operation's parent resource.
670
- # @param [String] filter
671
- # The standard list filter.
672
- # @param [Fixnum] page_size
673
- # The standard list page size.
674
- # @param [String] page_token
675
- # The standard list page token.
676
+ # Required. The fully qualified name of the batch to retrieve in the format "
677
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/
678
+ # sparkApplications/APPLICATION_ID"
679
+ # @param [Fixnum] execution_id
680
+ # Required. Execution ID
681
+ # @param [String] parent
682
+ # Required. Parent (Batch) resource reference.
676
683
  # @param [String] fields
677
684
  # Selector specifying which fields to include in a partial response.
678
685
  # @param [String] quota_user
@@ -682,31 +689,40 @@ module Google
682
689
  # Request-specific options
683
690
  #
684
691
  # @yield [result, err] Result & error if block supplied
685
- # @yieldparam result [Google::Apis::DataprocV1::ListOperationsResponse] parsed result object
692
+ # @yieldparam result [Google::Apis::DataprocV1::AccessSparkApplicationSqlSparkPlanGraphResponse] parsed result object
686
693
  # @yieldparam err [StandardError] error object if request failed
687
694
  #
688
- # @return [Google::Apis::DataprocV1::ListOperationsResponse]
695
+ # @return [Google::Apis::DataprocV1::AccessSparkApplicationSqlSparkPlanGraphResponse]
689
696
  #
690
697
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
691
698
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
692
699
  # @raise [Google::Apis::AuthorizationError] Authorization is required
693
- def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
694
- command = make_simple_command(:get, 'v1/{+name}', options)
695
- command.response_representation = Google::Apis::DataprocV1::ListOperationsResponse::Representation
696
- command.response_class = Google::Apis::DataprocV1::ListOperationsResponse
700
+ def access_project_location_batch_spark_application_sql_plan(name, execution_id: nil, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
701
+ command = make_simple_command(:get, 'v1/{+name}:accessSqlPlan', options)
702
+ command.response_representation = Google::Apis::DataprocV1::AccessSparkApplicationSqlSparkPlanGraphResponse::Representation
703
+ command.response_class = Google::Apis::DataprocV1::AccessSparkApplicationSqlSparkPlanGraphResponse
697
704
  command.params['name'] = name unless name.nil?
698
- command.query['filter'] = filter unless filter.nil?
699
- command.query['pageSize'] = page_size unless page_size.nil?
700
- command.query['pageToken'] = page_token unless page_token.nil?
705
+ command.query['executionId'] = execution_id unless execution_id.nil?
706
+ command.query['parent'] = parent unless parent.nil?
701
707
  command.query['fields'] = fields unless fields.nil?
702
708
  command.query['quotaUser'] = quota_user unless quota_user.nil?
703
709
  execute_or_queue_command(command, &block)
704
710
  end
705
711
 
706
- # Create a session template synchronously.
712
+ # Obtain data corresponding to a particular SQL Query for a Spark Application.
713
+ # @param [String] name
714
+ # Required. The fully qualified name of the batch to retrieve in the format "
715
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/
716
+ # sparkApplications/APPLICATION_ID"
717
+ # @param [Boolean] details
718
+ # Optional. Lists/ hides details of Spark plan nodes. True is set to list and
719
+ # false to hide.
720
+ # @param [Fixnum] execution_id
721
+ # Required. Execution ID
707
722
  # @param [String] parent
708
- # Required. The parent resource where this session template will be created.
709
- # @param [Google::Apis::DataprocV1::SessionTemplate] session_template_object
723
+ # Required. Parent (Batch) resource reference.
724
+ # @param [Boolean] plan_description
725
+ # Optional. Enables/ disables physical plan description on demand
710
726
  # @param [String] fields
711
727
  # Selector specifying which fields to include in a partial response.
712
728
  # @param [String] quota_user
@@ -716,29 +732,44 @@ module Google
716
732
  # Request-specific options
717
733
  #
718
734
  # @yield [result, err] Result & error if block supplied
719
- # @yieldparam result [Google::Apis::DataprocV1::SessionTemplate] parsed result object
735
+ # @yieldparam result [Google::Apis::DataprocV1::AccessSparkApplicationSqlQueryResponse] parsed result object
720
736
  # @yieldparam err [StandardError] error object if request failed
721
737
  #
722
- # @return [Google::Apis::DataprocV1::SessionTemplate]
738
+ # @return [Google::Apis::DataprocV1::AccessSparkApplicationSqlQueryResponse]
723
739
  #
724
740
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
725
741
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
726
742
  # @raise [Google::Apis::AuthorizationError] Authorization is required
727
- def create_project_location_session_template(parent, session_template_object = nil, fields: nil, quota_user: nil, options: nil, &block)
728
- command = make_simple_command(:post, 'v1/{+parent}/sessionTemplates', options)
729
- command.request_representation = Google::Apis::DataprocV1::SessionTemplate::Representation
730
- command.request_object = session_template_object
731
- command.response_representation = Google::Apis::DataprocV1::SessionTemplate::Representation
732
- command.response_class = Google::Apis::DataprocV1::SessionTemplate
733
- command.params['parent'] = parent unless parent.nil?
743
+ def access_project_location_batch_spark_application_sql_query(name, details: nil, execution_id: nil, parent: nil, plan_description: nil, fields: nil, quota_user: nil, options: nil, &block)
744
+ command = make_simple_command(:get, 'v1/{+name}:accessSqlQuery', options)
745
+ command.response_representation = Google::Apis::DataprocV1::AccessSparkApplicationSqlQueryResponse::Representation
746
+ command.response_class = Google::Apis::DataprocV1::AccessSparkApplicationSqlQueryResponse
747
+ command.params['name'] = name unless name.nil?
748
+ command.query['details'] = details unless details.nil?
749
+ command.query['executionId'] = execution_id unless execution_id.nil?
750
+ command.query['parent'] = parent unless parent.nil?
751
+ command.query['planDescription'] = plan_description unless plan_description.nil?
734
752
  command.query['fields'] = fields unless fields.nil?
735
753
  command.query['quotaUser'] = quota_user unless quota_user.nil?
736
754
  execute_or_queue_command(command, &block)
737
755
  end
738
756
 
739
- # Deletes a session template.
757
+ # Obtain data corresponding to a spark stage attempt for a Spark Application.
740
758
  # @param [String] name
741
- # Required. The name of the session template resource to delete.
759
+ # Required. The fully qualified name of the batch to retrieve in the format "
760
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/
761
+ # sparkApplications/APPLICATION_ID"
762
+ # @param [String] parent
763
+ # Required. Parent (Batch) resource reference.
764
+ # @param [Fixnum] stage_attempt_id
765
+ # Required. Stage Attempt ID
766
+ # @param [Fixnum] stage_id
767
+ # Required. Stage ID
768
+ # @param [String] summary_metrics_mask
769
+ # Optional. The list of summary metrics fields to include. Empty list will
770
+ # default to skip all summary metrics fields. Example, if the response should
771
+ # include TaskQuantileMetrics, the request should have task_quantile_metrics in
772
+ # summary_metrics_mask field
742
773
  # @param [String] fields
743
774
  # Selector specifying which fields to include in a partial response.
744
775
  # @param [String] quota_user
@@ -748,27 +779,38 @@ module Google
748
779
  # Request-specific options
749
780
  #
750
781
  # @yield [result, err] Result & error if block supplied
751
- # @yieldparam result [Google::Apis::DataprocV1::Empty] parsed result object
782
+ # @yieldparam result [Google::Apis::DataprocV1::AccessSparkApplicationStageAttemptResponse] parsed result object
752
783
  # @yieldparam err [StandardError] error object if request failed
753
784
  #
754
- # @return [Google::Apis::DataprocV1::Empty]
785
+ # @return [Google::Apis::DataprocV1::AccessSparkApplicationStageAttemptResponse]
755
786
  #
756
787
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
757
788
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
758
789
  # @raise [Google::Apis::AuthorizationError] Authorization is required
759
- def delete_project_location_session_template(name, fields: nil, quota_user: nil, options: nil, &block)
760
- command = make_simple_command(:delete, 'v1/{+name}', options)
761
- command.response_representation = Google::Apis::DataprocV1::Empty::Representation
762
- command.response_class = Google::Apis::DataprocV1::Empty
790
+ def access_project_location_batch_spark_application_stage_attempt(name, parent: nil, stage_attempt_id: nil, stage_id: nil, summary_metrics_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
791
+ command = make_simple_command(:get, 'v1/{+name}:accessStageAttempt', options)
792
+ command.response_representation = Google::Apis::DataprocV1::AccessSparkApplicationStageAttemptResponse::Representation
793
+ command.response_class = Google::Apis::DataprocV1::AccessSparkApplicationStageAttemptResponse
763
794
  command.params['name'] = name unless name.nil?
795
+ command.query['parent'] = parent unless parent.nil?
796
+ command.query['stageAttemptId'] = stage_attempt_id unless stage_attempt_id.nil?
797
+ command.query['stageId'] = stage_id unless stage_id.nil?
798
+ command.query['summaryMetricsMask'] = summary_metrics_mask unless summary_metrics_mask.nil?
764
799
  command.query['fields'] = fields unless fields.nil?
765
800
  command.query['quotaUser'] = quota_user unless quota_user.nil?
766
801
  execute_or_queue_command(command, &block)
767
802
  end
768
803
 
769
- # Gets the resource representation for a session template.
804
+ # Obtain RDD operation graph for a Spark Application Stage. Limits the number of
805
+ # clusters returned as part of the graph to 10000.
770
806
  # @param [String] name
771
- # Required. The name of the session template to retrieve.
807
+ # Required. The fully qualified name of the batch to retrieve in the format "
808
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/
809
+ # sparkApplications/APPLICATION_ID"
810
+ # @param [String] parent
811
+ # Required. Parent (Batch) resource reference.
812
+ # @param [Fixnum] stage_id
813
+ # Required. Stage ID
772
814
  # @param [String] fields
773
815
  # Selector specifying which fields to include in a partial response.
774
816
  # @param [String] quota_user
@@ -778,37 +820,48 @@ module Google
778
820
  # Request-specific options
779
821
  #
780
822
  # @yield [result, err] Result & error if block supplied
781
- # @yieldparam result [Google::Apis::DataprocV1::SessionTemplate] parsed result object
823
+ # @yieldparam result [Google::Apis::DataprocV1::AccessSparkApplicationStageRddOperationGraphResponse] parsed result object
782
824
  # @yieldparam err [StandardError] error object if request failed
783
825
  #
784
- # @return [Google::Apis::DataprocV1::SessionTemplate]
826
+ # @return [Google::Apis::DataprocV1::AccessSparkApplicationStageRddOperationGraphResponse]
785
827
  #
786
828
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
787
829
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
788
830
  # @raise [Google::Apis::AuthorizationError] Authorization is required
789
- def get_project_location_session_template(name, fields: nil, quota_user: nil, options: nil, &block)
790
- command = make_simple_command(:get, 'v1/{+name}', options)
791
- command.response_representation = Google::Apis::DataprocV1::SessionTemplate::Representation
792
- command.response_class = Google::Apis::DataprocV1::SessionTemplate
831
+ def access_project_location_batch_spark_application_stage_rdd_graph(name, parent: nil, stage_id: nil, fields: nil, quota_user: nil, options: nil, &block)
832
+ command = make_simple_command(:get, 'v1/{+name}:accessStageRddGraph', options)
833
+ command.response_representation = Google::Apis::DataprocV1::AccessSparkApplicationStageRddOperationGraphResponse::Representation
834
+ command.response_class = Google::Apis::DataprocV1::AccessSparkApplicationStageRddOperationGraphResponse
793
835
  command.params['name'] = name unless name.nil?
836
+ command.query['parent'] = parent unless parent.nil?
837
+ command.query['stageId'] = stage_id unless stage_id.nil?
794
838
  command.query['fields'] = fields unless fields.nil?
795
839
  command.query['quotaUser'] = quota_user unless quota_user.nil?
796
840
  execute_or_queue_command(command, &block)
797
841
  end
798
842
 
799
- # Lists session templates.
843
+ # Obtain high level information and list of Spark Applications corresponding to
844
+ # a batch
800
845
  # @param [String] parent
801
- # Required. The parent that owns this collection of session templates.
802
- # @param [String] filter
803
- # Optional. A filter for the session templates to return in the response.
804
- # Filters are case sensitive and have the following syntax:field = value AND
805
- # field = value ...
846
+ # Required. The fully qualified name of the batch to retrieve in the format "
847
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID"
848
+ # @param [String] application_status
849
+ # Optional. Search only applications in the chosen state.
850
+ # @param [String] max_end_time
851
+ # Optional. Latest end timestamp to list.
852
+ # @param [String] max_time
853
+ # Optional. Latest start timestamp to list.
854
+ # @param [String] min_end_time
855
+ # Optional. Earliest end timestamp to list.
856
+ # @param [String] min_time
857
+ # Optional. Earliest start timestamp to list.
806
858
  # @param [Fixnum] page_size
807
- # Optional. The maximum number of sessions to return in each response. The
808
- # service may return fewer than this value.
859
+ # Optional. Maximum number of applications to return in each response. The
860
+ # service may return fewer than this. The default page size is 10; the maximum
861
+ # page size is 100.
809
862
  # @param [String] page_token
810
- # Optional. A page token received from a previous ListSessions call. Provide
811
- # this token to retrieve the subsequent page.
863
+ # Optional. A page token received from a previous SearchSparkApplications call.
864
+ # Provide this token to retrieve the subsequent page.
812
865
  # @param [String] fields
813
866
  # Selector specifying which fields to include in a partial response.
814
867
  # @param [String] quota_user
@@ -818,20 +871,24 @@ module Google
818
871
  # Request-specific options
819
872
  #
820
873
  # @yield [result, err] Result & error if block supplied
821
- # @yieldparam result [Google::Apis::DataprocV1::ListSessionTemplatesResponse] parsed result object
874
+ # @yieldparam result [Google::Apis::DataprocV1::SearchSparkApplicationsResponse] parsed result object
822
875
  # @yieldparam err [StandardError] error object if request failed
823
876
  #
824
- # @return [Google::Apis::DataprocV1::ListSessionTemplatesResponse]
877
+ # @return [Google::Apis::DataprocV1::SearchSparkApplicationsResponse]
825
878
  #
826
879
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
827
880
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
828
881
  # @raise [Google::Apis::AuthorizationError] Authorization is required
829
- def list_project_location_session_templates(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
830
- command = make_simple_command(:get, 'v1/{+parent}/sessionTemplates', options)
831
- command.response_representation = Google::Apis::DataprocV1::ListSessionTemplatesResponse::Representation
832
- command.response_class = Google::Apis::DataprocV1::ListSessionTemplatesResponse
882
+ def search_project_location_batch_spark_applications(parent, application_status: nil, max_end_time: nil, max_time: nil, min_end_time: nil, min_time: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
883
+ command = make_simple_command(:get, 'v1/{+parent}/sparkApplications:search', options)
884
+ command.response_representation = Google::Apis::DataprocV1::SearchSparkApplicationsResponse::Representation
885
+ command.response_class = Google::Apis::DataprocV1::SearchSparkApplicationsResponse
833
886
  command.params['parent'] = parent unless parent.nil?
834
- command.query['filter'] = filter unless filter.nil?
887
+ command.query['applicationStatus'] = application_status unless application_status.nil?
888
+ command.query['maxEndTime'] = max_end_time unless max_end_time.nil?
889
+ command.query['maxTime'] = max_time unless max_time.nil?
890
+ command.query['minEndTime'] = min_end_time unless min_end_time.nil?
891
+ command.query['minTime'] = min_time unless min_time.nil?
835
892
  command.query['pageSize'] = page_size unless page_size.nil?
836
893
  command.query['pageToken'] = page_token unless page_token.nil?
837
894
  command.query['fields'] = fields unless fields.nil?
@@ -839,10 +896,25 @@ module Google
839
896
  execute_or_queue_command(command, &block)
840
897
  end
841
898
 
842
- # Updates the session template synchronously.
899
+ # Obtain executor summary with respect to a spark stage attempt.
843
900
  # @param [String] name
844
- # Required. The resource name of the session template.
845
- # @param [Google::Apis::DataprocV1::SessionTemplate] session_template_object
901
+ # Required. The fully qualified name of the batch to retrieve in the format "
902
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/
903
+ # sparkApplications/APPLICATION_ID"
904
+ # @param [Fixnum] page_size
905
+ # Optional. Maximum number of executors to return in each response. The service
906
+ # may return fewer than this. The default page size is 10; the maximum page size
907
+ # is 100.
908
+ # @param [String] page_token
909
+ # Optional. A page token received from a previous
910
+ # AccessSparkApplicationExecutorsList call. Provide this token to retrieve the
911
+ # subsequent page.
912
+ # @param [String] parent
913
+ # Required. Parent (Batch) resource reference.
914
+ # @param [Fixnum] stage_attempt_id
915
+ # Required. Stage Attempt ID
916
+ # @param [Fixnum] stage_id
917
+ # Required. Stage ID
846
918
  # @param [String] fields
847
919
  # Selector specifying which fields to include in a partial response.
848
920
  # @param [String] quota_user
@@ -852,43 +924,47 @@ module Google
852
924
  # Request-specific options
853
925
  #
854
926
  # @yield [result, err] Result & error if block supplied
855
- # @yieldparam result [Google::Apis::DataprocV1::SessionTemplate] parsed result object
927
+ # @yieldparam result [Google::Apis::DataprocV1::SearchSparkApplicationExecutorStageSummaryResponse] parsed result object
856
928
  # @yieldparam err [StandardError] error object if request failed
857
929
  #
858
- # @return [Google::Apis::DataprocV1::SessionTemplate]
930
+ # @return [Google::Apis::DataprocV1::SearchSparkApplicationExecutorStageSummaryResponse]
859
931
  #
860
932
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
861
933
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
862
934
  # @raise [Google::Apis::AuthorizationError] Authorization is required
863
- def patch_project_location_session_template(name, session_template_object = nil, fields: nil, quota_user: nil, options: nil, &block)
864
- command = make_simple_command(:patch, 'v1/{+name}', options)
865
- command.request_representation = Google::Apis::DataprocV1::SessionTemplate::Representation
866
- command.request_object = session_template_object
867
- command.response_representation = Google::Apis::DataprocV1::SessionTemplate::Representation
868
- command.response_class = Google::Apis::DataprocV1::SessionTemplate
935
+ def search_project_location_batch_spark_application_executor_stage_summary(name, page_size: nil, page_token: nil, parent: nil, stage_attempt_id: nil, stage_id: nil, fields: nil, quota_user: nil, options: nil, &block)
936
+ command = make_simple_command(:get, 'v1/{+name}:searchExecutorStageSummary', options)
937
+ command.response_representation = Google::Apis::DataprocV1::SearchSparkApplicationExecutorStageSummaryResponse::Representation
938
+ command.response_class = Google::Apis::DataprocV1::SearchSparkApplicationExecutorStageSummaryResponse
869
939
  command.params['name'] = name unless name.nil?
940
+ command.query['pageSize'] = page_size unless page_size.nil?
941
+ command.query['pageToken'] = page_token unless page_token.nil?
942
+ command.query['parent'] = parent unless parent.nil?
943
+ command.query['stageAttemptId'] = stage_attempt_id unless stage_attempt_id.nil?
944
+ command.query['stageId'] = stage_id unless stage_id.nil?
870
945
  command.query['fields'] = fields unless fields.nil?
871
946
  command.query['quotaUser'] = quota_user unless quota_user.nil?
872
947
  execute_or_queue_command(command, &block)
873
948
  end
874
949
 
875
- # Create an interactive session asynchronously.
950
+ # Obtain data corresponding to executors for a Spark Application.
951
+ # @param [String] name
952
+ # Required. The fully qualified name of the batch to retrieve in the format "
953
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/
954
+ # sparkApplications/APPLICATION_ID"
955
+ # @param [String] executor_status
956
+ # Optional. Filter to select whether active/ dead or all executors should be
957
+ # selected.
958
+ # @param [Fixnum] page_size
959
+ # Optional. Maximum number of executors to return in each response. The service
960
+ # may return fewer than this. The default page size is 10; the maximum page size
961
+ # is 100.
962
+ # @param [String] page_token
963
+ # Optional. A page token received from a previous
964
+ # AccessSparkApplicationExecutorsList call. Provide this token to retrieve the
965
+ # subsequent page.
876
966
  # @param [String] parent
877
- # Required. The parent resource where this session will be created.
878
- # @param [Google::Apis::DataprocV1::Session] session_object
879
- # @param [String] request_id
880
- # Optional. A unique ID used to identify the request. If the service receives
881
- # two CreateSessionRequests (https://cloud.google.com/dataproc/docs/reference/
882
- # rpc/google.cloud.dataproc.v1#google.cloud.dataproc.v1.CreateSessionRequest)s
883
- # with the same ID, the second request is ignored, and the first Session is
884
- # created and stored in the backend.Recommendation: Set this value to a UUID (
885
- # https://en.wikipedia.org/wiki/Universally_unique_identifier).The value must
886
- # contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-
887
- # ). The maximum length is 40 characters.
888
- # @param [String] session_id
889
- # Required. The ID to use for the session, which becomes the final component of
890
- # the session's resource name.This value must be 4-63 characters. Valid
891
- # characters are /a-z-/.
967
+ # Required. Parent (Batch) resource reference.
892
968
  # @param [String] fields
893
969
  # Selector specifying which fields to include in a partial response.
894
970
  # @param [String] quota_user
@@ -898,40 +974,44 @@ module Google
898
974
  # Request-specific options
899
975
  #
900
976
  # @yield [result, err] Result & error if block supplied
901
- # @yieldparam result [Google::Apis::DataprocV1::Operation] parsed result object
977
+ # @yieldparam result [Google::Apis::DataprocV1::SearchSparkApplicationExecutorsResponse] parsed result object
902
978
  # @yieldparam err [StandardError] error object if request failed
903
979
  #
904
- # @return [Google::Apis::DataprocV1::Operation]
980
+ # @return [Google::Apis::DataprocV1::SearchSparkApplicationExecutorsResponse]
905
981
  #
906
982
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
907
983
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
908
984
  # @raise [Google::Apis::AuthorizationError] Authorization is required
909
- def create_project_location_session(parent, session_object = nil, request_id: nil, session_id: nil, fields: nil, quota_user: nil, options: nil, &block)
910
- command = make_simple_command(:post, 'v1/{+parent}/sessions', options)
911
- command.request_representation = Google::Apis::DataprocV1::Session::Representation
912
- command.request_object = session_object
913
- command.response_representation = Google::Apis::DataprocV1::Operation::Representation
914
- command.response_class = Google::Apis::DataprocV1::Operation
915
- command.params['parent'] = parent unless parent.nil?
916
- command.query['requestId'] = request_id unless request_id.nil?
917
- command.query['sessionId'] = session_id unless session_id.nil?
985
+ def search_project_location_batch_spark_application_executors(name, executor_status: nil, page_size: nil, page_token: nil, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
986
+ command = make_simple_command(:get, 'v1/{+name}:searchExecutors', options)
987
+ command.response_representation = Google::Apis::DataprocV1::SearchSparkApplicationExecutorsResponse::Representation
988
+ command.response_class = Google::Apis::DataprocV1::SearchSparkApplicationExecutorsResponse
989
+ command.params['name'] = name unless name.nil?
990
+ command.query['executorStatus'] = executor_status unless executor_status.nil?
991
+ command.query['pageSize'] = page_size unless page_size.nil?
992
+ command.query['pageToken'] = page_token unless page_token.nil?
993
+ command.query['parent'] = parent unless parent.nil?
918
994
  command.query['fields'] = fields unless fields.nil?
919
995
  command.query['quotaUser'] = quota_user unless quota_user.nil?
920
996
  execute_or_queue_command(command, &block)
921
997
  end
922
998
 
923
- # Deletes the interactive session resource. If the session is not in terminal
924
- # state, it is terminated, and then deleted.
999
+ # Obtain list of spark jobs corresponding to a Spark Application.
925
1000
  # @param [String] name
926
- # Required. The name of the session resource to delete.
927
- # @param [String] request_id
928
- # Optional. A unique ID used to identify the request. If the service receives
929
- # two DeleteSessionRequest (https://cloud.google.com/dataproc/docs/reference/rpc/
930
- # google.cloud.dataproc.v1#google.cloud.dataproc.v1.DeleteSessionRequest)s with
931
- # the same ID, the second request is ignored.Recommendation: Set this value to a
932
- # UUID (https://en.wikipedia.org/wiki/Universally_unique_identifier).The value
933
- # must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and
934
- # hyphens (-). The maximum length is 40 characters.
1001
+ # Required. The fully qualified name of the batch to retrieve in the format "
1002
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/
1003
+ # sparkApplications/APPLICATION_ID"
1004
+ # @param [String] job_status
1005
+ # Optional. List only jobs in the specific state.
1006
+ # @param [Fixnum] page_size
1007
+ # Optional. Maximum number of jobs to return in each response. The service may
1008
+ # return fewer than this. The default page size is 10; the maximum page size is
1009
+ # 100.
1010
+ # @param [String] page_token
1011
+ # Optional. A page token received from a previous SearchSparkApplicationJobs
1012
+ # call. Provide this token to retrieve the subsequent page.
1013
+ # @param [String] parent
1014
+ # Required. Parent (Batch) resource reference.
935
1015
  # @param [String] fields
936
1016
  # Selector specifying which fields to include in a partial response.
937
1017
  # @param [String] quota_user
@@ -941,28 +1021,48 @@ module Google
941
1021
  # Request-specific options
942
1022
  #
943
1023
  # @yield [result, err] Result & error if block supplied
944
- # @yieldparam result [Google::Apis::DataprocV1::Operation] parsed result object
1024
+ # @yieldparam result [Google::Apis::DataprocV1::SearchSparkApplicationJobsResponse] parsed result object
945
1025
  # @yieldparam err [StandardError] error object if request failed
946
1026
  #
947
- # @return [Google::Apis::DataprocV1::Operation]
1027
+ # @return [Google::Apis::DataprocV1::SearchSparkApplicationJobsResponse]
948
1028
  #
949
1029
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
950
1030
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
951
1031
  # @raise [Google::Apis::AuthorizationError] Authorization is required
952
- def delete_project_location_session(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
953
- command = make_simple_command(:delete, 'v1/{+name}', options)
954
- command.response_representation = Google::Apis::DataprocV1::Operation::Representation
955
- command.response_class = Google::Apis::DataprocV1::Operation
1032
+ def search_project_location_batch_spark_application_jobs(name, job_status: nil, page_size: nil, page_token: nil, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
1033
+ command = make_simple_command(:get, 'v1/{+name}:searchJobs', options)
1034
+ command.response_representation = Google::Apis::DataprocV1::SearchSparkApplicationJobsResponse::Representation
1035
+ command.response_class = Google::Apis::DataprocV1::SearchSparkApplicationJobsResponse
956
1036
  command.params['name'] = name unless name.nil?
957
- command.query['requestId'] = request_id unless request_id.nil?
1037
+ command.query['jobStatus'] = job_status unless job_status.nil?
1038
+ command.query['pageSize'] = page_size unless page_size.nil?
1039
+ command.query['pageToken'] = page_token unless page_token.nil?
1040
+ command.query['parent'] = parent unless parent.nil?
958
1041
  command.query['fields'] = fields unless fields.nil?
959
1042
  command.query['quotaUser'] = quota_user unless quota_user.nil?
960
1043
  execute_or_queue_command(command, &block)
961
1044
  end
962
1045
 
963
- # Gets the resource representation for an interactive session.
1046
+ # Obtain data corresponding to SQL Queries for a Spark Application.
964
1047
  # @param [String] name
965
- # Required. The name of the session to retrieve.
1048
+ # Required. The fully qualified name of the batch to retrieve in the format "
1049
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/
1050
+ # sparkApplications/APPLICATION_ID"
1051
+ # @param [Boolean] details
1052
+ # Optional. Lists/ hides details of Spark plan nodes. True is set to list and
1053
+ # false to hide.
1054
+ # @param [Fixnum] page_size
1055
+ # Optional. Maximum number of queries to return in each response. The service
1056
+ # may return fewer than this. The default page size is 10; the maximum page size
1057
+ # is 100.
1058
+ # @param [String] page_token
1059
+ # Optional. A page token received from a previous
1060
+ # SearchSparkApplicationSqlQueries call. Provide this token to retrieve the
1061
+ # subsequent page.
1062
+ # @param [String] parent
1063
+ # Required. Parent (Batch) resource reference.
1064
+ # @param [Boolean] plan_description
1065
+ # Optional. Enables/ disables physical plan description on demand
966
1066
  # @param [String] fields
967
1067
  # Selector specifying which fields to include in a partial response.
968
1068
  # @param [String] quota_user
@@ -972,45 +1072,53 @@ module Google
972
1072
  # Request-specific options
973
1073
  #
974
1074
  # @yield [result, err] Result & error if block supplied
975
- # @yieldparam result [Google::Apis::DataprocV1::Session] parsed result object
1075
+ # @yieldparam result [Google::Apis::DataprocV1::SearchSparkApplicationSqlQueriesResponse] parsed result object
976
1076
  # @yieldparam err [StandardError] error object if request failed
977
1077
  #
978
- # @return [Google::Apis::DataprocV1::Session]
1078
+ # @return [Google::Apis::DataprocV1::SearchSparkApplicationSqlQueriesResponse]
979
1079
  #
980
1080
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
981
1081
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
982
1082
  # @raise [Google::Apis::AuthorizationError] Authorization is required
983
- def get_project_location_session(name, fields: nil, quota_user: nil, options: nil, &block)
984
- command = make_simple_command(:get, 'v1/{+name}', options)
985
- command.response_representation = Google::Apis::DataprocV1::Session::Representation
986
- command.response_class = Google::Apis::DataprocV1::Session
1083
+ def search_project_location_batch_spark_application_sql_queries(name, details: nil, page_size: nil, page_token: nil, parent: nil, plan_description: nil, fields: nil, quota_user: nil, options: nil, &block)
1084
+ command = make_simple_command(:get, 'v1/{+name}:searchSqlQueries', options)
1085
+ command.response_representation = Google::Apis::DataprocV1::SearchSparkApplicationSqlQueriesResponse::Representation
1086
+ command.response_class = Google::Apis::DataprocV1::SearchSparkApplicationSqlQueriesResponse
987
1087
  command.params['name'] = name unless name.nil?
1088
+ command.query['details'] = details unless details.nil?
1089
+ command.query['pageSize'] = page_size unless page_size.nil?
1090
+ command.query['pageToken'] = page_token unless page_token.nil?
1091
+ command.query['parent'] = parent unless parent.nil?
1092
+ command.query['planDescription'] = plan_description unless plan_description.nil?
988
1093
  command.query['fields'] = fields unless fields.nil?
989
1094
  command.query['quotaUser'] = quota_user unless quota_user.nil?
990
1095
  execute_or_queue_command(command, &block)
991
1096
  end
992
1097
 
993
- # Lists interactive sessions.
994
- # @param [String] parent
995
- # Required. The parent, which owns this collection of sessions.
996
- # @param [String] filter
997
- # Optional. A filter for the sessions to return in the response.A filter is a
998
- # logical expression constraining the values of various fields in each session
999
- # resource. Filters are case sensitive, and may contain multiple clauses
1000
- # combined with logical operators (AND, OR). Supported fields are session_id,
1001
- # session_uuid, state, create_time, and labels.Example: state = ACTIVE and
1002
- # create_time < "2023-01-01T00:00:00Z" is a filter for sessions in an ACTIVE
1003
- # state that were created before 2023-01-01. state = ACTIVE and labels.
1004
- # environment=production is a filter for sessions in an ACTIVE state that have a
1005
- # production environment label.See https://google.aip.dev/assets/misc/ebnf-
1006
- # filtering.txt for a detailed description of the filter syntax and a list of
1007
- # supported comparators.
1098
+ # Obtain data corresponding to tasks for a spark stage attempt for a Spark
1099
+ # Application.
1100
+ # @param [String] name
1101
+ # Required. The fully qualified name of the batch to retrieve in the format "
1102
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/
1103
+ # sparkApplications/APPLICATION_ID"
1008
1104
  # @param [Fixnum] page_size
1009
- # Optional. The maximum number of sessions to return in each response. The
1010
- # service may return fewer than this value.
1105
+ # Optional. Maximum number of tasks to return in each response. The service may
1106
+ # return fewer than this. The default page size is 10; the maximum page size is
1107
+ # 100.
1011
1108
  # @param [String] page_token
1012
- # Optional. A page token received from a previous ListSessions call. Provide
1013
- # this token to retrieve the subsequent page.
1109
+ # Optional. A page token received from a previous
1110
+ # ListSparkApplicationStageAttemptTasks call. Provide this token to retrieve the
1111
+ # subsequent page.
1112
+ # @param [String] parent
1113
+ # Required. Parent (Batch) resource reference.
1114
+ # @param [Boolean] sort_runtime
1115
+ # Optional. Sort the tasks by runtime.
1116
+ # @param [Fixnum] stage_attempt_id
1117
+ # Optional. Stage Attempt ID
1118
+ # @param [Fixnum] stage_id
1119
+ # Optional. Stage ID
1120
+ # @param [String] task_status
1121
+ # Optional. List only tasks in the state.
1014
1122
  # @param [String] fields
1015
1123
  # Selector specifying which fields to include in a partial response.
1016
1124
  # @param [String] quota_user
@@ -1020,31 +1128,53 @@ module Google
1020
1128
  # Request-specific options
1021
1129
  #
1022
1130
  # @yield [result, err] Result & error if block supplied
1023
- # @yieldparam result [Google::Apis::DataprocV1::ListSessionsResponse] parsed result object
1131
+ # @yieldparam result [Google::Apis::DataprocV1::SearchSparkApplicationStageAttemptTasksResponse] parsed result object
1024
1132
  # @yieldparam err [StandardError] error object if request failed
1025
1133
  #
1026
- # @return [Google::Apis::DataprocV1::ListSessionsResponse]
1134
+ # @return [Google::Apis::DataprocV1::SearchSparkApplicationStageAttemptTasksResponse]
1027
1135
  #
1028
1136
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1029
1137
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1030
1138
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1031
- def list_project_location_sessions(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1032
- command = make_simple_command(:get, 'v1/{+parent}/sessions', options)
1033
- command.response_representation = Google::Apis::DataprocV1::ListSessionsResponse::Representation
1034
- command.response_class = Google::Apis::DataprocV1::ListSessionsResponse
1035
- command.params['parent'] = parent unless parent.nil?
1036
- command.query['filter'] = filter unless filter.nil?
1139
+ def search_project_location_batch_spark_application_stage_attempt_tasks(name, page_size: nil, page_token: nil, parent: nil, sort_runtime: nil, stage_attempt_id: nil, stage_id: nil, task_status: nil, fields: nil, quota_user: nil, options: nil, &block)
1140
+ command = make_simple_command(:get, 'v1/{+name}:searchStageAttemptTasks', options)
1141
+ command.response_representation = Google::Apis::DataprocV1::SearchSparkApplicationStageAttemptTasksResponse::Representation
1142
+ command.response_class = Google::Apis::DataprocV1::SearchSparkApplicationStageAttemptTasksResponse
1143
+ command.params['name'] = name unless name.nil?
1037
1144
  command.query['pageSize'] = page_size unless page_size.nil?
1038
1145
  command.query['pageToken'] = page_token unless page_token.nil?
1146
+ command.query['parent'] = parent unless parent.nil?
1147
+ command.query['sortRuntime'] = sort_runtime unless sort_runtime.nil?
1148
+ command.query['stageAttemptId'] = stage_attempt_id unless stage_attempt_id.nil?
1149
+ command.query['stageId'] = stage_id unless stage_id.nil?
1150
+ command.query['taskStatus'] = task_status unless task_status.nil?
1039
1151
  command.query['fields'] = fields unless fields.nil?
1040
1152
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1041
1153
  execute_or_queue_command(command, &block)
1042
1154
  end
1043
1155
 
1044
- # Terminates the interactive session.
1156
+ # Obtain data corresponding to a spark stage attempts for a Spark Application.
1045
1157
  # @param [String] name
1046
- # Required. The name of the session resource to terminate.
1047
- # @param [Google::Apis::DataprocV1::TerminateSessionRequest] terminate_session_request_object
1158
+ # Required. The fully qualified name of the batch to retrieve in the format "
1159
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/
1160
+ # sparkApplications/APPLICATION_ID"
1161
+ # @param [Fixnum] page_size
1162
+ # Optional. Maximum number of stage attempts (paging based on stage_attempt_id)
1163
+ # to return in each response. The service may return fewer than this. The
1164
+ # default page size is 10; the maximum page size is 100.
1165
+ # @param [String] page_token
1166
+ # Optional. A page token received from a previous
1167
+ # SearchSparkApplicationStageAttempts call. Provide this token to retrieve the
1168
+ # subsequent page.
1169
+ # @param [String] parent
1170
+ # Required. Parent (Batch) resource reference.
1171
+ # @param [Fixnum] stage_id
1172
+ # Required. Stage ID for which attempts are to be fetched
1173
+ # @param [String] summary_metrics_mask
1174
+ # Optional. The list of summary metrics fields to include. Empty list will
1175
+ # default to skip all summary metrics fields. Example, if the response should
1176
+ # include TaskQuantileMetrics, the request should have task_quantile_metrics in
1177
+ # summary_metrics_mask field
1048
1178
  # @param [String] fields
1049
1179
  # Selector specifying which fields to include in a partial response.
1050
1180
  # @param [String] quota_user
@@ -1054,20 +1184,1651 @@ module Google
1054
1184
  # Request-specific options
1055
1185
  #
1056
1186
  # @yield [result, err] Result & error if block supplied
1057
- # @yieldparam result [Google::Apis::DataprocV1::Operation] parsed result object
1187
+ # @yieldparam result [Google::Apis::DataprocV1::SearchSparkApplicationStageAttemptsResponse] parsed result object
1058
1188
  # @yieldparam err [StandardError] error object if request failed
1059
1189
  #
1060
- # @return [Google::Apis::DataprocV1::Operation]
1190
+ # @return [Google::Apis::DataprocV1::SearchSparkApplicationStageAttemptsResponse]
1061
1191
  #
1062
1192
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1063
1193
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1064
1194
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1065
- def terminate_session(name, terminate_session_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1066
- command = make_simple_command(:post, 'v1/{+name}:terminate', options)
1067
- command.request_representation = Google::Apis::DataprocV1::TerminateSessionRequest::Representation
1068
- command.request_object = terminate_session_request_object
1069
- command.response_representation = Google::Apis::DataprocV1::Operation::Representation
1070
- command.response_class = Google::Apis::DataprocV1::Operation
1195
+ def search_project_location_batch_spark_application_stage_attempts(name, page_size: nil, page_token: nil, parent: nil, stage_id: nil, summary_metrics_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1196
+ command = make_simple_command(:get, 'v1/{+name}:searchStageAttempts', options)
1197
+ command.response_representation = Google::Apis::DataprocV1::SearchSparkApplicationStageAttemptsResponse::Representation
1198
+ command.response_class = Google::Apis::DataprocV1::SearchSparkApplicationStageAttemptsResponse
1199
+ command.params['name'] = name unless name.nil?
1200
+ command.query['pageSize'] = page_size unless page_size.nil?
1201
+ command.query['pageToken'] = page_token unless page_token.nil?
1202
+ command.query['parent'] = parent unless parent.nil?
1203
+ command.query['stageId'] = stage_id unless stage_id.nil?
1204
+ command.query['summaryMetricsMask'] = summary_metrics_mask unless summary_metrics_mask.nil?
1205
+ command.query['fields'] = fields unless fields.nil?
1206
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1207
+ execute_or_queue_command(command, &block)
1208
+ end
1209
+
1210
+ # Obtain data corresponding to stages for a Spark Application.
1211
+ # @param [String] name
1212
+ # Required. The fully qualified name of the batch to retrieve in the format "
1213
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/
1214
+ # sparkApplications/APPLICATION_ID"
1215
+ # @param [Fixnum] page_size
1216
+ # Optional. Maximum number of stages (paging based on stage_id) to return in
1217
+ # each response. The service may return fewer than this. The default page size
1218
+ # is 10; the maximum page size is 100.
1219
+ # @param [String] page_token
1220
+ # Optional. A page token received from a previous
1221
+ # FetchSparkApplicationStagesList call. Provide this token to retrieve the
1222
+ # subsequent page.
1223
+ # @param [String] parent
1224
+ # Required. Parent (Batch) resource reference.
1225
+ # @param [String] stage_status
1226
+ # Optional. List only stages in the given state.
1227
+ # @param [String] summary_metrics_mask
1228
+ # Optional. The list of summary metrics fields to include. Empty list will
1229
+ # default to skip all summary metrics fields. Example, if the response should
1230
+ # include TaskQuantileMetrics, the request should have task_quantile_metrics in
1231
+ # summary_metrics_mask field
1232
+ # @param [String] fields
1233
+ # Selector specifying which fields to include in a partial response.
1234
+ # @param [String] quota_user
1235
+ # Available to use for quota purposes for server-side applications. Can be any
1236
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1237
+ # @param [Google::Apis::RequestOptions] options
1238
+ # Request-specific options
1239
+ #
1240
+ # @yield [result, err] Result & error if block supplied
1241
+ # @yieldparam result [Google::Apis::DataprocV1::SearchSparkApplicationStagesResponse] parsed result object
1242
+ # @yieldparam err [StandardError] error object if request failed
1243
+ #
1244
+ # @return [Google::Apis::DataprocV1::SearchSparkApplicationStagesResponse]
1245
+ #
1246
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1247
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1248
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1249
+ def search_project_location_batch_spark_application_stages(name, page_size: nil, page_token: nil, parent: nil, stage_status: nil, summary_metrics_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1250
+ command = make_simple_command(:get, 'v1/{+name}:searchStages', options)
1251
+ command.response_representation = Google::Apis::DataprocV1::SearchSparkApplicationStagesResponse::Representation
1252
+ command.response_class = Google::Apis::DataprocV1::SearchSparkApplicationStagesResponse
1253
+ command.params['name'] = name unless name.nil?
1254
+ command.query['pageSize'] = page_size unless page_size.nil?
1255
+ command.query['pageToken'] = page_token unless page_token.nil?
1256
+ command.query['parent'] = parent unless parent.nil?
1257
+ command.query['stageStatus'] = stage_status unless stage_status.nil?
1258
+ command.query['summaryMetricsMask'] = summary_metrics_mask unless summary_metrics_mask.nil?
1259
+ command.query['fields'] = fields unless fields.nil?
1260
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1261
+ execute_or_queue_command(command, &block)
1262
+ end
1263
+
1264
+ # Obtain summary of Executor Summary for a Spark Application
1265
+ # @param [String] name
1266
+ # Required. The fully qualified name of the batch to retrieve in the format "
1267
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/
1268
+ # sparkApplications/APPLICATION_ID"
1269
+ # @param [String] parent
1270
+ # Required. Parent (Batch) resource reference.
1271
+ # @param [String] fields
1272
+ # Selector specifying which fields to include in a partial response.
1273
+ # @param [String] quota_user
1274
+ # Available to use for quota purposes for server-side applications. Can be any
1275
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1276
+ # @param [Google::Apis::RequestOptions] options
1277
+ # Request-specific options
1278
+ #
1279
+ # @yield [result, err] Result & error if block supplied
1280
+ # @yieldparam result [Google::Apis::DataprocV1::SummarizeSparkApplicationExecutorsResponse] parsed result object
1281
+ # @yieldparam err [StandardError] error object if request failed
1282
+ #
1283
+ # @return [Google::Apis::DataprocV1::SummarizeSparkApplicationExecutorsResponse]
1284
+ #
1285
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1286
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1287
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1288
+ def summarize_project_location_batch_spark_application_executors(name, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
1289
+ command = make_simple_command(:get, 'v1/{+name}:summarizeExecutors', options)
1290
+ command.response_representation = Google::Apis::DataprocV1::SummarizeSparkApplicationExecutorsResponse::Representation
1291
+ command.response_class = Google::Apis::DataprocV1::SummarizeSparkApplicationExecutorsResponse
1292
+ command.params['name'] = name unless name.nil?
1293
+ command.query['parent'] = parent unless parent.nil?
1294
+ command.query['fields'] = fields unless fields.nil?
1295
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1296
+ execute_or_queue_command(command, &block)
1297
+ end
1298
+
1299
+ # Obtain summary of Jobs for a Spark Application
1300
+ # @param [String] name
1301
+ # Required. The fully qualified name of the batch to retrieve in the format "
1302
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/
1303
+ # sparkApplications/APPLICATION_ID"
1304
+ # @param [String] parent
1305
+ # Required. Parent (Batch) resource reference.
1306
+ # @param [String] fields
1307
+ # Selector specifying which fields to include in a partial response.
1308
+ # @param [String] quota_user
1309
+ # Available to use for quota purposes for server-side applications. Can be any
1310
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1311
+ # @param [Google::Apis::RequestOptions] options
1312
+ # Request-specific options
1313
+ #
1314
+ # @yield [result, err] Result & error if block supplied
1315
+ # @yieldparam result [Google::Apis::DataprocV1::SummarizeSparkApplicationJobsResponse] parsed result object
1316
+ # @yieldparam err [StandardError] error object if request failed
1317
+ #
1318
+ # @return [Google::Apis::DataprocV1::SummarizeSparkApplicationJobsResponse]
1319
+ #
1320
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1321
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1322
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1323
+ def summarize_project_location_batch_spark_application_jobs(name, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
1324
+ command = make_simple_command(:get, 'v1/{+name}:summarizeJobs', options)
1325
+ command.response_representation = Google::Apis::DataprocV1::SummarizeSparkApplicationJobsResponse::Representation
1326
+ command.response_class = Google::Apis::DataprocV1::SummarizeSparkApplicationJobsResponse
1327
+ command.params['name'] = name unless name.nil?
1328
+ command.query['parent'] = parent unless parent.nil?
1329
+ command.query['fields'] = fields unless fields.nil?
1330
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1331
+ execute_or_queue_command(command, &block)
1332
+ end
1333
+
1334
+ # Obtain summary of Tasks for a Spark Application Stage Attempt
1335
+ # @param [String] name
1336
+ # Required. The fully qualified name of the batch to retrieve in the format "
1337
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/
1338
+ # sparkApplications/APPLICATION_ID"
1339
+ # @param [String] parent
1340
+ # Required. Parent (Batch) resource reference.
1341
+ # @param [Fixnum] stage_attempt_id
1342
+ # Required. Stage Attempt ID
1343
+ # @param [Fixnum] stage_id
1344
+ # Required. Stage ID
1345
+ # @param [String] fields
1346
+ # Selector specifying which fields to include in a partial response.
1347
+ # @param [String] quota_user
1348
+ # Available to use for quota purposes for server-side applications. Can be any
1349
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1350
+ # @param [Google::Apis::RequestOptions] options
1351
+ # Request-specific options
1352
+ #
1353
+ # @yield [result, err] Result & error if block supplied
1354
+ # @yieldparam result [Google::Apis::DataprocV1::SummarizeSparkApplicationStageAttemptTasksResponse] parsed result object
1355
+ # @yieldparam err [StandardError] error object if request failed
1356
+ #
1357
+ # @return [Google::Apis::DataprocV1::SummarizeSparkApplicationStageAttemptTasksResponse]
1358
+ #
1359
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1360
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1361
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1362
+ def summarize_project_location_batch_spark_application_stage_attempt_tasks(name, parent: nil, stage_attempt_id: nil, stage_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1363
+ command = make_simple_command(:get, 'v1/{+name}:summarizeStageAttemptTasks', options)
1364
+ command.response_representation = Google::Apis::DataprocV1::SummarizeSparkApplicationStageAttemptTasksResponse::Representation
1365
+ command.response_class = Google::Apis::DataprocV1::SummarizeSparkApplicationStageAttemptTasksResponse
1366
+ command.params['name'] = name unless name.nil?
1367
+ command.query['parent'] = parent unless parent.nil?
1368
+ command.query['stageAttemptId'] = stage_attempt_id unless stage_attempt_id.nil?
1369
+ command.query['stageId'] = stage_id unless stage_id.nil?
1370
+ command.query['fields'] = fields unless fields.nil?
1371
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1372
+ execute_or_queue_command(command, &block)
1373
+ end
1374
+
1375
+ # Obtain summary of Stages for a Spark Application
1376
+ # @param [String] name
1377
+ # Required. The fully qualified name of the batch to retrieve in the format "
1378
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/batches/BATCH_ID/
1379
+ # sparkApplications/APPLICATION_ID"
1380
+ # @param [String] parent
1381
+ # Required. Parent (Batch) resource reference.
1382
+ # @param [String] fields
1383
+ # Selector specifying which fields to include in a partial response.
1384
+ # @param [String] quota_user
1385
+ # Available to use for quota purposes for server-side applications. Can be any
1386
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1387
+ # @param [Google::Apis::RequestOptions] options
1388
+ # Request-specific options
1389
+ #
1390
+ # @yield [result, err] Result & error if block supplied
1391
+ # @yieldparam result [Google::Apis::DataprocV1::SummarizeSparkApplicationStagesResponse] parsed result object
1392
+ # @yieldparam err [StandardError] error object if request failed
1393
+ #
1394
+ # @return [Google::Apis::DataprocV1::SummarizeSparkApplicationStagesResponse]
1395
+ #
1396
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1397
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1398
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1399
+ def summarize_project_location_batch_spark_application_stages(name, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
1400
+ command = make_simple_command(:get, 'v1/{+name}:summarizeStages', options)
1401
+ command.response_representation = Google::Apis::DataprocV1::SummarizeSparkApplicationStagesResponse::Representation
1402
+ command.response_class = Google::Apis::DataprocV1::SummarizeSparkApplicationStagesResponse
1403
+ command.params['name'] = name unless name.nil?
1404
+ command.query['parent'] = parent unless parent.nil?
1405
+ command.query['fields'] = fields unless fields.nil?
1406
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1407
+ execute_or_queue_command(command, &block)
1408
+ end
1409
+
1410
+ # Write wrapper objects from dataplane to spanner
1411
+ # @param [String] name
1412
+ # Required. The fully qualified name of the spark application to write data
1413
+ # about in the format "projects/PROJECT_ID/locations/DATAPROC_REGION/batches/
1414
+ # BATCH_ID/sparkApplications/APPLICATION_ID"
1415
+ # @param [Google::Apis::DataprocV1::WriteSparkApplicationContextRequest] write_spark_application_context_request_object
1416
+ # @param [String] fields
1417
+ # Selector specifying which fields to include in a partial response.
1418
+ # @param [String] quota_user
1419
+ # Available to use for quota purposes for server-side applications. Can be any
1420
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1421
+ # @param [Google::Apis::RequestOptions] options
1422
+ # Request-specific options
1423
+ #
1424
+ # @yield [result, err] Result & error if block supplied
1425
+ # @yieldparam result [Google::Apis::DataprocV1::WriteSparkApplicationContextResponse] parsed result object
1426
+ # @yieldparam err [StandardError] error object if request failed
1427
+ #
1428
+ # @return [Google::Apis::DataprocV1::WriteSparkApplicationContextResponse]
1429
+ #
1430
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1431
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1432
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1433
+ def write_spark_application_context(name, write_spark_application_context_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1434
+ command = make_simple_command(:post, 'v1/{+name}:write', options)
1435
+ command.request_representation = Google::Apis::DataprocV1::WriteSparkApplicationContextRequest::Representation
1436
+ command.request_object = write_spark_application_context_request_object
1437
+ command.response_representation = Google::Apis::DataprocV1::WriteSparkApplicationContextResponse::Representation
1438
+ command.response_class = Google::Apis::DataprocV1::WriteSparkApplicationContextResponse
1439
+ command.params['name'] = name unless name.nil?
1440
+ command.query['fields'] = fields unless fields.nil?
1441
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1442
+ execute_or_queue_command(command, &block)
1443
+ end
1444
+
1445
+ # Starts asynchronous cancellation on a long-running operation. The server makes
1446
+ # a best effort to cancel the operation, but success is not guaranteed. If the
1447
+ # server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
1448
+ # Clients can use Operations.GetOperation or other methods to check whether the
1449
+ # cancellation succeeded or whether the operation completed despite cancellation.
1450
+ # On successful cancellation, the operation is not deleted; instead, it becomes
1451
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
1452
+ # corresponding to Code.CANCELLED.
1453
+ # @param [String] name
1454
+ # The name of the operation resource to be cancelled.
1455
+ # @param [String] fields
1456
+ # Selector specifying which fields to include in a partial response.
1457
+ # @param [String] quota_user
1458
+ # Available to use for quota purposes for server-side applications. Can be any
1459
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1460
+ # @param [Google::Apis::RequestOptions] options
1461
+ # Request-specific options
1462
+ #
1463
+ # @yield [result, err] Result & error if block supplied
1464
+ # @yieldparam result [Google::Apis::DataprocV1::Empty] parsed result object
1465
+ # @yieldparam err [StandardError] error object if request failed
1466
+ #
1467
+ # @return [Google::Apis::DataprocV1::Empty]
1468
+ #
1469
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1470
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1471
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1472
+ def cancel_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
1473
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
1474
+ command.response_representation = Google::Apis::DataprocV1::Empty::Representation
1475
+ command.response_class = Google::Apis::DataprocV1::Empty
1476
+ command.params['name'] = name unless name.nil?
1477
+ command.query['fields'] = fields unless fields.nil?
1478
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1479
+ execute_or_queue_command(command, &block)
1480
+ end
1481
+
1482
+ # Deletes a long-running operation. This method indicates that the client is no
1483
+ # longer interested in the operation result. It does not cancel the operation.
1484
+ # If the server doesn't support this method, it returns google.rpc.Code.
1485
+ # UNIMPLEMENTED.
1486
+ # @param [String] name
1487
+ # The name of the operation resource to be deleted.
1488
+ # @param [String] fields
1489
+ # Selector specifying which fields to include in a partial response.
1490
+ # @param [String] quota_user
1491
+ # Available to use for quota purposes for server-side applications. Can be any
1492
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1493
+ # @param [Google::Apis::RequestOptions] options
1494
+ # Request-specific options
1495
+ #
1496
+ # @yield [result, err] Result & error if block supplied
1497
+ # @yieldparam result [Google::Apis::DataprocV1::Empty] parsed result object
1498
+ # @yieldparam err [StandardError] error object if request failed
1499
+ #
1500
+ # @return [Google::Apis::DataprocV1::Empty]
1501
+ #
1502
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1503
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1504
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1505
+ def delete_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
1506
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1507
+ command.response_representation = Google::Apis::DataprocV1::Empty::Representation
1508
+ command.response_class = Google::Apis::DataprocV1::Empty
1509
+ command.params['name'] = name unless name.nil?
1510
+ command.query['fields'] = fields unless fields.nil?
1511
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1512
+ execute_or_queue_command(command, &block)
1513
+ end
1514
+
1515
+ # Gets the latest state of a long-running operation. Clients can use this method
1516
+ # to poll the operation result at intervals as recommended by the API service.
1517
+ # @param [String] name
1518
+ # The name of the operation resource.
1519
+ # @param [String] fields
1520
+ # Selector specifying which fields to include in a partial response.
1521
+ # @param [String] quota_user
1522
+ # Available to use for quota purposes for server-side applications. Can be any
1523
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1524
+ # @param [Google::Apis::RequestOptions] options
1525
+ # Request-specific options
1526
+ #
1527
+ # @yield [result, err] Result & error if block supplied
1528
+ # @yieldparam result [Google::Apis::DataprocV1::Operation] parsed result object
1529
+ # @yieldparam err [StandardError] error object if request failed
1530
+ #
1531
+ # @return [Google::Apis::DataprocV1::Operation]
1532
+ #
1533
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1534
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1535
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1536
+ def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
1537
+ command = make_simple_command(:get, 'v1/{+name}', options)
1538
+ command.response_representation = Google::Apis::DataprocV1::Operation::Representation
1539
+ command.response_class = Google::Apis::DataprocV1::Operation
1540
+ command.params['name'] = name unless name.nil?
1541
+ command.query['fields'] = fields unless fields.nil?
1542
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1543
+ execute_or_queue_command(command, &block)
1544
+ end
1545
+
1546
+ # Lists operations that match the specified filter in the request. If the server
1547
+ # doesn't support this method, it returns UNIMPLEMENTED.
1548
+ # @param [String] name
1549
+ # The name of the operation's parent resource.
1550
+ # @param [String] filter
1551
+ # The standard list filter.
1552
+ # @param [Fixnum] page_size
1553
+ # The standard list page size.
1554
+ # @param [String] page_token
1555
+ # The standard list page token.
1556
+ # @param [String] fields
1557
+ # Selector specifying which fields to include in a partial response.
1558
+ # @param [String] quota_user
1559
+ # Available to use for quota purposes for server-side applications. Can be any
1560
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1561
+ # @param [Google::Apis::RequestOptions] options
1562
+ # Request-specific options
1563
+ #
1564
+ # @yield [result, err] Result & error if block supplied
1565
+ # @yieldparam result [Google::Apis::DataprocV1::ListOperationsResponse] parsed result object
1566
+ # @yieldparam err [StandardError] error object if request failed
1567
+ #
1568
+ # @return [Google::Apis::DataprocV1::ListOperationsResponse]
1569
+ #
1570
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1571
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1572
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1573
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1574
+ command = make_simple_command(:get, 'v1/{+name}', options)
1575
+ command.response_representation = Google::Apis::DataprocV1::ListOperationsResponse::Representation
1576
+ command.response_class = Google::Apis::DataprocV1::ListOperationsResponse
1577
+ command.params['name'] = name unless name.nil?
1578
+ command.query['filter'] = filter unless filter.nil?
1579
+ command.query['pageSize'] = page_size unless page_size.nil?
1580
+ command.query['pageToken'] = page_token unless page_token.nil?
1581
+ command.query['fields'] = fields unless fields.nil?
1582
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1583
+ execute_or_queue_command(command, &block)
1584
+ end
1585
+
1586
+ # Create a session template synchronously.
1587
+ # @param [String] parent
1588
+ # Required. The parent resource where this session template will be created.
1589
+ # @param [Google::Apis::DataprocV1::SessionTemplate] session_template_object
1590
+ # @param [String] fields
1591
+ # Selector specifying which fields to include in a partial response.
1592
+ # @param [String] quota_user
1593
+ # Available to use for quota purposes for server-side applications. Can be any
1594
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1595
+ # @param [Google::Apis::RequestOptions] options
1596
+ # Request-specific options
1597
+ #
1598
+ # @yield [result, err] Result & error if block supplied
1599
+ # @yieldparam result [Google::Apis::DataprocV1::SessionTemplate] parsed result object
1600
+ # @yieldparam err [StandardError] error object if request failed
1601
+ #
1602
+ # @return [Google::Apis::DataprocV1::SessionTemplate]
1603
+ #
1604
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1605
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1606
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1607
+ def create_project_location_session_template(parent, session_template_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1608
+ command = make_simple_command(:post, 'v1/{+parent}/sessionTemplates', options)
1609
+ command.request_representation = Google::Apis::DataprocV1::SessionTemplate::Representation
1610
+ command.request_object = session_template_object
1611
+ command.response_representation = Google::Apis::DataprocV1::SessionTemplate::Representation
1612
+ command.response_class = Google::Apis::DataprocV1::SessionTemplate
1613
+ command.params['parent'] = parent unless parent.nil?
1614
+ command.query['fields'] = fields unless fields.nil?
1615
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1616
+ execute_or_queue_command(command, &block)
1617
+ end
1618
+
1619
+ # Deletes a session template.
1620
+ # @param [String] name
1621
+ # Required. The name of the session template resource to delete.
1622
+ # @param [String] fields
1623
+ # Selector specifying which fields to include in a partial response.
1624
+ # @param [String] quota_user
1625
+ # Available to use for quota purposes for server-side applications. Can be any
1626
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1627
+ # @param [Google::Apis::RequestOptions] options
1628
+ # Request-specific options
1629
+ #
1630
+ # @yield [result, err] Result & error if block supplied
1631
+ # @yieldparam result [Google::Apis::DataprocV1::Empty] parsed result object
1632
+ # @yieldparam err [StandardError] error object if request failed
1633
+ #
1634
+ # @return [Google::Apis::DataprocV1::Empty]
1635
+ #
1636
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1637
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1638
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1639
+ def delete_project_location_session_template(name, fields: nil, quota_user: nil, options: nil, &block)
1640
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1641
+ command.response_representation = Google::Apis::DataprocV1::Empty::Representation
1642
+ command.response_class = Google::Apis::DataprocV1::Empty
1643
+ command.params['name'] = name unless name.nil?
1644
+ command.query['fields'] = fields unless fields.nil?
1645
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1646
+ execute_or_queue_command(command, &block)
1647
+ end
1648
+
1649
+ # Gets the resource representation for a session template.
1650
+ # @param [String] name
1651
+ # Required. The name of the session template to retrieve.
1652
+ # @param [String] fields
1653
+ # Selector specifying which fields to include in a partial response.
1654
+ # @param [String] quota_user
1655
+ # Available to use for quota purposes for server-side applications. Can be any
1656
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1657
+ # @param [Google::Apis::RequestOptions] options
1658
+ # Request-specific options
1659
+ #
1660
+ # @yield [result, err] Result & error if block supplied
1661
+ # @yieldparam result [Google::Apis::DataprocV1::SessionTemplate] parsed result object
1662
+ # @yieldparam err [StandardError] error object if request failed
1663
+ #
1664
+ # @return [Google::Apis::DataprocV1::SessionTemplate]
1665
+ #
1666
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1667
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1668
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1669
+ def get_project_location_session_template(name, fields: nil, quota_user: nil, options: nil, &block)
1670
+ command = make_simple_command(:get, 'v1/{+name}', options)
1671
+ command.response_representation = Google::Apis::DataprocV1::SessionTemplate::Representation
1672
+ command.response_class = Google::Apis::DataprocV1::SessionTemplate
1673
+ command.params['name'] = name unless name.nil?
1674
+ command.query['fields'] = fields unless fields.nil?
1675
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1676
+ execute_or_queue_command(command, &block)
1677
+ end
1678
+
1679
+ # Lists session templates.
1680
+ # @param [String] parent
1681
+ # Required. The parent that owns this collection of session templates.
1682
+ # @param [String] filter
1683
+ # Optional. A filter for the session templates to return in the response.
1684
+ # Filters are case sensitive and have the following syntax:field = value AND
1685
+ # field = value ...
1686
+ # @param [Fixnum] page_size
1687
+ # Optional. The maximum number of sessions to return in each response. The
1688
+ # service may return fewer than this value.
1689
+ # @param [String] page_token
1690
+ # Optional. A page token received from a previous ListSessions call. Provide
1691
+ # this token to retrieve the subsequent page.
1692
+ # @param [String] fields
1693
+ # Selector specifying which fields to include in a partial response.
1694
+ # @param [String] quota_user
1695
+ # Available to use for quota purposes for server-side applications. Can be any
1696
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1697
+ # @param [Google::Apis::RequestOptions] options
1698
+ # Request-specific options
1699
+ #
1700
+ # @yield [result, err] Result & error if block supplied
1701
+ # @yieldparam result [Google::Apis::DataprocV1::ListSessionTemplatesResponse] parsed result object
1702
+ # @yieldparam err [StandardError] error object if request failed
1703
+ #
1704
+ # @return [Google::Apis::DataprocV1::ListSessionTemplatesResponse]
1705
+ #
1706
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1707
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1708
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1709
+ def list_project_location_session_templates(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1710
+ command = make_simple_command(:get, 'v1/{+parent}/sessionTemplates', options)
1711
+ command.response_representation = Google::Apis::DataprocV1::ListSessionTemplatesResponse::Representation
1712
+ command.response_class = Google::Apis::DataprocV1::ListSessionTemplatesResponse
1713
+ command.params['parent'] = parent unless parent.nil?
1714
+ command.query['filter'] = filter unless filter.nil?
1715
+ command.query['pageSize'] = page_size unless page_size.nil?
1716
+ command.query['pageToken'] = page_token unless page_token.nil?
1717
+ command.query['fields'] = fields unless fields.nil?
1718
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1719
+ execute_or_queue_command(command, &block)
1720
+ end
1721
+
1722
+ # Updates the session template synchronously.
1723
+ # @param [String] name
1724
+ # Required. The resource name of the session template.
1725
+ # @param [Google::Apis::DataprocV1::SessionTemplate] session_template_object
1726
+ # @param [String] fields
1727
+ # Selector specifying which fields to include in a partial response.
1728
+ # @param [String] quota_user
1729
+ # Available to use for quota purposes for server-side applications. Can be any
1730
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1731
+ # @param [Google::Apis::RequestOptions] options
1732
+ # Request-specific options
1733
+ #
1734
+ # @yield [result, err] Result & error if block supplied
1735
+ # @yieldparam result [Google::Apis::DataprocV1::SessionTemplate] parsed result object
1736
+ # @yieldparam err [StandardError] error object if request failed
1737
+ #
1738
+ # @return [Google::Apis::DataprocV1::SessionTemplate]
1739
+ #
1740
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1741
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1742
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1743
+ def patch_project_location_session_template(name, session_template_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1744
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1745
+ command.request_representation = Google::Apis::DataprocV1::SessionTemplate::Representation
1746
+ command.request_object = session_template_object
1747
+ command.response_representation = Google::Apis::DataprocV1::SessionTemplate::Representation
1748
+ command.response_class = Google::Apis::DataprocV1::SessionTemplate
1749
+ command.params['name'] = name unless name.nil?
1750
+ command.query['fields'] = fields unless fields.nil?
1751
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1752
+ execute_or_queue_command(command, &block)
1753
+ end
1754
+
1755
+ # Create an interactive session asynchronously.
1756
+ # @param [String] parent
1757
+ # Required. The parent resource where this session will be created.
1758
+ # @param [Google::Apis::DataprocV1::Session] session_object
1759
+ # @param [String] request_id
1760
+ # Optional. A unique ID used to identify the request. If the service receives
1761
+ # two CreateSessionRequests (https://cloud.google.com/dataproc/docs/reference/
1762
+ # rpc/google.cloud.dataproc.v1#google.cloud.dataproc.v1.CreateSessionRequest)s
1763
+ # with the same ID, the second request is ignored, and the first Session is
1764
+ # created and stored in the backend.Recommendation: Set this value to a UUID (
1765
+ # https://en.wikipedia.org/wiki/Universally_unique_identifier).The value must
1766
+ # contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-
1767
+ # ). The maximum length is 40 characters.
1768
+ # @param [String] session_id
1769
+ # Required. The ID to use for the session, which becomes the final component of
1770
+ # the session's resource name.This value must be 4-63 characters. Valid
1771
+ # characters are /a-z-/.
1772
+ # @param [String] fields
1773
+ # Selector specifying which fields to include in a partial response.
1774
+ # @param [String] quota_user
1775
+ # Available to use for quota purposes for server-side applications. Can be any
1776
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1777
+ # @param [Google::Apis::RequestOptions] options
1778
+ # Request-specific options
1779
+ #
1780
+ # @yield [result, err] Result & error if block supplied
1781
+ # @yieldparam result [Google::Apis::DataprocV1::Operation] parsed result object
1782
+ # @yieldparam err [StandardError] error object if request failed
1783
+ #
1784
+ # @return [Google::Apis::DataprocV1::Operation]
1785
+ #
1786
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1787
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1788
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1789
+ def create_project_location_session(parent, session_object = nil, request_id: nil, session_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1790
+ command = make_simple_command(:post, 'v1/{+parent}/sessions', options)
1791
+ command.request_representation = Google::Apis::DataprocV1::Session::Representation
1792
+ command.request_object = session_object
1793
+ command.response_representation = Google::Apis::DataprocV1::Operation::Representation
1794
+ command.response_class = Google::Apis::DataprocV1::Operation
1795
+ command.params['parent'] = parent unless parent.nil?
1796
+ command.query['requestId'] = request_id unless request_id.nil?
1797
+ command.query['sessionId'] = session_id unless session_id.nil?
1798
+ command.query['fields'] = fields unless fields.nil?
1799
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1800
+ execute_or_queue_command(command, &block)
1801
+ end
1802
+
1803
+ # Deletes the interactive session resource. If the session is not in terminal
1804
+ # state, it is terminated, and then deleted.
1805
+ # @param [String] name
1806
+ # Required. The name of the session resource to delete.
1807
+ # @param [String] request_id
1808
+ # Optional. A unique ID used to identify the request. If the service receives
1809
+ # two DeleteSessionRequest (https://cloud.google.com/dataproc/docs/reference/rpc/
1810
+ # google.cloud.dataproc.v1#google.cloud.dataproc.v1.DeleteSessionRequest)s with
1811
+ # the same ID, the second request is ignored.Recommendation: Set this value to a
1812
+ # UUID (https://en.wikipedia.org/wiki/Universally_unique_identifier).The value
1813
+ # must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), and
1814
+ # hyphens (-). The maximum length is 40 characters.
1815
+ # @param [String] fields
1816
+ # Selector specifying which fields to include in a partial response.
1817
+ # @param [String] quota_user
1818
+ # Available to use for quota purposes for server-side applications. Can be any
1819
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1820
+ # @param [Google::Apis::RequestOptions] options
1821
+ # Request-specific options
1822
+ #
1823
+ # @yield [result, err] Result & error if block supplied
1824
+ # @yieldparam result [Google::Apis::DataprocV1::Operation] parsed result object
1825
+ # @yieldparam err [StandardError] error object if request failed
1826
+ #
1827
+ # @return [Google::Apis::DataprocV1::Operation]
1828
+ #
1829
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1830
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1831
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1832
+ def delete_project_location_session(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1833
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1834
+ command.response_representation = Google::Apis::DataprocV1::Operation::Representation
1835
+ command.response_class = Google::Apis::DataprocV1::Operation
1836
+ command.params['name'] = name unless name.nil?
1837
+ command.query['requestId'] = request_id unless request_id.nil?
1838
+ command.query['fields'] = fields unless fields.nil?
1839
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1840
+ execute_or_queue_command(command, &block)
1841
+ end
1842
+
1843
+ # Gets the resource representation for an interactive session.
1844
+ # @param [String] name
1845
+ # Required. The name of the session to retrieve.
1846
+ # @param [String] fields
1847
+ # Selector specifying which fields to include in a partial response.
1848
+ # @param [String] quota_user
1849
+ # Available to use for quota purposes for server-side applications. Can be any
1850
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1851
+ # @param [Google::Apis::RequestOptions] options
1852
+ # Request-specific options
1853
+ #
1854
+ # @yield [result, err] Result & error if block supplied
1855
+ # @yieldparam result [Google::Apis::DataprocV1::Session] parsed result object
1856
+ # @yieldparam err [StandardError] error object if request failed
1857
+ #
1858
+ # @return [Google::Apis::DataprocV1::Session]
1859
+ #
1860
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1861
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1862
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1863
+ def get_project_location_session(name, fields: nil, quota_user: nil, options: nil, &block)
1864
+ command = make_simple_command(:get, 'v1/{+name}', options)
1865
+ command.response_representation = Google::Apis::DataprocV1::Session::Representation
1866
+ command.response_class = Google::Apis::DataprocV1::Session
1867
+ command.params['name'] = name unless name.nil?
1868
+ command.query['fields'] = fields unless fields.nil?
1869
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1870
+ execute_or_queue_command(command, &block)
1871
+ end
1872
+
1873
+ # Lists interactive sessions.
1874
+ # @param [String] parent
1875
+ # Required. The parent, which owns this collection of sessions.
1876
+ # @param [String] filter
1877
+ # Optional. A filter for the sessions to return in the response.A filter is a
1878
+ # logical expression constraining the values of various fields in each session
1879
+ # resource. Filters are case sensitive, and may contain multiple clauses
1880
+ # combined with logical operators (AND, OR). Supported fields are session_id,
1881
+ # session_uuid, state, create_time, and labels.Example: state = ACTIVE and
1882
+ # create_time < "2023-01-01T00:00:00Z" is a filter for sessions in an ACTIVE
1883
+ # state that were created before 2023-01-01. state = ACTIVE and labels.
1884
+ # environment=production is a filter for sessions in an ACTIVE state that have a
1885
+ # production environment label.See https://google.aip.dev/assets/misc/ebnf-
1886
+ # filtering.txt for a detailed description of the filter syntax and a list of
1887
+ # supported comparators.
1888
+ # @param [Fixnum] page_size
1889
+ # Optional. The maximum number of sessions to return in each response. The
1890
+ # service may return fewer than this value.
1891
+ # @param [String] page_token
1892
+ # Optional. A page token received from a previous ListSessions call. Provide
1893
+ # this token to retrieve the subsequent page.
1894
+ # @param [String] fields
1895
+ # Selector specifying which fields to include in a partial response.
1896
+ # @param [String] quota_user
1897
+ # Available to use for quota purposes for server-side applications. Can be any
1898
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1899
+ # @param [Google::Apis::RequestOptions] options
1900
+ # Request-specific options
1901
+ #
1902
+ # @yield [result, err] Result & error if block supplied
1903
+ # @yieldparam result [Google::Apis::DataprocV1::ListSessionsResponse] parsed result object
1904
+ # @yieldparam err [StandardError] error object if request failed
1905
+ #
1906
+ # @return [Google::Apis::DataprocV1::ListSessionsResponse]
1907
+ #
1908
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1909
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1910
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1911
+ def list_project_location_sessions(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1912
+ command = make_simple_command(:get, 'v1/{+parent}/sessions', options)
1913
+ command.response_representation = Google::Apis::DataprocV1::ListSessionsResponse::Representation
1914
+ command.response_class = Google::Apis::DataprocV1::ListSessionsResponse
1915
+ command.params['parent'] = parent unless parent.nil?
1916
+ command.query['filter'] = filter unless filter.nil?
1917
+ command.query['pageSize'] = page_size unless page_size.nil?
1918
+ command.query['pageToken'] = page_token unless page_token.nil?
1919
+ command.query['fields'] = fields unless fields.nil?
1920
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1921
+ execute_or_queue_command(command, &block)
1922
+ end
1923
+
1924
+ # Terminates the interactive session.
1925
+ # @param [String] name
1926
+ # Required. The name of the session resource to terminate.
1927
+ # @param [Google::Apis::DataprocV1::TerminateSessionRequest] terminate_session_request_object
1928
+ # @param [String] fields
1929
+ # Selector specifying which fields to include in a partial response.
1930
+ # @param [String] quota_user
1931
+ # Available to use for quota purposes for server-side applications. Can be any
1932
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1933
+ # @param [Google::Apis::RequestOptions] options
1934
+ # Request-specific options
1935
+ #
1936
+ # @yield [result, err] Result & error if block supplied
1937
+ # @yieldparam result [Google::Apis::DataprocV1::Operation] parsed result object
1938
+ # @yieldparam err [StandardError] error object if request failed
1939
+ #
1940
+ # @return [Google::Apis::DataprocV1::Operation]
1941
+ #
1942
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1943
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1944
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1945
+ def terminate_session(name, terminate_session_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1946
+ command = make_simple_command(:post, 'v1/{+name}:terminate', options)
1947
+ command.request_representation = Google::Apis::DataprocV1::TerminateSessionRequest::Representation
1948
+ command.request_object = terminate_session_request_object
1949
+ command.response_representation = Google::Apis::DataprocV1::Operation::Representation
1950
+ command.response_class = Google::Apis::DataprocV1::Operation
1951
+ command.params['name'] = name unless name.nil?
1952
+ command.query['fields'] = fields unless fields.nil?
1953
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1954
+ execute_or_queue_command(command, &block)
1955
+ end
1956
+
1957
+ # Obtain high level information corresponding to a single Spark Application.
1958
+ # @param [String] name
1959
+ # Required. The fully qualified name of the session to retrieve in the format "
1960
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/
1961
+ # sparkApplications/APPLICATION_ID"
1962
+ # @param [String] parent
1963
+ # Required. Parent (Session) resource reference.
1964
+ # @param [String] fields
1965
+ # Selector specifying which fields to include in a partial response.
1966
+ # @param [String] quota_user
1967
+ # Available to use for quota purposes for server-side applications. Can be any
1968
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1969
+ # @param [Google::Apis::RequestOptions] options
1970
+ # Request-specific options
1971
+ #
1972
+ # @yield [result, err] Result & error if block supplied
1973
+ # @yieldparam result [Google::Apis::DataprocV1::AccessSessionSparkApplicationResponse] parsed result object
1974
+ # @yieldparam err [StandardError] error object if request failed
1975
+ #
1976
+ # @return [Google::Apis::DataprocV1::AccessSessionSparkApplicationResponse]
1977
+ #
1978
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1979
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1980
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1981
+ def access_project_location_session_spark_application(name, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
1982
+ command = make_simple_command(:get, 'v1/{+name}:access', options)
1983
+ command.response_representation = Google::Apis::DataprocV1::AccessSessionSparkApplicationResponse::Representation
1984
+ command.response_class = Google::Apis::DataprocV1::AccessSessionSparkApplicationResponse
1985
+ command.params['name'] = name unless name.nil?
1986
+ command.query['parent'] = parent unless parent.nil?
1987
+ command.query['fields'] = fields unless fields.nil?
1988
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1989
+ execute_or_queue_command(command, &block)
1990
+ end
1991
+
1992
+ # Obtain environment details for a Spark Application
1993
+ # @param [String] name
1994
+ # Required. The fully qualified name of the session to retrieve in the format "
1995
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/
1996
+ # sparkApplications/APPLICATION_ID"
1997
+ # @param [String] parent
1998
+ # Required. Parent (Session) resource reference.
1999
+ # @param [String] fields
2000
+ # Selector specifying which fields to include in a partial response.
2001
+ # @param [String] quota_user
2002
+ # Available to use for quota purposes for server-side applications. Can be any
2003
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2004
+ # @param [Google::Apis::RequestOptions] options
2005
+ # Request-specific options
2006
+ #
2007
+ # @yield [result, err] Result & error if block supplied
2008
+ # @yieldparam result [Google::Apis::DataprocV1::AccessSessionSparkApplicationEnvironmentInfoResponse] parsed result object
2009
+ # @yieldparam err [StandardError] error object if request failed
2010
+ #
2011
+ # @return [Google::Apis::DataprocV1::AccessSessionSparkApplicationEnvironmentInfoResponse]
2012
+ #
2013
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2014
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2015
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2016
+ def access_project_location_session_spark_application_environment_info(name, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
2017
+ command = make_simple_command(:get, 'v1/{+name}:accessEnvironmentInfo', options)
2018
+ command.response_representation = Google::Apis::DataprocV1::AccessSessionSparkApplicationEnvironmentInfoResponse::Representation
2019
+ command.response_class = Google::Apis::DataprocV1::AccessSessionSparkApplicationEnvironmentInfoResponse
2020
+ command.params['name'] = name unless name.nil?
2021
+ command.query['parent'] = parent unless parent.nil?
2022
+ command.query['fields'] = fields unless fields.nil?
2023
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2024
+ execute_or_queue_command(command, &block)
2025
+ end
2026
+
2027
+ # Obtain data corresponding to a spark job for a Spark Application.
2028
+ # @param [String] name
2029
+ # Required. The fully qualified name of the session to retrieve in the format "
2030
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/
2031
+ # sparkApplications/APPLICATION_ID"
2032
+ # @param [Fixnum] job_id
2033
+ # Required. Job ID to fetch data for.
2034
+ # @param [String] parent
2035
+ # Required. Parent (Session) resource reference.
2036
+ # @param [String] fields
2037
+ # Selector specifying which fields to include in a partial response.
2038
+ # @param [String] quota_user
2039
+ # Available to use for quota purposes for server-side applications. Can be any
2040
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2041
+ # @param [Google::Apis::RequestOptions] options
2042
+ # Request-specific options
2043
+ #
2044
+ # @yield [result, err] Result & error if block supplied
2045
+ # @yieldparam result [Google::Apis::DataprocV1::AccessSessionSparkApplicationJobResponse] parsed result object
2046
+ # @yieldparam err [StandardError] error object if request failed
2047
+ #
2048
+ # @return [Google::Apis::DataprocV1::AccessSessionSparkApplicationJobResponse]
2049
+ #
2050
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2051
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2052
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2053
+ def access_project_location_session_spark_application_job(name, job_id: nil, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
2054
+ command = make_simple_command(:get, 'v1/{+name}:accessJob', options)
2055
+ command.response_representation = Google::Apis::DataprocV1::AccessSessionSparkApplicationJobResponse::Representation
2056
+ command.response_class = Google::Apis::DataprocV1::AccessSessionSparkApplicationJobResponse
2057
+ command.params['name'] = name unless name.nil?
2058
+ command.query['jobId'] = job_id unless job_id.nil?
2059
+ command.query['parent'] = parent unless parent.nil?
2060
+ command.query['fields'] = fields unless fields.nil?
2061
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2062
+ execute_or_queue_command(command, &block)
2063
+ end
2064
+
2065
+ # Obtain Spark Plan Graph for a Spark Application SQL execution. Limits the
2066
+ # number of clusters returned as part of the graph to 10000.
2067
+ # @param [String] name
2068
+ # Required. The fully qualified name of the session to retrieve in the format "
2069
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/
2070
+ # sparkApplications/APPLICATION_ID"
2071
+ # @param [Fixnum] execution_id
2072
+ # Required. Execution ID
2073
+ # @param [String] parent
2074
+ # Required. Parent (Session) resource reference.
2075
+ # @param [String] fields
2076
+ # Selector specifying which fields to include in a partial response.
2077
+ # @param [String] quota_user
2078
+ # Available to use for quota purposes for server-side applications. Can be any
2079
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2080
+ # @param [Google::Apis::RequestOptions] options
2081
+ # Request-specific options
2082
+ #
2083
+ # @yield [result, err] Result & error if block supplied
2084
+ # @yieldparam result [Google::Apis::DataprocV1::AccessSessionSparkApplicationSqlSparkPlanGraphResponse] parsed result object
2085
+ # @yieldparam err [StandardError] error object if request failed
2086
+ #
2087
+ # @return [Google::Apis::DataprocV1::AccessSessionSparkApplicationSqlSparkPlanGraphResponse]
2088
+ #
2089
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2090
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2091
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2092
+ def access_project_location_session_spark_application_sql_plan(name, execution_id: nil, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
2093
+ command = make_simple_command(:get, 'v1/{+name}:accessSqlPlan', options)
2094
+ command.response_representation = Google::Apis::DataprocV1::AccessSessionSparkApplicationSqlSparkPlanGraphResponse::Representation
2095
+ command.response_class = Google::Apis::DataprocV1::AccessSessionSparkApplicationSqlSparkPlanGraphResponse
2096
+ command.params['name'] = name unless name.nil?
2097
+ command.query['executionId'] = execution_id unless execution_id.nil?
2098
+ command.query['parent'] = parent unless parent.nil?
2099
+ command.query['fields'] = fields unless fields.nil?
2100
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2101
+ execute_or_queue_command(command, &block)
2102
+ end
2103
+
2104
+ # Obtain data corresponding to a particular SQL Query for a Spark Application.
2105
+ # @param [String] name
2106
+ # Required. The fully qualified name of the session to retrieve in the format "
2107
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/
2108
+ # sparkApplications/APPLICATION_ID"
2109
+ # @param [Boolean] details
2110
+ # Optional. Lists/ hides details of Spark plan nodes. True is set to list and
2111
+ # false to hide.
2112
+ # @param [Fixnum] execution_id
2113
+ # Required. Execution ID
2114
+ # @param [String] parent
2115
+ # Required. Parent (Session) resource reference.
2116
+ # @param [Boolean] plan_description
2117
+ # Optional. Enables/ disables physical plan description on demand
2118
+ # @param [String] fields
2119
+ # Selector specifying which fields to include in a partial response.
2120
+ # @param [String] quota_user
2121
+ # Available to use for quota purposes for server-side applications. Can be any
2122
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2123
+ # @param [Google::Apis::RequestOptions] options
2124
+ # Request-specific options
2125
+ #
2126
+ # @yield [result, err] Result & error if block supplied
2127
+ # @yieldparam result [Google::Apis::DataprocV1::AccessSessionSparkApplicationSqlQueryResponse] parsed result object
2128
+ # @yieldparam err [StandardError] error object if request failed
2129
+ #
2130
+ # @return [Google::Apis::DataprocV1::AccessSessionSparkApplicationSqlQueryResponse]
2131
+ #
2132
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2133
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2134
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2135
+ def access_project_location_session_spark_application_sql_query(name, details: nil, execution_id: nil, parent: nil, plan_description: nil, fields: nil, quota_user: nil, options: nil, &block)
2136
+ command = make_simple_command(:get, 'v1/{+name}:accessSqlQuery', options)
2137
+ command.response_representation = Google::Apis::DataprocV1::AccessSessionSparkApplicationSqlQueryResponse::Representation
2138
+ command.response_class = Google::Apis::DataprocV1::AccessSessionSparkApplicationSqlQueryResponse
2139
+ command.params['name'] = name unless name.nil?
2140
+ command.query['details'] = details unless details.nil?
2141
+ command.query['executionId'] = execution_id unless execution_id.nil?
2142
+ command.query['parent'] = parent unless parent.nil?
2143
+ command.query['planDescription'] = plan_description unless plan_description.nil?
2144
+ command.query['fields'] = fields unless fields.nil?
2145
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2146
+ execute_or_queue_command(command, &block)
2147
+ end
2148
+
2149
+ # Obtain data corresponding to a spark stage attempt for a Spark Application.
2150
+ # @param [String] name
2151
+ # Required. The fully qualified name of the session to retrieve in the format "
2152
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/
2153
+ # sparkApplications/APPLICATION_ID"
2154
+ # @param [String] parent
2155
+ # Required. Parent (Session) resource reference.
2156
+ # @param [Fixnum] stage_attempt_id
2157
+ # Required. Stage Attempt ID
2158
+ # @param [Fixnum] stage_id
2159
+ # Required. Stage ID
2160
+ # @param [String] summary_metrics_mask
2161
+ # Optional. The list of summary metrics fields to include. Empty list will
2162
+ # default to skip all summary metrics fields. Example, if the response should
2163
+ # include TaskQuantileMetrics, the request should have task_quantile_metrics in
2164
+ # summary_metrics_mask field
2165
+ # @param [String] fields
2166
+ # Selector specifying which fields to include in a partial response.
2167
+ # @param [String] quota_user
2168
+ # Available to use for quota purposes for server-side applications. Can be any
2169
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2170
+ # @param [Google::Apis::RequestOptions] options
2171
+ # Request-specific options
2172
+ #
2173
+ # @yield [result, err] Result & error if block supplied
2174
+ # @yieldparam result [Google::Apis::DataprocV1::AccessSessionSparkApplicationStageAttemptResponse] parsed result object
2175
+ # @yieldparam err [StandardError] error object if request failed
2176
+ #
2177
+ # @return [Google::Apis::DataprocV1::AccessSessionSparkApplicationStageAttemptResponse]
2178
+ #
2179
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2180
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2181
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2182
+ def access_project_location_session_spark_application_stage_attempt(name, parent: nil, stage_attempt_id: nil, stage_id: nil, summary_metrics_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
2183
+ command = make_simple_command(:get, 'v1/{+name}:accessStageAttempt', options)
2184
+ command.response_representation = Google::Apis::DataprocV1::AccessSessionSparkApplicationStageAttemptResponse::Representation
2185
+ command.response_class = Google::Apis::DataprocV1::AccessSessionSparkApplicationStageAttemptResponse
2186
+ command.params['name'] = name unless name.nil?
2187
+ command.query['parent'] = parent unless parent.nil?
2188
+ command.query['stageAttemptId'] = stage_attempt_id unless stage_attempt_id.nil?
2189
+ command.query['stageId'] = stage_id unless stage_id.nil?
2190
+ command.query['summaryMetricsMask'] = summary_metrics_mask unless summary_metrics_mask.nil?
2191
+ command.query['fields'] = fields unless fields.nil?
2192
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2193
+ execute_or_queue_command(command, &block)
2194
+ end
2195
+
2196
+ # Obtain RDD operation graph for a Spark Application Stage. Limits the number of
2197
+ # clusters returned as part of the graph to 10000.
2198
+ # @param [String] name
2199
+ # Required. The fully qualified name of the session to retrieve in the format "
2200
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/
2201
+ # sparkApplications/APPLICATION_ID"
2202
+ # @param [String] parent
2203
+ # Required. Parent (Session) resource reference.
2204
+ # @param [Fixnum] stage_id
2205
+ # Required. Stage ID
2206
+ # @param [String] fields
2207
+ # Selector specifying which fields to include in a partial response.
2208
+ # @param [String] quota_user
2209
+ # Available to use for quota purposes for server-side applications. Can be any
2210
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2211
+ # @param [Google::Apis::RequestOptions] options
2212
+ # Request-specific options
2213
+ #
2214
+ # @yield [result, err] Result & error if block supplied
2215
+ # @yieldparam result [Google::Apis::DataprocV1::AccessSessionSparkApplicationStageRddOperationGraphResponse] parsed result object
2216
+ # @yieldparam err [StandardError] error object if request failed
2217
+ #
2218
+ # @return [Google::Apis::DataprocV1::AccessSessionSparkApplicationStageRddOperationGraphResponse]
2219
+ #
2220
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2221
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2222
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2223
+ def access_project_location_session_spark_application_stage_rdd_graph(name, parent: nil, stage_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2224
+ command = make_simple_command(:get, 'v1/{+name}:accessStageRddGraph', options)
2225
+ command.response_representation = Google::Apis::DataprocV1::AccessSessionSparkApplicationStageRddOperationGraphResponse::Representation
2226
+ command.response_class = Google::Apis::DataprocV1::AccessSessionSparkApplicationStageRddOperationGraphResponse
2227
+ command.params['name'] = name unless name.nil?
2228
+ command.query['parent'] = parent unless parent.nil?
2229
+ command.query['stageId'] = stage_id unless stage_id.nil?
2230
+ command.query['fields'] = fields unless fields.nil?
2231
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2232
+ execute_or_queue_command(command, &block)
2233
+ end
2234
+
2235
+ # Obtain high level information and list of Spark Applications corresponding to
2236
+ # a batch
2237
+ # @param [String] parent
2238
+ # Required. The fully qualified name of the session to retrieve in the format "
2239
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID"
2240
+ # @param [String] application_status
2241
+ # Optional. Search only applications in the chosen state.
2242
+ # @param [String] max_end_time
2243
+ # Optional. Latest end timestamp to list.
2244
+ # @param [String] max_time
2245
+ # Optional. Latest start timestamp to list.
2246
+ # @param [String] min_end_time
2247
+ # Optional. Earliest end timestamp to list.
2248
+ # @param [String] min_time
2249
+ # Optional. Earliest start timestamp to list.
2250
+ # @param [Fixnum] page_size
2251
+ # Optional. Maximum number of applications to return in each response. The
2252
+ # service may return fewer than this. The default page size is 10; the maximum
2253
+ # page size is 100.
2254
+ # @param [String] page_token
2255
+ # Optional. A page token received from a previous SearchSessionSparkApplications
2256
+ # call. Provide this token to retrieve the subsequent page.
2257
+ # @param [String] fields
2258
+ # Selector specifying which fields to include in a partial response.
2259
+ # @param [String] quota_user
2260
+ # Available to use for quota purposes for server-side applications. Can be any
2261
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2262
+ # @param [Google::Apis::RequestOptions] options
2263
+ # Request-specific options
2264
+ #
2265
+ # @yield [result, err] Result & error if block supplied
2266
+ # @yieldparam result [Google::Apis::DataprocV1::SearchSessionSparkApplicationsResponse] parsed result object
2267
+ # @yieldparam err [StandardError] error object if request failed
2268
+ #
2269
+ # @return [Google::Apis::DataprocV1::SearchSessionSparkApplicationsResponse]
2270
+ #
2271
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2272
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2273
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2274
+ def search_project_location_session_spark_applications(parent, application_status: nil, max_end_time: nil, max_time: nil, min_end_time: nil, min_time: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2275
+ command = make_simple_command(:get, 'v1/{+parent}/sparkApplications:search', options)
2276
+ command.response_representation = Google::Apis::DataprocV1::SearchSessionSparkApplicationsResponse::Representation
2277
+ command.response_class = Google::Apis::DataprocV1::SearchSessionSparkApplicationsResponse
2278
+ command.params['parent'] = parent unless parent.nil?
2279
+ command.query['applicationStatus'] = application_status unless application_status.nil?
2280
+ command.query['maxEndTime'] = max_end_time unless max_end_time.nil?
2281
+ command.query['maxTime'] = max_time unless max_time.nil?
2282
+ command.query['minEndTime'] = min_end_time unless min_end_time.nil?
2283
+ command.query['minTime'] = min_time unless min_time.nil?
2284
+ command.query['pageSize'] = page_size unless page_size.nil?
2285
+ command.query['pageToken'] = page_token unless page_token.nil?
2286
+ command.query['fields'] = fields unless fields.nil?
2287
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2288
+ execute_or_queue_command(command, &block)
2289
+ end
2290
+
2291
+ # Obtain executor summary with respect to a spark stage attempt.
2292
+ # @param [String] name
2293
+ # Required. The fully qualified name of the session to retrieve in the format "
2294
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/
2295
+ # sparkApplications/APPLICATION_ID"
2296
+ # @param [Fixnum] page_size
2297
+ # Optional. Maximum number of executors to return in each response. The service
2298
+ # may return fewer than this. The default page size is 10; the maximum page size
2299
+ # is 100.
2300
+ # @param [String] page_token
2301
+ # Optional. A page token received from a previous
2302
+ # SearchSessionSparkApplicationExecutorStageSummary call. Provide this token to
2303
+ # retrieve the subsequent page.
2304
+ # @param [String] parent
2305
+ # Required. Parent (Session) resource reference.
2306
+ # @param [Fixnum] stage_attempt_id
2307
+ # Required. Stage Attempt ID
2308
+ # @param [Fixnum] stage_id
2309
+ # Required. Stage ID
2310
+ # @param [String] fields
2311
+ # Selector specifying which fields to include in a partial response.
2312
+ # @param [String] quota_user
2313
+ # Available to use for quota purposes for server-side applications. Can be any
2314
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2315
+ # @param [Google::Apis::RequestOptions] options
2316
+ # Request-specific options
2317
+ #
2318
+ # @yield [result, err] Result & error if block supplied
2319
+ # @yieldparam result [Google::Apis::DataprocV1::SearchSessionSparkApplicationExecutorStageSummaryResponse] parsed result object
2320
+ # @yieldparam err [StandardError] error object if request failed
2321
+ #
2322
+ # @return [Google::Apis::DataprocV1::SearchSessionSparkApplicationExecutorStageSummaryResponse]
2323
+ #
2324
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2325
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2326
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2327
+ def search_project_location_session_spark_application_executor_stage_summary(name, page_size: nil, page_token: nil, parent: nil, stage_attempt_id: nil, stage_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2328
+ command = make_simple_command(:get, 'v1/{+name}:searchExecutorStageSummary', options)
2329
+ command.response_representation = Google::Apis::DataprocV1::SearchSessionSparkApplicationExecutorStageSummaryResponse::Representation
2330
+ command.response_class = Google::Apis::DataprocV1::SearchSessionSparkApplicationExecutorStageSummaryResponse
2331
+ command.params['name'] = name unless name.nil?
2332
+ command.query['pageSize'] = page_size unless page_size.nil?
2333
+ command.query['pageToken'] = page_token unless page_token.nil?
2334
+ command.query['parent'] = parent unless parent.nil?
2335
+ command.query['stageAttemptId'] = stage_attempt_id unless stage_attempt_id.nil?
2336
+ command.query['stageId'] = stage_id unless stage_id.nil?
2337
+ command.query['fields'] = fields unless fields.nil?
2338
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2339
+ execute_or_queue_command(command, &block)
2340
+ end
2341
+
2342
+ # Obtain data corresponding to executors for a Spark Application.
2343
+ # @param [String] name
2344
+ # Required. The fully qualified name of the session to retrieve in the format "
2345
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/
2346
+ # sparkApplications/APPLICATION_ID"
2347
+ # @param [String] executor_status
2348
+ # Optional. Filter to select whether active/ dead or all executors should be
2349
+ # selected.
2350
+ # @param [Fixnum] page_size
2351
+ # Optional. Maximum number of executors to return in each response. The service
2352
+ # may return fewer than this. The default page size is 10; the maximum page size
2353
+ # is 100.
2354
+ # @param [String] page_token
2355
+ # Optional. A page token received from a previous
2356
+ # SearchSessionSparkApplicationExecutors call. Provide this token to retrieve
2357
+ # the subsequent page.
2358
+ # @param [String] parent
2359
+ # Required. Parent (Session) resource reference.
2360
+ # @param [String] fields
2361
+ # Selector specifying which fields to include in a partial response.
2362
+ # @param [String] quota_user
2363
+ # Available to use for quota purposes for server-side applications. Can be any
2364
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2365
+ # @param [Google::Apis::RequestOptions] options
2366
+ # Request-specific options
2367
+ #
2368
+ # @yield [result, err] Result & error if block supplied
2369
+ # @yieldparam result [Google::Apis::DataprocV1::SearchSessionSparkApplicationExecutorsResponse] parsed result object
2370
+ # @yieldparam err [StandardError] error object if request failed
2371
+ #
2372
+ # @return [Google::Apis::DataprocV1::SearchSessionSparkApplicationExecutorsResponse]
2373
+ #
2374
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2375
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2376
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2377
+ def search_project_location_session_spark_application_executors(name, executor_status: nil, page_size: nil, page_token: nil, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
2378
+ command = make_simple_command(:get, 'v1/{+name}:searchExecutors', options)
2379
+ command.response_representation = Google::Apis::DataprocV1::SearchSessionSparkApplicationExecutorsResponse::Representation
2380
+ command.response_class = Google::Apis::DataprocV1::SearchSessionSparkApplicationExecutorsResponse
2381
+ command.params['name'] = name unless name.nil?
2382
+ command.query['executorStatus'] = executor_status unless executor_status.nil?
2383
+ command.query['pageSize'] = page_size unless page_size.nil?
2384
+ command.query['pageToken'] = page_token unless page_token.nil?
2385
+ command.query['parent'] = parent unless parent.nil?
2386
+ command.query['fields'] = fields unless fields.nil?
2387
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2388
+ execute_or_queue_command(command, &block)
2389
+ end
2390
+
2391
+ # Obtain list of spark jobs corresponding to a Spark Application.
2392
+ # @param [String] name
2393
+ # Required. The fully qualified name of the session to retrieve in the format "
2394
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/
2395
+ # sparkApplications/APPLICATION_ID"
2396
+ # @param [String] job_status
2397
+ # Optional. List only jobs in the specific state.
2398
+ # @param [Fixnum] page_size
2399
+ # Optional. Maximum number of jobs to return in each response. The service may
2400
+ # return fewer than this. The default page size is 10; the maximum page size is
2401
+ # 100.
2402
+ # @param [String] page_token
2403
+ # Optional. A page token received from a previous
2404
+ # SearchSessionSparkApplicationJobs call. Provide this token to retrieve the
2405
+ # subsequent page.
2406
+ # @param [String] parent
2407
+ # Required. Parent (Session) resource reference.
2408
+ # @param [String] fields
2409
+ # Selector specifying which fields to include in a partial response.
2410
+ # @param [String] quota_user
2411
+ # Available to use for quota purposes for server-side applications. Can be any
2412
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2413
+ # @param [Google::Apis::RequestOptions] options
2414
+ # Request-specific options
2415
+ #
2416
+ # @yield [result, err] Result & error if block supplied
2417
+ # @yieldparam result [Google::Apis::DataprocV1::SearchSessionSparkApplicationJobsResponse] parsed result object
2418
+ # @yieldparam err [StandardError] error object if request failed
2419
+ #
2420
+ # @return [Google::Apis::DataprocV1::SearchSessionSparkApplicationJobsResponse]
2421
+ #
2422
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2423
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2424
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2425
+ def search_project_location_session_spark_application_jobs(name, job_status: nil, page_size: nil, page_token: nil, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
2426
+ command = make_simple_command(:get, 'v1/{+name}:searchJobs', options)
2427
+ command.response_representation = Google::Apis::DataprocV1::SearchSessionSparkApplicationJobsResponse::Representation
2428
+ command.response_class = Google::Apis::DataprocV1::SearchSessionSparkApplicationJobsResponse
2429
+ command.params['name'] = name unless name.nil?
2430
+ command.query['jobStatus'] = job_status unless job_status.nil?
2431
+ command.query['pageSize'] = page_size unless page_size.nil?
2432
+ command.query['pageToken'] = page_token unless page_token.nil?
2433
+ command.query['parent'] = parent unless parent.nil?
2434
+ command.query['fields'] = fields unless fields.nil?
2435
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2436
+ execute_or_queue_command(command, &block)
2437
+ end
2438
+
2439
+ # Obtain data corresponding to SQL Queries for a Spark Application.
2440
+ # @param [String] name
2441
+ # Required. The fully qualified name of the session to retrieve in the format "
2442
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/
2443
+ # sparkApplications/APPLICATION_ID"
2444
+ # @param [Boolean] details
2445
+ # Optional. Lists/ hides details of Spark plan nodes. True is set to list and
2446
+ # false to hide.
2447
+ # @param [Fixnum] page_size
2448
+ # Optional. Maximum number of queries to return in each response. The service
2449
+ # may return fewer than this. The default page size is 10; the maximum page size
2450
+ # is 100.
2451
+ # @param [String] page_token
2452
+ # Optional. A page token received from a previous
2453
+ # SearchSessionSparkApplicationSqlQueries call. Provide this token to retrieve
2454
+ # the subsequent page.
2455
+ # @param [String] parent
2456
+ # Required. Parent (Session) resource reference.
2457
+ # @param [Boolean] plan_description
2458
+ # Optional. Enables/ disables physical plan description on demand
2459
+ # @param [String] fields
2460
+ # Selector specifying which fields to include in a partial response.
2461
+ # @param [String] quota_user
2462
+ # Available to use for quota purposes for server-side applications. Can be any
2463
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2464
+ # @param [Google::Apis::RequestOptions] options
2465
+ # Request-specific options
2466
+ #
2467
+ # @yield [result, err] Result & error if block supplied
2468
+ # @yieldparam result [Google::Apis::DataprocV1::SearchSessionSparkApplicationSqlQueriesResponse] parsed result object
2469
+ # @yieldparam err [StandardError] error object if request failed
2470
+ #
2471
+ # @return [Google::Apis::DataprocV1::SearchSessionSparkApplicationSqlQueriesResponse]
2472
+ #
2473
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2474
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2475
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2476
+ def search_project_location_session_spark_application_sql_queries(name, details: nil, page_size: nil, page_token: nil, parent: nil, plan_description: nil, fields: nil, quota_user: nil, options: nil, &block)
2477
+ command = make_simple_command(:get, 'v1/{+name}:searchSqlQueries', options)
2478
+ command.response_representation = Google::Apis::DataprocV1::SearchSessionSparkApplicationSqlQueriesResponse::Representation
2479
+ command.response_class = Google::Apis::DataprocV1::SearchSessionSparkApplicationSqlQueriesResponse
2480
+ command.params['name'] = name unless name.nil?
2481
+ command.query['details'] = details unless details.nil?
2482
+ command.query['pageSize'] = page_size unless page_size.nil?
2483
+ command.query['pageToken'] = page_token unless page_token.nil?
2484
+ command.query['parent'] = parent unless parent.nil?
2485
+ command.query['planDescription'] = plan_description unless plan_description.nil?
2486
+ command.query['fields'] = fields unless fields.nil?
2487
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2488
+ execute_or_queue_command(command, &block)
2489
+ end
2490
+
2491
+ # Obtain data corresponding to tasks for a spark stage attempt for a Spark
2492
+ # Application.
2493
+ # @param [String] name
2494
+ # Required. The fully qualified name of the session to retrieve in the format "
2495
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/
2496
+ # sparkApplications/APPLICATION_ID"
2497
+ # @param [Fixnum] page_size
2498
+ # Optional. Maximum number of tasks to return in each response. The service may
2499
+ # return fewer than this. The default page size is 10; the maximum page size is
2500
+ # 100.
2501
+ # @param [String] page_token
2502
+ # Optional. A page token received from a previous
2503
+ # SearchSessionSparkApplicationStageAttemptTasks call. Provide this token to
2504
+ # retrieve the subsequent page.
2505
+ # @param [String] parent
2506
+ # Required. Parent (Session) resource reference.
2507
+ # @param [Boolean] sort_runtime
2508
+ # Optional. Sort the tasks by runtime.
2509
+ # @param [Fixnum] stage_attempt_id
2510
+ # Optional. Stage Attempt ID
2511
+ # @param [Fixnum] stage_id
2512
+ # Optional. Stage ID
2513
+ # @param [String] task_status
2514
+ # Optional. List only tasks in the state.
2515
+ # @param [String] fields
2516
+ # Selector specifying which fields to include in a partial response.
2517
+ # @param [String] quota_user
2518
+ # Available to use for quota purposes for server-side applications. Can be any
2519
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2520
+ # @param [Google::Apis::RequestOptions] options
2521
+ # Request-specific options
2522
+ #
2523
+ # @yield [result, err] Result & error if block supplied
2524
+ # @yieldparam result [Google::Apis::DataprocV1::SearchSessionSparkApplicationStageAttemptTasksResponse] parsed result object
2525
+ # @yieldparam err [StandardError] error object if request failed
2526
+ #
2527
+ # @return [Google::Apis::DataprocV1::SearchSessionSparkApplicationStageAttemptTasksResponse]
2528
+ #
2529
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2530
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2531
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2532
+ def search_project_location_session_spark_application_stage_attempt_tasks(name, page_size: nil, page_token: nil, parent: nil, sort_runtime: nil, stage_attempt_id: nil, stage_id: nil, task_status: nil, fields: nil, quota_user: nil, options: nil, &block)
2533
+ command = make_simple_command(:get, 'v1/{+name}:searchStageAttemptTasks', options)
2534
+ command.response_representation = Google::Apis::DataprocV1::SearchSessionSparkApplicationStageAttemptTasksResponse::Representation
2535
+ command.response_class = Google::Apis::DataprocV1::SearchSessionSparkApplicationStageAttemptTasksResponse
2536
+ command.params['name'] = name unless name.nil?
2537
+ command.query['pageSize'] = page_size unless page_size.nil?
2538
+ command.query['pageToken'] = page_token unless page_token.nil?
2539
+ command.query['parent'] = parent unless parent.nil?
2540
+ command.query['sortRuntime'] = sort_runtime unless sort_runtime.nil?
2541
+ command.query['stageAttemptId'] = stage_attempt_id unless stage_attempt_id.nil?
2542
+ command.query['stageId'] = stage_id unless stage_id.nil?
2543
+ command.query['taskStatus'] = task_status unless task_status.nil?
2544
+ command.query['fields'] = fields unless fields.nil?
2545
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2546
+ execute_or_queue_command(command, &block)
2547
+ end
2548
+
2549
+ # Obtain data corresponding to a spark stage attempts for a Spark Application.
2550
+ # @param [String] name
2551
+ # Required. The fully qualified name of the session to retrieve in the format "
2552
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/
2553
+ # sparkApplications/APPLICATION_ID"
2554
+ # @param [Fixnum] page_size
2555
+ # Optional. Maximum number of stage attempts (paging based on stage_attempt_id)
2556
+ # to return in each response. The service may return fewer than this. The
2557
+ # default page size is 10; the maximum page size is 100.
2558
+ # @param [String] page_token
2559
+ # Optional. A page token received from a previous
2560
+ # SearchSessionSparkApplicationStageAttempts call. Provide this token to
2561
+ # retrieve the subsequent page.
2562
+ # @param [String] parent
2563
+ # Required. Parent (Session) resource reference.
2564
+ # @param [Fixnum] stage_id
2565
+ # Required. Stage ID for which attempts are to be fetched
2566
+ # @param [String] summary_metrics_mask
2567
+ # Optional. The list of summary metrics fields to include. Empty list will
2568
+ # default to skip all summary metrics fields. Example, if the response should
2569
+ # include TaskQuantileMetrics, the request should have task_quantile_metrics in
2570
+ # summary_metrics_mask field
2571
+ # @param [String] fields
2572
+ # Selector specifying which fields to include in a partial response.
2573
+ # @param [String] quota_user
2574
+ # Available to use for quota purposes for server-side applications. Can be any
2575
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2576
+ # @param [Google::Apis::RequestOptions] options
2577
+ # Request-specific options
2578
+ #
2579
+ # @yield [result, err] Result & error if block supplied
2580
+ # @yieldparam result [Google::Apis::DataprocV1::SearchSessionSparkApplicationStageAttemptsResponse] parsed result object
2581
+ # @yieldparam err [StandardError] error object if request failed
2582
+ #
2583
+ # @return [Google::Apis::DataprocV1::SearchSessionSparkApplicationStageAttemptsResponse]
2584
+ #
2585
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2586
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2587
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2588
+ def search_project_location_session_spark_application_stage_attempts(name, page_size: nil, page_token: nil, parent: nil, stage_id: nil, summary_metrics_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
2589
+ command = make_simple_command(:get, 'v1/{+name}:searchStageAttempts', options)
2590
+ command.response_representation = Google::Apis::DataprocV1::SearchSessionSparkApplicationStageAttemptsResponse::Representation
2591
+ command.response_class = Google::Apis::DataprocV1::SearchSessionSparkApplicationStageAttemptsResponse
2592
+ command.params['name'] = name unless name.nil?
2593
+ command.query['pageSize'] = page_size unless page_size.nil?
2594
+ command.query['pageToken'] = page_token unless page_token.nil?
2595
+ command.query['parent'] = parent unless parent.nil?
2596
+ command.query['stageId'] = stage_id unless stage_id.nil?
2597
+ command.query['summaryMetricsMask'] = summary_metrics_mask unless summary_metrics_mask.nil?
2598
+ command.query['fields'] = fields unless fields.nil?
2599
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2600
+ execute_or_queue_command(command, &block)
2601
+ end
2602
+
2603
+ # Obtain data corresponding to stages for a Spark Application.
2604
+ # @param [String] name
2605
+ # Required. The fully qualified name of the session to retrieve in the format "
2606
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/
2607
+ # sparkApplications/APPLICATION_ID"
2608
+ # @param [Fixnum] page_size
2609
+ # Optional. Maximum number of stages (paging based on stage_id) to return in
2610
+ # each response. The service may return fewer than this. The default page size
2611
+ # is 10; the maximum page size is 100.
2612
+ # @param [String] page_token
2613
+ # Optional. A page token received from a previous
2614
+ # SearchSessionSparkApplicationStages call. Provide this token to retrieve the
2615
+ # subsequent page.
2616
+ # @param [String] parent
2617
+ # Required. Parent (Session) resource reference.
2618
+ # @param [String] stage_status
2619
+ # Optional. List only stages in the given state.
2620
+ # @param [String] summary_metrics_mask
2621
+ # Optional. The list of summary metrics fields to include. Empty list will
2622
+ # default to skip all summary metrics fields. Example, if the response should
2623
+ # include TaskQuantileMetrics, the request should have task_quantile_metrics in
2624
+ # summary_metrics_mask field
2625
+ # @param [String] fields
2626
+ # Selector specifying which fields to include in a partial response.
2627
+ # @param [String] quota_user
2628
+ # Available to use for quota purposes for server-side applications. Can be any
2629
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2630
+ # @param [Google::Apis::RequestOptions] options
2631
+ # Request-specific options
2632
+ #
2633
+ # @yield [result, err] Result & error if block supplied
2634
+ # @yieldparam result [Google::Apis::DataprocV1::SearchSessionSparkApplicationStagesResponse] parsed result object
2635
+ # @yieldparam err [StandardError] error object if request failed
2636
+ #
2637
+ # @return [Google::Apis::DataprocV1::SearchSessionSparkApplicationStagesResponse]
2638
+ #
2639
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2640
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2641
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2642
+ def search_project_location_session_spark_application_stages(name, page_size: nil, page_token: nil, parent: nil, stage_status: nil, summary_metrics_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
2643
+ command = make_simple_command(:get, 'v1/{+name}:searchStages', options)
2644
+ command.response_representation = Google::Apis::DataprocV1::SearchSessionSparkApplicationStagesResponse::Representation
2645
+ command.response_class = Google::Apis::DataprocV1::SearchSessionSparkApplicationStagesResponse
2646
+ command.params['name'] = name unless name.nil?
2647
+ command.query['pageSize'] = page_size unless page_size.nil?
2648
+ command.query['pageToken'] = page_token unless page_token.nil?
2649
+ command.query['parent'] = parent unless parent.nil?
2650
+ command.query['stageStatus'] = stage_status unless stage_status.nil?
2651
+ command.query['summaryMetricsMask'] = summary_metrics_mask unless summary_metrics_mask.nil?
2652
+ command.query['fields'] = fields unless fields.nil?
2653
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2654
+ execute_or_queue_command(command, &block)
2655
+ end
2656
+
2657
+ # Obtain summary of Executor Summary for a Spark Application
2658
+ # @param [String] name
2659
+ # Required. The fully qualified name of the session to retrieve in the format "
2660
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/
2661
+ # sparkApplications/APPLICATION_ID"
2662
+ # @param [String] parent
2663
+ # Required. Parent (Session) resource reference.
2664
+ # @param [String] fields
2665
+ # Selector specifying which fields to include in a partial response.
2666
+ # @param [String] quota_user
2667
+ # Available to use for quota purposes for server-side applications. Can be any
2668
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2669
+ # @param [Google::Apis::RequestOptions] options
2670
+ # Request-specific options
2671
+ #
2672
+ # @yield [result, err] Result & error if block supplied
2673
+ # @yieldparam result [Google::Apis::DataprocV1::SummarizeSessionSparkApplicationExecutorsResponse] parsed result object
2674
+ # @yieldparam err [StandardError] error object if request failed
2675
+ #
2676
+ # @return [Google::Apis::DataprocV1::SummarizeSessionSparkApplicationExecutorsResponse]
2677
+ #
2678
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2679
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2680
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2681
+ def summarize_project_location_session_spark_application_executors(name, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
2682
+ command = make_simple_command(:get, 'v1/{+name}:summarizeExecutors', options)
2683
+ command.response_representation = Google::Apis::DataprocV1::SummarizeSessionSparkApplicationExecutorsResponse::Representation
2684
+ command.response_class = Google::Apis::DataprocV1::SummarizeSessionSparkApplicationExecutorsResponse
2685
+ command.params['name'] = name unless name.nil?
2686
+ command.query['parent'] = parent unless parent.nil?
2687
+ command.query['fields'] = fields unless fields.nil?
2688
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2689
+ execute_or_queue_command(command, &block)
2690
+ end
2691
+
2692
+ # Obtain summary of Jobs for a Spark Application
2693
+ # @param [String] name
2694
+ # Required. The fully qualified name of the session to retrieve in the format "
2695
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/
2696
+ # sparkApplications/APPLICATION_ID"
2697
+ # @param [String] parent
2698
+ # Required. Parent (Session) resource reference.
2699
+ # @param [String] fields
2700
+ # Selector specifying which fields to include in a partial response.
2701
+ # @param [String] quota_user
2702
+ # Available to use for quota purposes for server-side applications. Can be any
2703
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2704
+ # @param [Google::Apis::RequestOptions] options
2705
+ # Request-specific options
2706
+ #
2707
+ # @yield [result, err] Result & error if block supplied
2708
+ # @yieldparam result [Google::Apis::DataprocV1::SummarizeSessionSparkApplicationJobsResponse] parsed result object
2709
+ # @yieldparam err [StandardError] error object if request failed
2710
+ #
2711
+ # @return [Google::Apis::DataprocV1::SummarizeSessionSparkApplicationJobsResponse]
2712
+ #
2713
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2714
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2715
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2716
+ def summarize_project_location_session_spark_application_jobs(name, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
2717
+ command = make_simple_command(:get, 'v1/{+name}:summarizeJobs', options)
2718
+ command.response_representation = Google::Apis::DataprocV1::SummarizeSessionSparkApplicationJobsResponse::Representation
2719
+ command.response_class = Google::Apis::DataprocV1::SummarizeSessionSparkApplicationJobsResponse
2720
+ command.params['name'] = name unless name.nil?
2721
+ command.query['parent'] = parent unless parent.nil?
2722
+ command.query['fields'] = fields unless fields.nil?
2723
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2724
+ execute_or_queue_command(command, &block)
2725
+ end
2726
+
2727
+ # Obtain summary of Tasks for a Spark Application Stage Attempt
2728
+ # @param [String] name
2729
+ # Required. The fully qualified name of the session to retrieve in the format "
2730
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/
2731
+ # sparkApplications/APPLICATION_ID"
2732
+ # @param [String] parent
2733
+ # Required. Parent (Session) resource reference.
2734
+ # @param [Fixnum] stage_attempt_id
2735
+ # Required. Stage Attempt ID
2736
+ # @param [Fixnum] stage_id
2737
+ # Required. Stage ID
2738
+ # @param [String] fields
2739
+ # Selector specifying which fields to include in a partial response.
2740
+ # @param [String] quota_user
2741
+ # Available to use for quota purposes for server-side applications. Can be any
2742
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2743
+ # @param [Google::Apis::RequestOptions] options
2744
+ # Request-specific options
2745
+ #
2746
+ # @yield [result, err] Result & error if block supplied
2747
+ # @yieldparam result [Google::Apis::DataprocV1::SummarizeSessionSparkApplicationStageAttemptTasksResponse] parsed result object
2748
+ # @yieldparam err [StandardError] error object if request failed
2749
+ #
2750
+ # @return [Google::Apis::DataprocV1::SummarizeSessionSparkApplicationStageAttemptTasksResponse]
2751
+ #
2752
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2753
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2754
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2755
+ def summarize_project_location_session_spark_application_stage_attempt_tasks(name, parent: nil, stage_attempt_id: nil, stage_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2756
+ command = make_simple_command(:get, 'v1/{+name}:summarizeStageAttemptTasks', options)
2757
+ command.response_representation = Google::Apis::DataprocV1::SummarizeSessionSparkApplicationStageAttemptTasksResponse::Representation
2758
+ command.response_class = Google::Apis::DataprocV1::SummarizeSessionSparkApplicationStageAttemptTasksResponse
2759
+ command.params['name'] = name unless name.nil?
2760
+ command.query['parent'] = parent unless parent.nil?
2761
+ command.query['stageAttemptId'] = stage_attempt_id unless stage_attempt_id.nil?
2762
+ command.query['stageId'] = stage_id unless stage_id.nil?
2763
+ command.query['fields'] = fields unless fields.nil?
2764
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2765
+ execute_or_queue_command(command, &block)
2766
+ end
2767
+
2768
+ # Obtain summary of Stages for a Spark Application
2769
+ # @param [String] name
2770
+ # Required. The fully qualified name of the session to retrieve in the format "
2771
+ # projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/SESSION_ID/
2772
+ # sparkApplications/APPLICATION_ID"
2773
+ # @param [String] parent
2774
+ # Required. Parent (Session) resource reference.
2775
+ # @param [String] fields
2776
+ # Selector specifying which fields to include in a partial response.
2777
+ # @param [String] quota_user
2778
+ # Available to use for quota purposes for server-side applications. Can be any
2779
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2780
+ # @param [Google::Apis::RequestOptions] options
2781
+ # Request-specific options
2782
+ #
2783
+ # @yield [result, err] Result & error if block supplied
2784
+ # @yieldparam result [Google::Apis::DataprocV1::SummarizeSessionSparkApplicationStagesResponse] parsed result object
2785
+ # @yieldparam err [StandardError] error object if request failed
2786
+ #
2787
+ # @return [Google::Apis::DataprocV1::SummarizeSessionSparkApplicationStagesResponse]
2788
+ #
2789
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2790
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2791
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2792
+ def summarize_project_location_session_spark_application_stages(name, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
2793
+ command = make_simple_command(:get, 'v1/{+name}:summarizeStages', options)
2794
+ command.response_representation = Google::Apis::DataprocV1::SummarizeSessionSparkApplicationStagesResponse::Representation
2795
+ command.response_class = Google::Apis::DataprocV1::SummarizeSessionSparkApplicationStagesResponse
2796
+ command.params['name'] = name unless name.nil?
2797
+ command.query['parent'] = parent unless parent.nil?
2798
+ command.query['fields'] = fields unless fields.nil?
2799
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2800
+ execute_or_queue_command(command, &block)
2801
+ end
2802
+
2803
+ # Write wrapper objects from dataplane to spanner
2804
+ # @param [String] name
2805
+ # Required. The fully qualified name of the spark application to write data
2806
+ # about in the format "projects/PROJECT_ID/locations/DATAPROC_REGION/sessions/
2807
+ # SESSION_ID/sparkApplications/APPLICATION_ID"
2808
+ # @param [Google::Apis::DataprocV1::WriteSessionSparkApplicationContextRequest] write_session_spark_application_context_request_object
2809
+ # @param [String] fields
2810
+ # Selector specifying which fields to include in a partial response.
2811
+ # @param [String] quota_user
2812
+ # Available to use for quota purposes for server-side applications. Can be any
2813
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2814
+ # @param [Google::Apis::RequestOptions] options
2815
+ # Request-specific options
2816
+ #
2817
+ # @yield [result, err] Result & error if block supplied
2818
+ # @yieldparam result [Google::Apis::DataprocV1::WriteSessionSparkApplicationContextResponse] parsed result object
2819
+ # @yieldparam err [StandardError] error object if request failed
2820
+ #
2821
+ # @return [Google::Apis::DataprocV1::WriteSessionSparkApplicationContextResponse]
2822
+ #
2823
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2824
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2825
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2826
+ def write_session_spark_application_context(name, write_session_spark_application_context_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2827
+ command = make_simple_command(:post, 'v1/{+name}:write', options)
2828
+ command.request_representation = Google::Apis::DataprocV1::WriteSessionSparkApplicationContextRequest::Representation
2829
+ command.request_object = write_session_spark_application_context_request_object
2830
+ command.response_representation = Google::Apis::DataprocV1::WriteSessionSparkApplicationContextResponse::Representation
2831
+ command.response_class = Google::Apis::DataprocV1::WriteSessionSparkApplicationContextResponse
1071
2832
  command.params['name'] = name unless name.nil?
1072
2833
  command.query['fields'] = fields unless fields.nil?
1073
2834
  command.query['quotaUser'] = quota_user unless quota_user.nil?