google-apis-dataproc_v1 0.72.0 → 0.73.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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?