google-apis-datamigration_v1 0.28.0 → 0.30.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.
@@ -49,6 +49,44 @@ module Google
49
49
  @batch_path = 'batch'
50
50
  end
51
51
 
52
+ # Fetches a set of static IP addresses that need to be allowlisted by the
53
+ # customer when using the static-IP connectivity method.
54
+ # @param [String] name
55
+ # Required. The resource name for the location for which static IPs should be
56
+ # returned. Must be in the format `projects/*/locations/*`.
57
+ # @param [Fixnum] page_size
58
+ # Maximum number of IPs to return.
59
+ # @param [String] page_token
60
+ # A page token, received from a previous `FetchStaticIps` call.
61
+ # @param [String] fields
62
+ # Selector specifying which fields to include in a partial response.
63
+ # @param [String] quota_user
64
+ # Available to use for quota purposes for server-side applications. Can be any
65
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
66
+ # @param [Google::Apis::RequestOptions] options
67
+ # Request-specific options
68
+ #
69
+ # @yield [result, err] Result & error if block supplied
70
+ # @yieldparam result [Google::Apis::DatamigrationV1::FetchStaticIpsResponse] parsed result object
71
+ # @yieldparam err [StandardError] error object if request failed
72
+ #
73
+ # @return [Google::Apis::DatamigrationV1::FetchStaticIpsResponse]
74
+ #
75
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
76
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
77
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
78
+ def fetch_project_location_static_ips(name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
79
+ command = make_simple_command(:get, 'v1/{+name}:fetchStaticIps', options)
80
+ command.response_representation = Google::Apis::DatamigrationV1::FetchStaticIpsResponse::Representation
81
+ command.response_class = Google::Apis::DatamigrationV1::FetchStaticIpsResponse
82
+ command.params['name'] = name unless name.nil?
83
+ command.query['pageSize'] = page_size unless page_size.nil?
84
+ command.query['pageToken'] = page_token unless page_token.nil?
85
+ command.query['fields'] = fields unless fields.nil?
86
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
87
+ execute_or_queue_command(command, &block)
88
+ end
89
+
52
90
  # Gets information about a location.
53
91
  # @param [String] name
54
92
  # Resource name for the location.
@@ -124,14 +162,14 @@ module Google
124
162
 
125
163
  # Creates a new connection profile in a given project and location.
126
164
  # @param [String] parent
127
- # Required. The parent, which owns this collection of connection profiles.
165
+ # Required. The parent which owns this collection of connection profiles.
128
166
  # @param [Google::Apis::DatamigrationV1::ConnectionProfile] connection_profile_object
129
167
  # @param [String] connection_profile_id
130
168
  # Required. The connection profile identifier.
131
169
  # @param [String] request_id
132
- # Optional. A unique id used to identify the request. If the server receives two
133
- # requests with the same id, then the second request will be ignored. It is
134
- # recommended to always set this value to a UUID. The id must contain only
170
+ # Optional. A unique ID used to identify the request. If the server receives two
171
+ # requests with the same ID, then the second request is ignored. It is
172
+ # recommended to always set this value to a UUID. The ID must contain only
135
173
  # letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-). The
136
174
  # maximum length is 40 characters.
137
175
  # @param [Boolean] skip_validation
@@ -181,10 +219,10 @@ module Google
181
219
  # In case of force delete, the CloudSQL replica database is also deleted (only
182
220
  # for CloudSQL connection profile).
183
221
  # @param [String] request_id
184
- # A unique id used to identify the request. If the server receives two requests
185
- # with the same id, then the second request will be ignored. It is recommended
186
- # to always set this value to a UUID. The id must contain only letters (a-z, A-Z)
187
- # , numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40
222
+ # A unique ID used to identify the request. If the server receives two requests
223
+ # with the same ID, then the second request is ignored. It is recommended to
224
+ # always set this value to a UUID. The ID must contain only letters (a-z, A-Z),
225
+ # numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40
188
226
  # characters.
189
227
  # @param [String] fields
190
228
  # Selector specifying which fields to include in a partial response.
@@ -292,7 +330,7 @@ module Google
292
330
 
293
331
  # Retrieves a list of all connection profiles in a given project and location.
294
332
  # @param [String] parent
295
- # Required. The parent, which owns this collection of connection profiles.
333
+ # Required. The parent which owns this collection of connection profiles.
296
334
  # @param [String] filter
297
335
  # A filter expression that filters connection profiles listed in the response.
298
336
  # The expression must specify the field name, a comparison operator, and the
@@ -307,7 +345,7 @@ module Google
307
345
  # @param [Fixnum] page_size
308
346
  # The maximum number of connection profiles to return. The service may return
309
347
  # fewer than this value. If unspecified, at most 50 connection profiles will be
310
- # returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
348
+ # returned. The maximum value is 1000; values above 1000 are coerced to 1000.
311
349
  # @param [String] page_token
312
350
  # A page token, received from a previous `ListConnectionProfiles` call. Provide
313
351
  # this to retrieve the subsequent page. When paginating, all other parameters
@@ -350,17 +388,17 @@ module Google
350
388
  # locations/`location`/connectionProfiles/`connectionProfile`.
351
389
  # @param [Google::Apis::DatamigrationV1::ConnectionProfile] connection_profile_object
352
390
  # @param [String] request_id
353
- # Optional. A unique id used to identify the request. If the server receives two
354
- # requests with the same id, then the second request will be ignored. It is
355
- # recommended to always set this value to a UUID. The id must contain only
391
+ # Optional. A unique ID used to identify the request. If the server receives two
392
+ # requests with the same ID, then the second request is ignored. It is
393
+ # recommended to always set this value to a UUID. The ID must contain only
356
394
  # letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-). The
357
395
  # maximum length is 40 characters.
358
396
  # @param [Boolean] skip_validation
359
397
  # Optional. Update the connection profile without validating it. The default is
360
398
  # false. Only supported for Oracle connection profiles.
361
399
  # @param [String] update_mask
362
- # Required. Field mask is used to specify the fields to be overwritten in the
363
- # connection profile resource by the update.
400
+ # Required. Field mask is used to specify the fields to be overwritten by the
401
+ # update in the conversion workspace resource.
364
402
  # @param [Boolean] validate_only
365
403
  # Optional. Only validate the connection profile, but don't update any resources.
366
404
  # The default is false. Only supported for Oracle connection profiles.
@@ -473,10 +511,10 @@ module Google
473
511
  execute_or_queue_command(command, &block)
474
512
  end
475
513
 
476
- # Apply draft tree onto a specific destination database
514
+ # Applies draft tree onto a specific destination database.
477
515
  # @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`/
516
+ # Required. The name of the conversion workspace resource for which to apply the
517
+ # draft tree. Must be in the form of: projects/`project`/locations/`location`/
480
518
  # conversionWorkspaces/`conversion_workspace`.
481
519
  # @param [Google::Apis::DatamigrationV1::ApplyConversionWorkspaceRequest] apply_conversion_workspace_request_object
482
520
  # @param [String] fields
@@ -577,15 +615,15 @@ module Google
577
615
 
578
616
  # Creates a new conversion workspace in a given project and location.
579
617
  # @param [String] parent
580
- # Required. The parent, which owns this collection of conversion workspaces.
618
+ # Required. The parent which owns this collection of conversion workspaces.
581
619
  # @param [Google::Apis::DatamigrationV1::ConversionWorkspace] conversion_workspace_object
582
620
  # @param [String] conversion_workspace_id
583
621
  # Required. The ID of the conversion workspace to create.
584
622
  # @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
623
+ # A unique ID used to identify the request. If the server receives two requests
624
+ # with the same ID, then the second request is ignored. It is recommended to
625
+ # always set this value to a UUID. The ID must contain only letters (a-z, A-Z),
626
+ # numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40
589
627
  # characters.
590
628
  # @param [String] fields
591
629
  # Selector specifying which fields to include in a partial response.
@@ -622,10 +660,10 @@ module Google
622
660
  # @param [String] name
623
661
  # Required. Name of the conversion workspace resource to delete.
624
662
  # @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
663
+ # A unique ID used to identify the request. If the server receives two requests
664
+ # with the same ID, then the second request is ignored. It is recommended to
665
+ # always set this value to a UUID. The ID must contain only letters (a-z, A-Z),
666
+ # numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40
629
667
  # characters.
630
668
  # @param [String] fields
631
669
  # Selector specifying which fields to include in a partial response.
@@ -658,10 +696,10 @@ module Google
658
696
  # Retrieves a list of committed revisions of a specific conversion workspace.
659
697
  # @param [String] conversion_workspace
660
698
  # Required. Name of the conversion workspace resource whose revisions are listed.
661
- # in the form of: projects/`project`/locations/`location`/conversionWorkspaces/`
662
- # conversion_workspace`.
699
+ # Must be in the form of: projects/`project`/locations/`location`/
700
+ # conversionWorkspaces/`conversion_workspace`.
663
701
  # @param [String] commit_id
664
- # Optional. Optional filter to request a specific commit id
702
+ # Optional. Optional filter to request a specific commit ID.
665
703
  # @param [String] fields
666
704
  # Selector specifying which fields to include in a partial response.
667
705
  # @param [String] quota_user
@@ -690,23 +728,23 @@ module Google
690
728
  execute_or_queue_command(command, &block)
691
729
  end
692
730
 
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.
731
+ # Describes the database entities tree for a specific conversion workspace and a
732
+ # specific tree type. Database entities are not resources like conversion
733
+ # workspaces or mapping rules, and they can't be created, updated or deleted.
734
+ # Instead, they are simple data objects describing the structure of the client
735
+ # database.
698
736
  # @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`/
737
+ # Required. Name of the conversion workspace resource whose database entities
738
+ # are described. Must be in the form of: projects/`project`/locations/`location`/
701
739
  # conversionWorkspaces/`conversion_workspace`.
702
740
  # @param [String] commit_id
703
- # Request a specific commit id. If not specified, the entities from the latest
741
+ # Request a specific commit ID. If not specified, the entities from the latest
704
742
  # commit are returned.
705
743
  # @param [String] filter
706
744
  # Filter the returned entities based on AIP-160 standard.
707
745
  # @param [Fixnum] page_size
708
- # The maximum number of entities to return. The service may return fewer than
709
- # this value.
746
+ # The maximum number of entities to return. The service may return fewer
747
+ # entities than the value specifies.
710
748
  # @param [String] page_token
711
749
  # The nextPageToken value received in the previous call to conversionWorkspace.
712
750
  # describeDatabaseEntities, used in the subsequent request to retrieve the next
@@ -781,9 +819,54 @@ module Google
781
819
  execute_or_queue_command(command, &block)
782
820
  end
783
821
 
822
+ # Gets the access control policy for a resource. Returns an empty policy if the
823
+ # resource exists and does not have a policy set.
824
+ # @param [String] resource
825
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
826
+ # names](https://cloud.google.com/apis/design/resource_names) for the
827
+ # appropriate value for this field.
828
+ # @param [Fixnum] options_requested_policy_version
829
+ # Optional. The maximum policy version that will be used to format the policy.
830
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
831
+ # rejected. Requests for policies with any conditional role bindings must
832
+ # specify version 3. Policies with no conditional role bindings may specify any
833
+ # valid value or leave the field unset. The policy in the response might use the
834
+ # policy version that you specified, or it might use a lower policy version. For
835
+ # example, if you specify version 3, but the policy has no conditional role
836
+ # bindings, the response uses version 1. To learn which resources support
837
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
838
+ # google.com/iam/help/conditions/resource-policies).
839
+ # @param [String] fields
840
+ # Selector specifying which fields to include in a partial response.
841
+ # @param [String] quota_user
842
+ # Available to use for quota purposes for server-side applications. Can be any
843
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
844
+ # @param [Google::Apis::RequestOptions] options
845
+ # Request-specific options
846
+ #
847
+ # @yield [result, err] Result & error if block supplied
848
+ # @yieldparam result [Google::Apis::DatamigrationV1::Policy] parsed result object
849
+ # @yieldparam err [StandardError] error object if request failed
850
+ #
851
+ # @return [Google::Apis::DatamigrationV1::Policy]
852
+ #
853
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
854
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
855
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
856
+ def get_project_location_conversion_workspace_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
857
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
858
+ command.response_representation = Google::Apis::DatamigrationV1::Policy::Representation
859
+ command.response_class = Google::Apis::DatamigrationV1::Policy
860
+ command.params['resource'] = resource unless resource.nil?
861
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
862
+ command.query['fields'] = fields unless fields.nil?
863
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
864
+ execute_or_queue_command(command, &block)
865
+ end
866
+
784
867
  # Lists conversion workspaces in a given project and location.
785
868
  # @param [String] parent
786
- # Required. The parent, which owns this collection of conversion workspaces.
869
+ # Required. The parent which owns this collection of conversion workspaces.
787
870
  # @param [String] filter
788
871
  # A filter expression that filters conversion workspaces listed in the response.
789
872
  # The expression must specify the field name, a comparison operator, and the
@@ -792,10 +875,10 @@ module Google
792
875
  # example, list conversion workspaces created this year by specifying **
793
876
  # createTime %gt; 2020-01-01T00:00:00.000000000Z.** You can also filter nested
794
877
  # 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
878
+ # all conversion workspaces with source database version equal to 12.c.1.
796
879
  # @param [Fixnum] page_size
797
880
  # 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.
881
+ # fewer than this value. If unspecified, at most 50 sets are returned.
799
882
  # @param [String] page_token
800
883
  # The nextPageToken value received in the previous call to conversionWorkspaces.
801
884
  # list, used in the subsequent request to retrieve the next page of results. On
@@ -838,14 +921,14 @@ module Google
838
921
  # locations/`location`/conversionWorkspaces/`conversion_workspace`.
839
922
  # @param [Google::Apis::DatamigrationV1::ConversionWorkspace] conversion_workspace_object
840
923
  # @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
924
+ # A unique ID used to identify the request. If the server receives two requests
925
+ # with the same ID, then the second request is ignored. It is recommended to
926
+ # always set this value to a UUID. The ID must contain only letters (a-z, A-Z),
927
+ # numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40
845
928
  # characters.
846
929
  # @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.
930
+ # Required. Field mask is used to specify the fields to be overwritten by the
931
+ # update in the conversion workspace resource.
849
932
  # @param [String] fields
850
933
  # Selector specifying which fields to include in a partial response.
851
934
  # @param [String] quota_user
@@ -877,9 +960,9 @@ module Google
877
960
  execute_or_queue_command(command, &block)
878
961
  end
879
962
 
880
- # Rollbacks a conversion workspace to the last committed spanshot.
963
+ # Rolls back a conversion workspace to the last committed snapshot.
881
964
  # @param [String] name
882
- # Required. Name of the conversion workspace resource to rollback to.
965
+ # Required. Name of the conversion workspace resource to roll back to.
883
966
  # @param [Google::Apis::DatamigrationV1::RollbackConversionWorkspaceRequest] rollback_conversion_workspace_request_object
884
967
  # @param [String] fields
885
968
  # Selector specifying which fields to include in a partial response.
@@ -910,23 +993,23 @@ module Google
910
993
  execute_or_queue_command(command, &block)
911
994
  end
912
995
 
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.
996
+ # Searches/lists the background jobs for a specific conversion workspace. The
997
+ # background jobs are not resources like conversion workspaces or mapping rules,
998
+ # and they can't be created, updated or deleted. Instead, they are a way to
999
+ # expose the data plane jobs log.
917
1000
  # @param [String] conversion_workspace
918
- # Required. Name of the conversion workspace resource whos jobs are listed. in
1001
+ # Required. Name of the conversion workspace resource whose jobs are listed, in
919
1002
  # the form of: projects/`project`/locations/`location`/conversionWorkspaces/`
920
1003
  # conversion_workspace`.
921
1004
  # @param [String] completed_until_time
922
- # Optional. If supplied, will only return jobs that completed until (not
923
- # including) the given timestamp.
1005
+ # Optional. If provided, only returns jobs that completed until (not including)
1006
+ # the given timestamp.
924
1007
  # @param [Fixnum] max_size
925
1008
  # 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.
1009
+ # than this value. If unspecified, at most 100 jobs are returned. The maximum
1010
+ # value is 100; values above 100 are coerced to 100.
928
1011
  # @param [Boolean] return_most_recent_per_job_type
929
- # Optional. Whether or not to return just the most recent job per job type
1012
+ # Optional. Whether or not to return just the most recent job per job type,
930
1013
  # @param [String] fields
931
1014
  # Selector specifying which fields to include in a partial response.
932
1015
  # @param [String] quota_user
@@ -959,7 +1042,7 @@ module Google
959
1042
 
960
1043
  # Imports a snapshot of the source database into the conversion workspace.
961
1044
  # @param [String] name
962
- # Name of the conversion workspace resource to seed with new database structure.
1045
+ # Name of the conversion workspace resource to seed with new database structure,
963
1046
  # in the form of: projects/`project`/locations/`location`/conversionWorkspaces/`
964
1047
  # conversion_workspace`.
965
1048
  # @param [Google::Apis::DatamigrationV1::SeedConversionWorkspaceRequest] seed_conversion_workspace_request_object
@@ -992,6 +1075,82 @@ module Google
992
1075
  execute_or_queue_command(command, &block)
993
1076
  end
994
1077
 
1078
+ # Sets the access control policy on the specified resource. Replaces any
1079
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
1080
+ # PERMISSION_DENIED` errors.
1081
+ # @param [String] resource
1082
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
1083
+ # names](https://cloud.google.com/apis/design/resource_names) for the
1084
+ # appropriate value for this field.
1085
+ # @param [Google::Apis::DatamigrationV1::SetIamPolicyRequest] set_iam_policy_request_object
1086
+ # @param [String] fields
1087
+ # Selector specifying which fields to include in a partial response.
1088
+ # @param [String] quota_user
1089
+ # Available to use for quota purposes for server-side applications. Can be any
1090
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1091
+ # @param [Google::Apis::RequestOptions] options
1092
+ # Request-specific options
1093
+ #
1094
+ # @yield [result, err] Result & error if block supplied
1095
+ # @yieldparam result [Google::Apis::DatamigrationV1::Policy] parsed result object
1096
+ # @yieldparam err [StandardError] error object if request failed
1097
+ #
1098
+ # @return [Google::Apis::DatamigrationV1::Policy]
1099
+ #
1100
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1101
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1102
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1103
+ def set_conversion_workspace_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1104
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
1105
+ command.request_representation = Google::Apis::DatamigrationV1::SetIamPolicyRequest::Representation
1106
+ command.request_object = set_iam_policy_request_object
1107
+ command.response_representation = Google::Apis::DatamigrationV1::Policy::Representation
1108
+ command.response_class = Google::Apis::DatamigrationV1::Policy
1109
+ command.params['resource'] = resource unless resource.nil?
1110
+ command.query['fields'] = fields unless fields.nil?
1111
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1112
+ execute_or_queue_command(command, &block)
1113
+ end
1114
+
1115
+ # Returns permissions that a caller has on the specified resource. If the
1116
+ # resource does not exist, this will return an empty set of permissions, not a `
1117
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
1118
+ # permission-aware UIs and command-line tools, not for authorization checking.
1119
+ # This operation may "fail open" without warning.
1120
+ # @param [String] resource
1121
+ # REQUIRED: The resource for which the policy detail is being requested. See [
1122
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
1123
+ # appropriate value for this field.
1124
+ # @param [Google::Apis::DatamigrationV1::TestIamPermissionsRequest] test_iam_permissions_request_object
1125
+ # @param [String] fields
1126
+ # Selector specifying which fields to include in a partial response.
1127
+ # @param [String] quota_user
1128
+ # Available to use for quota purposes for server-side applications. Can be any
1129
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1130
+ # @param [Google::Apis::RequestOptions] options
1131
+ # Request-specific options
1132
+ #
1133
+ # @yield [result, err] Result & error if block supplied
1134
+ # @yieldparam result [Google::Apis::DatamigrationV1::TestIamPermissionsResponse] parsed result object
1135
+ # @yieldparam err [StandardError] error object if request failed
1136
+ #
1137
+ # @return [Google::Apis::DatamigrationV1::TestIamPermissionsResponse]
1138
+ #
1139
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1140
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1141
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1142
+ def test_conversion_workspace_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1143
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
1144
+ command.request_representation = Google::Apis::DatamigrationV1::TestIamPermissionsRequest::Representation
1145
+ command.request_object = test_iam_permissions_request_object
1146
+ command.response_representation = Google::Apis::DatamigrationV1::TestIamPermissionsResponse::Representation
1147
+ command.response_class = Google::Apis::DatamigrationV1::TestIamPermissionsResponse
1148
+ command.params['resource'] = resource unless resource.nil?
1149
+ command.query['fields'] = fields unless fields.nil?
1150
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1151
+ execute_or_queue_command(command, &block)
1152
+ end
1153
+
995
1154
  # Imports the mapping rules for a given conversion workspace. Supports various
996
1155
  # formats of external rules files.
997
1156
  # @param [String] parent
@@ -1030,15 +1189,15 @@ module Google
1030
1189
 
1031
1190
  # Creates a new migration job in a given project and location.
1032
1191
  # @param [String] parent
1033
- # Required. The parent, which owns this collection of migration jobs.
1192
+ # Required. The parent which owns this collection of migration jobs.
1034
1193
  # @param [Google::Apis::DatamigrationV1::MigrationJob] migration_job_object
1035
1194
  # @param [String] migration_job_id
1036
1195
  # Required. The ID of the instance to create.
1037
1196
  # @param [String] request_id
1038
- # A unique id used to identify the request. If the server receives two requests
1039
- # with the same id, then the second request will be ignored. It is recommended
1040
- # to always set this value to a UUID. The id must contain only letters (a-z, A-Z)
1041
- # , numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40
1197
+ # A unique ID used to identify the request. If the server receives two requests
1198
+ # with the same ID, then the second request is ignored. It is recommended to
1199
+ # always set this value to a UUID. The ID must contain only letters (a-z, A-Z),
1200
+ # numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40
1042
1201
  # characters.
1043
1202
  # @param [String] fields
1044
1203
  # Selector specifying which fields to include in a partial response.
@@ -1079,10 +1238,10 @@ module Google
1079
1238
  # migration job. In case of force delete, the destination CloudSQL replica
1080
1239
  # database is also deleted.
1081
1240
  # @param [String] request_id
1082
- # A unique id used to identify the request. If the server receives two requests
1083
- # with the same id, then the second request will be ignored. It is recommended
1084
- # to always set this value to a UUID. The id must contain only letters (a-z, A-Z)
1085
- # , numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40
1241
+ # A unique ID used to identify the request. If the server receives two requests
1242
+ # with the same ID, then the second request is ignored. It is recommended to
1243
+ # always set this value to a UUID. The ID must contain only letters (a-z, A-Z),
1244
+ # numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40
1086
1245
  # characters.
1087
1246
  # @param [String] fields
1088
1247
  # Selector specifying which fields to include in a partial response.
@@ -1223,7 +1382,7 @@ module Google
1223
1382
 
1224
1383
  # Lists migration jobs in a given project and location.
1225
1384
  # @param [String] parent
1226
- # Required. The parent, which owns this collection of migrationJobs.
1385
+ # Required. The parent which owns this collection of migrationJobs.
1227
1386
  # @param [String] filter
1228
1387
  # A filter expression that filters migration jobs listed in the response. The
1229
1388
  # expression must specify the field name, a comparison operator, and the value
@@ -1239,7 +1398,7 @@ module Google
1239
1398
  # @param [Fixnum] page_size
1240
1399
  # The maximum number of migration jobs to return. The service may return fewer
1241
1400
  # than this value. If unspecified, at most 50 migration jobs will be returned.
1242
- # The maximum value is 1000; values above 1000 will be coerced to 1000.
1401
+ # The maximum value is 1000; values above 1000 are coerced to 1000.
1243
1402
  # @param [String] page_token
1244
1403
  # The nextPageToken value received in the previous call to migrationJobs.list,
1245
1404
  # used in the subsequent request to retrieve the next page of results. On first
@@ -1282,14 +1441,14 @@ module Google
1282
1441
  # project`/locations/`location`/migrationJobs/`migrationJob`.
1283
1442
  # @param [Google::Apis::DatamigrationV1::MigrationJob] migration_job_object
1284
1443
  # @param [String] request_id
1285
- # A unique id used to identify the request. If the server receives two requests
1286
- # with the same id, then the second request will be ignored. It is recommended
1287
- # to always set this value to a UUID. The id must contain only letters (a-z, A-Z)
1288
- # , numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40
1444
+ # A unique ID used to identify the request. If the server receives two requests
1445
+ # with the same ID, then the second request is ignored. It is recommended to
1446
+ # always set this value to a UUID. The ID must contain only letters (a-z, A-Z),
1447
+ # numbers (0-9), underscores (_), and hyphens (-). The maximum length is 40
1289
1448
  # characters.
1290
1449
  # @param [String] update_mask
1291
- # Required. Field mask is used to specify the fields to be overwritten in the
1292
- # migration job resource by the update.
1450
+ # Required. Field mask is used to specify the fields to be overwritten by the
1451
+ # update in the conversion workspace resource.
1293
1452
  # @param [String] fields
1294
1453
  # Selector specifying which fields to include in a partial response.
1295
1454
  # @param [String] quota_user
@@ -1756,9 +1915,9 @@ module Google
1756
1915
  # @param [String] private_connection_id
1757
1916
  # Required. The private connection identifier.
1758
1917
  # @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
1918
+ # Optional. A unique ID used to identify the request. If the server receives two
1919
+ # requests with the same ID, then the second request is ignored. It is
1920
+ # recommended to always set this value to a UUID. The ID must contain only
1762
1921
  # letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-). The
1763
1922
  # maximum length is 40 characters.
1764
1923
  # @param [Boolean] skip_validation
@@ -1799,9 +1958,9 @@ module Google
1799
1958
  # @param [String] name
1800
1959
  # Required. The name of the private connection to delete.
1801
1960
  # @param [String] request_id
1802
- # Optional. A unique id used to identify the request. If the server receives two
1803
- # requests with the same id, then the second request will be ignored. It is
1804
- # recommended to always set this value to a UUID. The id must contain only
1961
+ # Optional. A unique ID used to identify the request. If the server receives two
1962
+ # requests with the same ID, then the second request is ignored. It is
1963
+ # recommended to always set this value to a UUID. The ID must contain only
1805
1964
  # letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-). The
1806
1965
  # maximum length is 40 characters.
1807
1966
  # @param [String] fields
@@ -1876,8 +2035,8 @@ module Google
1876
2035
  # Order by fields for the result.
1877
2036
  # @param [Fixnum] page_size
1878
2037
  # Maximum number of private connections to return. If unspecified, at most 50
1879
- # private connections that will be returned. The maximum value is 1000; values
1880
- # above 1000 will be coerced to 1000.
2038
+ # private connections that are returned. The maximum value is 1000; values above
2039
+ # 1000 are coerced to 1000.
1881
2040
  # @param [String] page_token
1882
2041
  # Page token received from a previous `ListPrivateConnections` call. Provide
1883
2042
  # this to retrieve the subsequent page. When paginating, all other parameters
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-datamigration_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.28.0
4
+ version: 0.30.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-01-29 00:00:00.000000000 Z
11
+ date: 2023-03-05 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: 0.9.1
19
+ version: 0.11.0
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: 0.9.1
29
+ version: 0.11.0
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-datamigration_v1/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-datamigration_v1/v0.28.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-datamigration_v1/v0.30.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-datamigration_v1
63
63
  post_install_message:
64
64
  rdoc_options: []