google-apis-datamigration_v1 0.24.0 → 0.25.0

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