google-apis-datamigration_v1 0.24.0 → 0.25.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -134,6 +134,12 @@ module Google
134
134
  # to always set this value to a UUID. The id must contain only letters (a-z, A-Z)
135
135
  # , numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40
136
136
  # characters.
137
+ # @param [Boolean] skip_validation
138
+ # Optional. Create the connection profile without validating it. The default is
139
+ # false. Only supported for Oracle connection profiles.
140
+ # @param [Boolean] validate_only
141
+ # Optional. Only validate the connection profile, but don't create any resources.
142
+ # The default is false. Only supported for Oracle connection profiles.
137
143
  # @param [String] fields
138
144
  # Selector specifying which fields to include in a partial response.
139
145
  # @param [String] quota_user
@@ -151,7 +157,7 @@ module Google
151
157
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
152
158
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
153
159
  # @raise [Google::Apis::AuthorizationError] Authorization is required
154
- def create_project_location_connection_profile(parent, connection_profile_object = nil, connection_profile_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
160
+ def create_project_location_connection_profile(parent, connection_profile_object = nil, connection_profile_id: nil, request_id: nil, skip_validation: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
155
161
  command = make_simple_command(:post, 'v1/{+parent}/connectionProfiles', options)
156
162
  command.request_representation = Google::Apis::DatamigrationV1::ConnectionProfile::Representation
157
163
  command.request_object = connection_profile_object
@@ -160,6 +166,8 @@ module Google
160
166
  command.params['parent'] = parent unless parent.nil?
161
167
  command.query['connectionProfileId'] = connection_profile_id unless connection_profile_id.nil?
162
168
  command.query['requestId'] = request_id unless request_id.nil?
169
+ command.query['skipValidation'] = skip_validation unless skip_validation.nil?
170
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
163
171
  command.query['fields'] = fields unless fields.nil?
164
172
  command.query['quotaUser'] = quota_user unless quota_user.nil?
165
173
  execute_or_queue_command(command, &block)
@@ -347,9 +355,15 @@ module Google
347
355
  # to always set this value to a UUID. The id must contain only letters (a-z, A-Z)
348
356
  # , numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40
349
357
  # characters.
358
+ # @param [Boolean] skip_validation
359
+ # Optional. Update the connection profile without validating it. The default is
360
+ # false. Only supported for Oracle connection profiles.
350
361
  # @param [String] update_mask
351
362
  # Required. Field mask is used to specify the fields to be overwritten in the
352
363
  # connection profile resource by the update.
364
+ # @param [Boolean] validate_only
365
+ # Optional. Only validate the connection profile, but don't update any resources.
366
+ # The default is false. Only supported for Oracle connection profiles.
353
367
  # @param [String] fields
354
368
  # Selector specifying which fields to include in a partial response.
355
369
  # @param [String] quota_user
@@ -367,7 +381,7 @@ module Google
367
381
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
368
382
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
369
383
  # @raise [Google::Apis::AuthorizationError] Authorization is required
370
- def patch_project_location_connection_profile(name, connection_profile_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
384
+ def patch_project_location_connection_profile(name, connection_profile_object = nil, request_id: nil, skip_validation: nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
371
385
  command = make_simple_command(:patch, 'v1/{+name}', options)
372
386
  command.request_representation = Google::Apis::DatamigrationV1::ConnectionProfile::Representation
373
387
  command.request_object = connection_profile_object
@@ -375,7 +389,9 @@ module Google
375
389
  command.response_class = Google::Apis::DatamigrationV1::Operation
376
390
  command.params['name'] = name unless name.nil?
377
391
  command.query['requestId'] = request_id unless request_id.nil?
392
+ command.query['skipValidation'] = skip_validation unless skip_validation.nil?
378
393
  command.query['updateMask'] = update_mask unless update_mask.nil?
394
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
379
395
  command.query['fields'] = fields unless fields.nil?
380
396
  command.query['quotaUser'] = quota_user unless quota_user.nil?
381
397
  execute_or_queue_command(command, &block)
@@ -457,6 +473,561 @@ module Google
457
473
  execute_or_queue_command(command, &block)
458
474
  end
459
475
 
476
+ # Apply draft tree onto a specific destination database
477
+ # @param [String] name
478
+ # Required. Name of the conversion workspace resource to apply draft to
479
+ # destination for. in the form of: projects/`project`/locations/`location`/
480
+ # conversionWorkspaces/`conversion_workspace`.
481
+ # @param [Google::Apis::DatamigrationV1::ApplyConversionWorkspaceRequest] apply_conversion_workspace_request_object
482
+ # @param [String] fields
483
+ # Selector specifying which fields to include in a partial response.
484
+ # @param [String] quota_user
485
+ # Available to use for quota purposes for server-side applications. Can be any
486
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
487
+ # @param [Google::Apis::RequestOptions] options
488
+ # Request-specific options
489
+ #
490
+ # @yield [result, err] Result & error if block supplied
491
+ # @yieldparam result [Google::Apis::DatamigrationV1::Operation] parsed result object
492
+ # @yieldparam err [StandardError] error object if request failed
493
+ #
494
+ # @return [Google::Apis::DatamigrationV1::Operation]
495
+ #
496
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
497
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
498
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
499
+ def apply_conversion_workspace(name, apply_conversion_workspace_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
500
+ command = make_simple_command(:post, 'v1/{+name}:apply', options)
501
+ command.request_representation = Google::Apis::DatamigrationV1::ApplyConversionWorkspaceRequest::Representation
502
+ command.request_object = apply_conversion_workspace_request_object
503
+ command.response_representation = Google::Apis::DatamigrationV1::Operation::Representation
504
+ command.response_class = Google::Apis::DatamigrationV1::Operation
505
+ command.params['name'] = name unless name.nil?
506
+ command.query['fields'] = fields unless fields.nil?
507
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
508
+ execute_or_queue_command(command, &block)
509
+ end
510
+
511
+ # Marks all the data in the conversion workspace as committed.
512
+ # @param [String] name
513
+ # Required. Name of the conversion workspace resource to commit.
514
+ # @param [Google::Apis::DatamigrationV1::CommitConversionWorkspaceRequest] commit_conversion_workspace_request_object
515
+ # @param [String] fields
516
+ # Selector specifying which fields to include in a partial response.
517
+ # @param [String] quota_user
518
+ # Available to use for quota purposes for server-side applications. Can be any
519
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
520
+ # @param [Google::Apis::RequestOptions] options
521
+ # Request-specific options
522
+ #
523
+ # @yield [result, err] Result & error if block supplied
524
+ # @yieldparam result [Google::Apis::DatamigrationV1::Operation] parsed result object
525
+ # @yieldparam err [StandardError] error object if request failed
526
+ #
527
+ # @return [Google::Apis::DatamigrationV1::Operation]
528
+ #
529
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
530
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
531
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
532
+ def commit_conversion_workspace(name, commit_conversion_workspace_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
533
+ command = make_simple_command(:post, 'v1/{+name}:commit', options)
534
+ command.request_representation = Google::Apis::DatamigrationV1::CommitConversionWorkspaceRequest::Representation
535
+ command.request_object = commit_conversion_workspace_request_object
536
+ command.response_representation = Google::Apis::DatamigrationV1::Operation::Representation
537
+ command.response_class = Google::Apis::DatamigrationV1::Operation
538
+ command.params['name'] = name unless name.nil?
539
+ command.query['fields'] = fields unless fields.nil?
540
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
541
+ execute_or_queue_command(command, &block)
542
+ end
543
+
544
+ # Creates a draft tree schema for the destination database.
545
+ # @param [String] name
546
+ # Name of the conversion workspace resource to convert in the form of: projects/`
547
+ # project`/locations/`location`/conversionWorkspaces/`conversion_workspace`.
548
+ # @param [Google::Apis::DatamigrationV1::ConvertConversionWorkspaceRequest] convert_conversion_workspace_request_object
549
+ # @param [String] fields
550
+ # Selector specifying which fields to include in a partial response.
551
+ # @param [String] quota_user
552
+ # Available to use for quota purposes for server-side applications. Can be any
553
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
554
+ # @param [Google::Apis::RequestOptions] options
555
+ # Request-specific options
556
+ #
557
+ # @yield [result, err] Result & error if block supplied
558
+ # @yieldparam result [Google::Apis::DatamigrationV1::Operation] parsed result object
559
+ # @yieldparam err [StandardError] error object if request failed
560
+ #
561
+ # @return [Google::Apis::DatamigrationV1::Operation]
562
+ #
563
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
564
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
565
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
566
+ def convert_conversion_workspace(name, convert_conversion_workspace_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
567
+ command = make_simple_command(:post, 'v1/{+name}:convert', options)
568
+ command.request_representation = Google::Apis::DatamigrationV1::ConvertConversionWorkspaceRequest::Representation
569
+ command.request_object = convert_conversion_workspace_request_object
570
+ command.response_representation = Google::Apis::DatamigrationV1::Operation::Representation
571
+ command.response_class = Google::Apis::DatamigrationV1::Operation
572
+ command.params['name'] = name unless name.nil?
573
+ command.query['fields'] = fields unless fields.nil?
574
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
575
+ execute_or_queue_command(command, &block)
576
+ end
577
+
578
+ # Creates a new conversion workspace in a given project and location.
579
+ # @param [String] parent
580
+ # Required. The parent, which owns this collection of conversion workspaces.
581
+ # @param [Google::Apis::DatamigrationV1::ConversionWorkspace] conversion_workspace_object
582
+ # @param [String] conversion_workspace_id
583
+ # Required. The ID of the conversion workspace to create.
584
+ # @param [String] request_id
585
+ # A unique id used to identify the request. If the server receives two requests
586
+ # with the same id, then the second request will be ignored. It is recommended
587
+ # to always set this value to a UUID. The id must contain only letters (a-z, A-Z)
588
+ # , numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40
589
+ # characters.
590
+ # @param [String] fields
591
+ # Selector specifying which fields to include in a partial response.
592
+ # @param [String] quota_user
593
+ # Available to use for quota purposes for server-side applications. Can be any
594
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
595
+ # @param [Google::Apis::RequestOptions] options
596
+ # Request-specific options
597
+ #
598
+ # @yield [result, err] Result & error if block supplied
599
+ # @yieldparam result [Google::Apis::DatamigrationV1::Operation] parsed result object
600
+ # @yieldparam err [StandardError] error object if request failed
601
+ #
602
+ # @return [Google::Apis::DatamigrationV1::Operation]
603
+ #
604
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
605
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
606
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
607
+ def create_project_location_conversion_workspace(parent, conversion_workspace_object = nil, conversion_workspace_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
608
+ command = make_simple_command(:post, 'v1/{+parent}/conversionWorkspaces', options)
609
+ command.request_representation = Google::Apis::DatamigrationV1::ConversionWorkspace::Representation
610
+ command.request_object = conversion_workspace_object
611
+ command.response_representation = Google::Apis::DatamigrationV1::Operation::Representation
612
+ command.response_class = Google::Apis::DatamigrationV1::Operation
613
+ command.params['parent'] = parent unless parent.nil?
614
+ command.query['conversionWorkspaceId'] = conversion_workspace_id unless conversion_workspace_id.nil?
615
+ command.query['requestId'] = request_id unless request_id.nil?
616
+ command.query['fields'] = fields unless fields.nil?
617
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
618
+ execute_or_queue_command(command, &block)
619
+ end
620
+
621
+ # Deletes a single conversion workspace.
622
+ # @param [String] name
623
+ # Required. Name of the conversion workspace resource to delete.
624
+ # @param [String] request_id
625
+ # A unique id used to identify the request. If the server receives two requests
626
+ # with the same id, then the second request will be ignored. It is recommended
627
+ # to always set this value to a UUID. The id must contain only letters (a-z, A-Z)
628
+ # , numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40
629
+ # characters.
630
+ # @param [String] fields
631
+ # Selector specifying which fields to include in a partial response.
632
+ # @param [String] quota_user
633
+ # Available to use for quota purposes for server-side applications. Can be any
634
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
635
+ # @param [Google::Apis::RequestOptions] options
636
+ # Request-specific options
637
+ #
638
+ # @yield [result, err] Result & error if block supplied
639
+ # @yieldparam result [Google::Apis::DatamigrationV1::Operation] parsed result object
640
+ # @yieldparam err [StandardError] error object if request failed
641
+ #
642
+ # @return [Google::Apis::DatamigrationV1::Operation]
643
+ #
644
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
645
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
646
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
647
+ def delete_project_location_conversion_workspace(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
648
+ command = make_simple_command(:delete, 'v1/{+name}', options)
649
+ command.response_representation = Google::Apis::DatamigrationV1::Operation::Representation
650
+ command.response_class = Google::Apis::DatamigrationV1::Operation
651
+ command.params['name'] = name unless name.nil?
652
+ command.query['requestId'] = request_id unless request_id.nil?
653
+ command.query['fields'] = fields unless fields.nil?
654
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
655
+ execute_or_queue_command(command, &block)
656
+ end
657
+
658
+ # Retrieves a list of committed revisions of a specific conversion workspace.
659
+ # @param [String] conversion_workspace
660
+ # Required. Name of the conversion workspace resource whose revisions are listed.
661
+ # in the form of: projects/`project`/locations/`location`/conversionWorkspaces/`
662
+ # conversion_workspace`.
663
+ # @param [String] commit_id
664
+ # Optional filter to request a specific commit id
665
+ # @param [String] fields
666
+ # Selector specifying which fields to include in a partial response.
667
+ # @param [String] quota_user
668
+ # Available to use for quota purposes for server-side applications. Can be any
669
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
670
+ # @param [Google::Apis::RequestOptions] options
671
+ # Request-specific options
672
+ #
673
+ # @yield [result, err] Result & error if block supplied
674
+ # @yieldparam result [Google::Apis::DatamigrationV1::DescribeConversionWorkspaceRevisionsResponse] parsed result object
675
+ # @yieldparam err [StandardError] error object if request failed
676
+ #
677
+ # @return [Google::Apis::DatamigrationV1::DescribeConversionWorkspaceRevisionsResponse]
678
+ #
679
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
680
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
681
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
682
+ def describe_project_location_conversion_workspace_conversion_workspace_revisions(conversion_workspace, commit_id: nil, fields: nil, quota_user: nil, options: nil, &block)
683
+ command = make_simple_command(:get, 'v1/{+conversionWorkspace}:describeConversionWorkspaceRevisions', options)
684
+ command.response_representation = Google::Apis::DatamigrationV1::DescribeConversionWorkspaceRevisionsResponse::Representation
685
+ command.response_class = Google::Apis::DatamigrationV1::DescribeConversionWorkspaceRevisionsResponse
686
+ command.params['conversionWorkspace'] = conversion_workspace unless conversion_workspace.nil?
687
+ command.query['commitId'] = commit_id unless commit_id.nil?
688
+ command.query['fields'] = fields unless fields.nil?
689
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
690
+ execute_or_queue_command(command, &block)
691
+ end
692
+
693
+ # Use this method to describe the database entities tree for a specific
694
+ # conversion workspace and a specific tree type. The DB Entities are not a
695
+ # resource like conversion workspace or mapping rule, and they can not be
696
+ # created, updated or deleted like one. Instead they are simple data objects
697
+ # describing the structure of the client database.
698
+ # @param [String] conversion_workspace
699
+ # Required. Name of the conversion workspace resource whose DB entities are
700
+ # described in the form of: projects/`project`/locations/`location`/
701
+ # conversionWorkspaces/`conversion_workspace`.
702
+ # @param [String] commit_id
703
+ # Request a specific commit id. If not specified, the entities from the latest
704
+ # commit are returned.
705
+ # @param [String] filter
706
+ # Filter the returned entities based on AIP-160 standard
707
+ # @param [Fixnum] page_size
708
+ # The maximum number of entities to return. The service may return fewer than
709
+ # this value.
710
+ # @param [String] page_token
711
+ # The nextPageToken value received in the previous call to conversionWorkspace.
712
+ # describeDatabaseEntities, used in the subsequent request to retrieve the next
713
+ # page of results. On first call this should be left blank. When paginating, all
714
+ # other parameters provided to conversionWorkspace.describeDatabaseEntities must
715
+ # match the call that provided the page token.
716
+ # @param [String] tree
717
+ # The tree to fetch
718
+ # @param [Boolean] uncommitted
719
+ # Whether to retrieve the latest committed version of the entities or the latest
720
+ # version. This field is ignored if a specific commit_id is specified.
721
+ # @param [String] fields
722
+ # Selector specifying which fields to include in a partial response.
723
+ # @param [String] quota_user
724
+ # Available to use for quota purposes for server-side applications. Can be any
725
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
726
+ # @param [Google::Apis::RequestOptions] options
727
+ # Request-specific options
728
+ #
729
+ # @yield [result, err] Result & error if block supplied
730
+ # @yieldparam result [Google::Apis::DatamigrationV1::DescribeDatabaseEntitiesResponse] parsed result object
731
+ # @yieldparam err [StandardError] error object if request failed
732
+ #
733
+ # @return [Google::Apis::DatamigrationV1::DescribeDatabaseEntitiesResponse]
734
+ #
735
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
736
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
737
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
738
+ def describe_project_location_conversion_workspace_database_entities(conversion_workspace, commit_id: nil, filter: nil, page_size: nil, page_token: nil, tree: nil, uncommitted: nil, fields: nil, quota_user: nil, options: nil, &block)
739
+ command = make_simple_command(:get, 'v1/{+conversionWorkspace}:describeDatabaseEntities', options)
740
+ command.response_representation = Google::Apis::DatamigrationV1::DescribeDatabaseEntitiesResponse::Representation
741
+ command.response_class = Google::Apis::DatamigrationV1::DescribeDatabaseEntitiesResponse
742
+ command.params['conversionWorkspace'] = conversion_workspace unless conversion_workspace.nil?
743
+ command.query['commitId'] = commit_id unless commit_id.nil?
744
+ command.query['filter'] = filter unless filter.nil?
745
+ command.query['pageSize'] = page_size unless page_size.nil?
746
+ command.query['pageToken'] = page_token unless page_token.nil?
747
+ command.query['tree'] = tree unless tree.nil?
748
+ command.query['uncommitted'] = uncommitted unless uncommitted.nil?
749
+ command.query['fields'] = fields unless fields.nil?
750
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
751
+ execute_or_queue_command(command, &block)
752
+ end
753
+
754
+ # Gets details of a single conversion workspace.
755
+ # @param [String] name
756
+ # Required. Name of the conversion workspace resource to get.
757
+ # @param [String] fields
758
+ # Selector specifying which fields to include in a partial response.
759
+ # @param [String] quota_user
760
+ # Available to use for quota purposes for server-side applications. Can be any
761
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
762
+ # @param [Google::Apis::RequestOptions] options
763
+ # Request-specific options
764
+ #
765
+ # @yield [result, err] Result & error if block supplied
766
+ # @yieldparam result [Google::Apis::DatamigrationV1::ConversionWorkspace] parsed result object
767
+ # @yieldparam err [StandardError] error object if request failed
768
+ #
769
+ # @return [Google::Apis::DatamigrationV1::ConversionWorkspace]
770
+ #
771
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
772
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
773
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
774
+ def get_project_location_conversion_workspace(name, fields: nil, quota_user: nil, options: nil, &block)
775
+ command = make_simple_command(:get, 'v1/{+name}', options)
776
+ command.response_representation = Google::Apis::DatamigrationV1::ConversionWorkspace::Representation
777
+ command.response_class = Google::Apis::DatamigrationV1::ConversionWorkspace
778
+ command.params['name'] = name unless name.nil?
779
+ command.query['fields'] = fields unless fields.nil?
780
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
781
+ execute_or_queue_command(command, &block)
782
+ end
783
+
784
+ # Lists conversion workspaces in a given project and location.
785
+ # @param [String] parent
786
+ # Required. The parent, which owns this collection of conversion workspaces.
787
+ # @param [String] filter
788
+ # A filter expression that filters conversion workspaces listed in the response.
789
+ # The expression must specify the field name, a comparison operator, and the
790
+ # value that you want to use for filtering. The value must be a string, a number,
791
+ # or a boolean. The comparison operator must be either =, !=, >, or <. For
792
+ # example, list conversion workspaces created this year by specifying **
793
+ # createTime %gt; 2020-01-01T00:00:00.000000000Z.** You can also filter nested
794
+ # fields. For example, you could specify **source.version = "12.c.1"** to select
795
+ # all conversion workspaces with source database version equal to 12.c.1
796
+ # @param [Fixnum] page_size
797
+ # The maximum number of conversion workspaces to return. The service may return
798
+ # fewer than this value. If unspecified, at most 50 sets will be returned.
799
+ # @param [String] page_token
800
+ # The nextPageToken value received in the previous call to conversionWorkspaces.
801
+ # list, used in the subsequent request to retrieve the next page of results. On
802
+ # first call this should be left blank. When paginating, all other parameters
803
+ # provided to conversionWorkspaces.list must match the call that provided the
804
+ # page token.
805
+ # @param [String] fields
806
+ # Selector specifying which fields to include in a partial response.
807
+ # @param [String] quota_user
808
+ # Available to use for quota purposes for server-side applications. Can be any
809
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
810
+ # @param [Google::Apis::RequestOptions] options
811
+ # Request-specific options
812
+ #
813
+ # @yield [result, err] Result & error if block supplied
814
+ # @yieldparam result [Google::Apis::DatamigrationV1::ListConversionWorkspacesResponse] parsed result object
815
+ # @yieldparam err [StandardError] error object if request failed
816
+ #
817
+ # @return [Google::Apis::DatamigrationV1::ListConversionWorkspacesResponse]
818
+ #
819
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
820
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
821
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
822
+ def list_project_location_conversion_workspaces(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
823
+ command = make_simple_command(:get, 'v1/{+parent}/conversionWorkspaces', options)
824
+ command.response_representation = Google::Apis::DatamigrationV1::ListConversionWorkspacesResponse::Representation
825
+ command.response_class = Google::Apis::DatamigrationV1::ListConversionWorkspacesResponse
826
+ command.params['parent'] = parent unless parent.nil?
827
+ command.query['filter'] = filter unless filter.nil?
828
+ command.query['pageSize'] = page_size unless page_size.nil?
829
+ command.query['pageToken'] = page_token unless page_token.nil?
830
+ command.query['fields'] = fields unless fields.nil?
831
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
832
+ execute_or_queue_command(command, &block)
833
+ end
834
+
835
+ # Updates the parameters of a single conversion workspace.
836
+ # @param [String] name
837
+ # Full name of the workspace resource, in the form of: projects/`project`/
838
+ # locations/`location`/conversionWorkspaces/`conversion_workspace`.
839
+ # @param [Google::Apis::DatamigrationV1::ConversionWorkspace] conversion_workspace_object
840
+ # @param [String] request_id
841
+ # A unique id used to identify the request. If the server receives two requests
842
+ # with the same id, then the second request will be ignored. It is recommended
843
+ # to always set this value to a UUID. The id must contain only letters (a-z, A-Z)
844
+ # , numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40
845
+ # characters.
846
+ # @param [String] update_mask
847
+ # Required. Field mask is used to specify the fields to be overwritten in the
848
+ # conversion workspace resource by the update.
849
+ # @param [String] fields
850
+ # Selector specifying which fields to include in a partial response.
851
+ # @param [String] quota_user
852
+ # Available to use for quota purposes for server-side applications. Can be any
853
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
854
+ # @param [Google::Apis::RequestOptions] options
855
+ # Request-specific options
856
+ #
857
+ # @yield [result, err] Result & error if block supplied
858
+ # @yieldparam result [Google::Apis::DatamigrationV1::Operation] parsed result object
859
+ # @yieldparam err [StandardError] error object if request failed
860
+ #
861
+ # @return [Google::Apis::DatamigrationV1::Operation]
862
+ #
863
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
864
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
865
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
866
+ def patch_project_location_conversion_workspace(name, conversion_workspace_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
867
+ command = make_simple_command(:patch, 'v1/{+name}', options)
868
+ command.request_representation = Google::Apis::DatamigrationV1::ConversionWorkspace::Representation
869
+ command.request_object = conversion_workspace_object
870
+ command.response_representation = Google::Apis::DatamigrationV1::Operation::Representation
871
+ command.response_class = Google::Apis::DatamigrationV1::Operation
872
+ command.params['name'] = name unless name.nil?
873
+ command.query['requestId'] = request_id unless request_id.nil?
874
+ command.query['updateMask'] = update_mask unless update_mask.nil?
875
+ command.query['fields'] = fields unless fields.nil?
876
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
877
+ execute_or_queue_command(command, &block)
878
+ end
879
+
880
+ # Rollbacks a conversion workspace to the last committed spanshot.
881
+ # @param [String] name
882
+ # Required. Name of the conversion workspace resource to rollback to.
883
+ # @param [Google::Apis::DatamigrationV1::RollbackConversionWorkspaceRequest] rollback_conversion_workspace_request_object
884
+ # @param [String] fields
885
+ # Selector specifying which fields to include in a partial response.
886
+ # @param [String] quota_user
887
+ # Available to use for quota purposes for server-side applications. Can be any
888
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
889
+ # @param [Google::Apis::RequestOptions] options
890
+ # Request-specific options
891
+ #
892
+ # @yield [result, err] Result & error if block supplied
893
+ # @yieldparam result [Google::Apis::DatamigrationV1::Operation] parsed result object
894
+ # @yieldparam err [StandardError] error object if request failed
895
+ #
896
+ # @return [Google::Apis::DatamigrationV1::Operation]
897
+ #
898
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
899
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
900
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
901
+ def rollback_conversion_workspace(name, rollback_conversion_workspace_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
902
+ command = make_simple_command(:post, 'v1/{+name}:rollback', options)
903
+ command.request_representation = Google::Apis::DatamigrationV1::RollbackConversionWorkspaceRequest::Representation
904
+ command.request_object = rollback_conversion_workspace_request_object
905
+ command.response_representation = Google::Apis::DatamigrationV1::Operation::Representation
906
+ command.response_class = Google::Apis::DatamigrationV1::Operation
907
+ command.params['name'] = name unless name.nil?
908
+ command.query['fields'] = fields unless fields.nil?
909
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
910
+ execute_or_queue_command(command, &block)
911
+ end
912
+
913
+ # Use this method to search/list the background jobs for a specific conversion
914
+ # workspace. The background jobs are not a resource like conversion workspace or
915
+ # mapping rule, and they can not be created, updated or deleted like one.
916
+ # Instead they are a way to expose the data plane jobs log.
917
+ # @param [String] conversion_workspace
918
+ # Required. Name of the conversion workspace resource whos jobs are listed. in
919
+ # the form of: projects/`project`/locations/`location`/conversionWorkspaces/`
920
+ # conversion_workspace`.
921
+ # @param [String] completed_until_time
922
+ # Optional. If supplied, will only return jobs that completed until (not
923
+ # including) the given timestamp.
924
+ # @param [Fixnum] max_size
925
+ # Optional. The maximum number of jobs to return. The service may return fewer
926
+ # than this value. If unspecified, at most 100 jobs will be returned. The
927
+ # maximum value is 100; values above 100 will be coerced to 100.
928
+ # @param [Boolean] return_most_recent_per_job_type
929
+ # Optional. Whether or not to return just the most recent job per job type
930
+ # @param [String] fields
931
+ # Selector specifying which fields to include in a partial response.
932
+ # @param [String] quota_user
933
+ # Available to use for quota purposes for server-side applications. Can be any
934
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
935
+ # @param [Google::Apis::RequestOptions] options
936
+ # Request-specific options
937
+ #
938
+ # @yield [result, err] Result & error if block supplied
939
+ # @yieldparam result [Google::Apis::DatamigrationV1::SearchBackgroundJobsResponse] parsed result object
940
+ # @yieldparam err [StandardError] error object if request failed
941
+ #
942
+ # @return [Google::Apis::DatamigrationV1::SearchBackgroundJobsResponse]
943
+ #
944
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
945
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
946
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
947
+ def search_project_location_conversion_workspace_background_jobs(conversion_workspace, completed_until_time: nil, max_size: nil, return_most_recent_per_job_type: nil, fields: nil, quota_user: nil, options: nil, &block)
948
+ command = make_simple_command(:get, 'v1/{+conversionWorkspace}:searchBackgroundJobs', options)
949
+ command.response_representation = Google::Apis::DatamigrationV1::SearchBackgroundJobsResponse::Representation
950
+ command.response_class = Google::Apis::DatamigrationV1::SearchBackgroundJobsResponse
951
+ command.params['conversionWorkspace'] = conversion_workspace unless conversion_workspace.nil?
952
+ command.query['completedUntilTime'] = completed_until_time unless completed_until_time.nil?
953
+ command.query['maxSize'] = max_size unless max_size.nil?
954
+ command.query['returnMostRecentPerJobType'] = return_most_recent_per_job_type unless return_most_recent_per_job_type.nil?
955
+ command.query['fields'] = fields unless fields.nil?
956
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
957
+ execute_or_queue_command(command, &block)
958
+ end
959
+
960
+ # Imports a snapshot of the source database into the conversion workspace.
961
+ # @param [String] name
962
+ # Name of the conversion workspace resource to seed with new database structure.
963
+ # in the form of: projects/`project`/locations/`location`/conversionWorkspaces/`
964
+ # conversion_workspace`.
965
+ # @param [Google::Apis::DatamigrationV1::SeedConversionWorkspaceRequest] seed_conversion_workspace_request_object
966
+ # @param [String] fields
967
+ # Selector specifying which fields to include in a partial response.
968
+ # @param [String] quota_user
969
+ # Available to use for quota purposes for server-side applications. Can be any
970
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
971
+ # @param [Google::Apis::RequestOptions] options
972
+ # Request-specific options
973
+ #
974
+ # @yield [result, err] Result & error if block supplied
975
+ # @yieldparam result [Google::Apis::DatamigrationV1::Operation] parsed result object
976
+ # @yieldparam err [StandardError] error object if request failed
977
+ #
978
+ # @return [Google::Apis::DatamigrationV1::Operation]
979
+ #
980
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
981
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
982
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
983
+ def seed_conversion_workspace(name, seed_conversion_workspace_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
984
+ command = make_simple_command(:post, 'v1/{+name}:seed', options)
985
+ command.request_representation = Google::Apis::DatamigrationV1::SeedConversionWorkspaceRequest::Representation
986
+ command.request_object = seed_conversion_workspace_request_object
987
+ command.response_representation = Google::Apis::DatamigrationV1::Operation::Representation
988
+ command.response_class = Google::Apis::DatamigrationV1::Operation
989
+ command.params['name'] = name unless name.nil?
990
+ command.query['fields'] = fields unless fields.nil?
991
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
992
+ execute_or_queue_command(command, &block)
993
+ end
994
+
995
+ # Imports the mapping rules for a given conversion workspace. Supports various
996
+ # formats of external rules files.
997
+ # @param [String] parent
998
+ # Required. Name of the conversion workspace resource to import the rules to in
999
+ # the form of: projects/`project`/locations/`location`/conversionWorkspaces/`
1000
+ # conversion_workspace`.
1001
+ # @param [Google::Apis::DatamigrationV1::ImportMappingRulesRequest] import_mapping_rules_request_object
1002
+ # @param [String] fields
1003
+ # Selector specifying which fields to include in a partial response.
1004
+ # @param [String] quota_user
1005
+ # Available to use for quota purposes for server-side applications. Can be any
1006
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1007
+ # @param [Google::Apis::RequestOptions] options
1008
+ # Request-specific options
1009
+ #
1010
+ # @yield [result, err] Result & error if block supplied
1011
+ # @yieldparam result [Google::Apis::DatamigrationV1::Operation] parsed result object
1012
+ # @yieldparam err [StandardError] error object if request failed
1013
+ #
1014
+ # @return [Google::Apis::DatamigrationV1::Operation]
1015
+ #
1016
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1017
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1018
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1019
+ def import_mapping_rules(parent, import_mapping_rules_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1020
+ command = make_simple_command(:post, 'v1/{+parent}/mappingRules:import', options)
1021
+ command.request_representation = Google::Apis::DatamigrationV1::ImportMappingRulesRequest::Representation
1022
+ command.request_object = import_mapping_rules_request_object
1023
+ command.response_representation = Google::Apis::DatamigrationV1::Operation::Representation
1024
+ command.response_class = Google::Apis::DatamigrationV1::Operation
1025
+ command.params['parent'] = parent unless parent.nil?
1026
+ command.query['fields'] = fields unless fields.nil?
1027
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1028
+ execute_or_queue_command(command, &block)
1029
+ end
1030
+
460
1031
  # Creates a new migration job in a given project and location.
461
1032
  # @param [String] parent
462
1033
  # Required. The parent, which owns this collection of migration jobs.
@@ -1177,6 +1748,168 @@ module Google
1177
1748
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1178
1749
  execute_or_queue_command(command, &block)
1179
1750
  end
1751
+
1752
+ # Creates a new private connection in a given project and location.
1753
+ # @param [String] parent
1754
+ # Required. The parent that owns the collection of PrivateConnections.
1755
+ # @param [Google::Apis::DatamigrationV1::PrivateConnection] private_connection_object
1756
+ # @param [String] private_connection_id
1757
+ # Required. The private connection identifier.
1758
+ # @param [String] request_id
1759
+ # Optional. A unique id used to identify the request. If the server receives two
1760
+ # requests with the same id, then the second request will be ignored. It is
1761
+ # recommended to always set this value to a UUID. The id must contain only
1762
+ # letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-). The
1763
+ # maximum length is 40 characters.
1764
+ # @param [String] fields
1765
+ # Selector specifying which fields to include in a partial response.
1766
+ # @param [String] quota_user
1767
+ # Available to use for quota purposes for server-side applications. Can be any
1768
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1769
+ # @param [Google::Apis::RequestOptions] options
1770
+ # Request-specific options
1771
+ #
1772
+ # @yield [result, err] Result & error if block supplied
1773
+ # @yieldparam result [Google::Apis::DatamigrationV1::Operation] parsed result object
1774
+ # @yieldparam err [StandardError] error object if request failed
1775
+ #
1776
+ # @return [Google::Apis::DatamigrationV1::Operation]
1777
+ #
1778
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1779
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1780
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1781
+ def create_project_location_private_connection(parent, private_connection_object = nil, private_connection_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1782
+ command = make_simple_command(:post, 'v1/{+parent}/privateConnections', options)
1783
+ command.request_representation = Google::Apis::DatamigrationV1::PrivateConnection::Representation
1784
+ command.request_object = private_connection_object
1785
+ command.response_representation = Google::Apis::DatamigrationV1::Operation::Representation
1786
+ command.response_class = Google::Apis::DatamigrationV1::Operation
1787
+ command.params['parent'] = parent unless parent.nil?
1788
+ command.query['privateConnectionId'] = private_connection_id unless private_connection_id.nil?
1789
+ command.query['requestId'] = request_id unless request_id.nil?
1790
+ command.query['fields'] = fields unless fields.nil?
1791
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1792
+ execute_or_queue_command(command, &block)
1793
+ end
1794
+
1795
+ # Deletes a single Database Migration Service private connection.
1796
+ # @param [String] name
1797
+ # Required. The name of the private connection to delete.
1798
+ # @param [String] request_id
1799
+ # Optional. A unique id used to identify the request. If the server receives two
1800
+ # requests with the same id, then the second request will be ignored. It is
1801
+ # recommended to always set this value to a UUID. The id must contain only
1802
+ # letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-). The
1803
+ # maximum length is 40 characters.
1804
+ # @param [String] fields
1805
+ # Selector specifying which fields to include in a partial response.
1806
+ # @param [String] quota_user
1807
+ # Available to use for quota purposes for server-side applications. Can be any
1808
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1809
+ # @param [Google::Apis::RequestOptions] options
1810
+ # Request-specific options
1811
+ #
1812
+ # @yield [result, err] Result & error if block supplied
1813
+ # @yieldparam result [Google::Apis::DatamigrationV1::Operation] parsed result object
1814
+ # @yieldparam err [StandardError] error object if request failed
1815
+ #
1816
+ # @return [Google::Apis::DatamigrationV1::Operation]
1817
+ #
1818
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1819
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1820
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1821
+ def delete_project_location_private_connection(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1822
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1823
+ command.response_representation = Google::Apis::DatamigrationV1::Operation::Representation
1824
+ command.response_class = Google::Apis::DatamigrationV1::Operation
1825
+ command.params['name'] = name unless name.nil?
1826
+ command.query['requestId'] = request_id unless request_id.nil?
1827
+ command.query['fields'] = fields unless fields.nil?
1828
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1829
+ execute_or_queue_command(command, &block)
1830
+ end
1831
+
1832
+ # Gets details of a single private connection.
1833
+ # @param [String] name
1834
+ # Required. The name of the private connection to get.
1835
+ # @param [String] fields
1836
+ # Selector specifying which fields to include in a partial response.
1837
+ # @param [String] quota_user
1838
+ # Available to use for quota purposes for server-side applications. Can be any
1839
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1840
+ # @param [Google::Apis::RequestOptions] options
1841
+ # Request-specific options
1842
+ #
1843
+ # @yield [result, err] Result & error if block supplied
1844
+ # @yieldparam result [Google::Apis::DatamigrationV1::PrivateConnection] parsed result object
1845
+ # @yieldparam err [StandardError] error object if request failed
1846
+ #
1847
+ # @return [Google::Apis::DatamigrationV1::PrivateConnection]
1848
+ #
1849
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1850
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1851
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1852
+ def get_project_location_private_connection(name, fields: nil, quota_user: nil, options: nil, &block)
1853
+ command = make_simple_command(:get, 'v1/{+name}', options)
1854
+ command.response_representation = Google::Apis::DatamigrationV1::PrivateConnection::Representation
1855
+ command.response_class = Google::Apis::DatamigrationV1::PrivateConnection
1856
+ command.params['name'] = name unless name.nil?
1857
+ command.query['fields'] = fields unless fields.nil?
1858
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1859
+ execute_or_queue_command(command, &block)
1860
+ end
1861
+
1862
+ # Retrieves a list of private connections in a given project and location.
1863
+ # @param [String] parent
1864
+ # Required. The parent that owns the collection of private connections.
1865
+ # @param [String] filter
1866
+ # A filter expression that filters private connections listed in the response.
1867
+ # The expression must specify the field name, a comparison operator, and the
1868
+ # value that you want to use for filtering. The value must be a string, a number,
1869
+ # or a boolean. The comparison operator must be either =, !=, >, or <. For
1870
+ # example, list private connections created this year by specifying **createTime
1871
+ # %gt; 2021-01-01T00:00:00.000000000Z**.
1872
+ # @param [String] order_by
1873
+ # Order by fields for the result.
1874
+ # @param [Fixnum] page_size
1875
+ # Maximum number of private connections to return. If unspecified, at most 50
1876
+ # private connections that will be returned. The maximum value is 1000; values
1877
+ # above 1000 will be coerced to 1000.
1878
+ # @param [String] page_token
1879
+ # Page token received from a previous `ListPrivateConnections` call. Provide
1880
+ # this to retrieve the subsequent page. When paginating, all other parameters
1881
+ # provided to `ListPrivateConnections` must match the call that provided the
1882
+ # page token.
1883
+ # @param [String] fields
1884
+ # Selector specifying which fields to include in a partial response.
1885
+ # @param [String] quota_user
1886
+ # Available to use for quota purposes for server-side applications. Can be any
1887
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1888
+ # @param [Google::Apis::RequestOptions] options
1889
+ # Request-specific options
1890
+ #
1891
+ # @yield [result, err] Result & error if block supplied
1892
+ # @yieldparam result [Google::Apis::DatamigrationV1::ListPrivateConnectionsResponse] parsed result object
1893
+ # @yieldparam err [StandardError] error object if request failed
1894
+ #
1895
+ # @return [Google::Apis::DatamigrationV1::ListPrivateConnectionsResponse]
1896
+ #
1897
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1898
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1899
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1900
+ def list_project_location_private_connections(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1901
+ command = make_simple_command(:get, 'v1/{+parent}/privateConnections', options)
1902
+ command.response_representation = Google::Apis::DatamigrationV1::ListPrivateConnectionsResponse::Representation
1903
+ command.response_class = Google::Apis::DatamigrationV1::ListPrivateConnectionsResponse
1904
+ command.params['parent'] = parent unless parent.nil?
1905
+ command.query['filter'] = filter unless filter.nil?
1906
+ command.query['orderBy'] = order_by unless order_by.nil?
1907
+ command.query['pageSize'] = page_size unless page_size.nil?
1908
+ command.query['pageToken'] = page_token unless page_token.nil?
1909
+ command.query['fields'] = fields unless fields.nil?
1910
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1911
+ execute_or_queue_command(command, &block)
1912
+ end
1180
1913
 
1181
1914
  protected
1182
1915