google-cloud-cloud_controls_partner-v1beta 0.3.0 → 0.4.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: fd8e24fe3a0dbcf7ebce22ad210aaeec46950682df56a8e39f9de816abb42997
4
- data.tar.gz: a449189f8a529cdf5ab2939a8aa84d5a346831ebcf4234b3000c589e64b0ba60
3
+ metadata.gz: d81a5677d3306660124bf1c10835833a227072ef90f01e2e3aa8af63844e5abe
4
+ data.tar.gz: d65fee438acbf5d756b6c7be91e92477673c54cb15149b645d87c1cc0bf92950
5
5
  SHA512:
6
- metadata.gz: a1b78e6e23f3be7f610469ca974829acfcfbf2d963df68c4e611140832b905476361d37d87d59b326cb1e06daf49b6204c805322ada36179fb6ba3a874dad2d4
7
- data.tar.gz: 888df3e8d75c47167d714197ab8312c152b375c9e93946d6f648cc833c82712080c25c90e79a4ea53a53921d7cbb93655c55ce4e0392b5e3c9eba325bcf62096
6
+ metadata.gz: 26ecfe3d416a5bc324f082bca933d3d4164be1e28070cc7ca07249f73854e76e375cbe5b397a8eee054dec93dce20098f93d7bf8377cbd8e5a2d8652740c5aa4
7
+ data.tar.gz: fe8fe3f5cfef46d66091fd50d5bc295fba4080ad07ec8e4c558459cc364c48c987c0262130ada0602e3eb7d68f8569291e1580718dd7e61efdaea767fd8d0cad
data/README.md CHANGED
@@ -86,7 +86,7 @@ To browse ready to use code samples check [Google Cloud Samples](https://cloud.g
86
86
 
87
87
  ## Supported Ruby Versions
88
88
 
89
- This library is supported on Ruby 2.7+.
89
+ This library is supported on Ruby 3.0+.
90
90
 
91
91
  Google provides official support for Ruby versions that are actively supported
92
92
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
@@ -961,6 +961,273 @@ module Google
961
961
  raise ::Google::Cloud::Error.from_error(e)
962
962
  end
963
963
 
964
+ ##
965
+ # Creates a new customer.
966
+ #
967
+ # @overload create_customer(request, options = nil)
968
+ # Pass arguments to `create_customer` via a request object, either of type
969
+ # {::Google::Cloud::CloudControlsPartner::V1beta::CreateCustomerRequest} or an equivalent Hash.
970
+ #
971
+ # @param request [::Google::Cloud::CloudControlsPartner::V1beta::CreateCustomerRequest, ::Hash]
972
+ # A request object representing the call parameters. Required. To specify no
973
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
974
+ # @param options [::Gapic::CallOptions, ::Hash]
975
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
976
+ #
977
+ # @overload create_customer(parent: nil, customer: nil, customer_id: nil)
978
+ # Pass arguments to `create_customer` via keyword arguments. Note that at
979
+ # least one keyword argument is required. To specify no parameters, or to keep all
980
+ # the default parameter values, pass an empty Hash as a request object (see above).
981
+ #
982
+ # @param parent [::String]
983
+ # Required. Parent resource
984
+ # Format: `organizations/{organization}/locations/{location}`
985
+ # @param customer [::Google::Cloud::CloudControlsPartner::V1beta::Customer, ::Hash]
986
+ # Required. The customer to create.
987
+ # @param customer_id [::String]
988
+ # Required. The customer id to use for the customer, which will become the
989
+ # final component of the customer's resource name. The specified value must
990
+ # be a valid Google cloud organization id.
991
+ #
992
+ # @yield [response, operation] Access the result along with the RPC operation
993
+ # @yieldparam response [::Google::Cloud::CloudControlsPartner::V1beta::Customer]
994
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
995
+ #
996
+ # @return [::Google::Cloud::CloudControlsPartner::V1beta::Customer]
997
+ #
998
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
999
+ #
1000
+ # @example Basic example
1001
+ # require "google/cloud/cloud_controls_partner/v1beta"
1002
+ #
1003
+ # # Create a client object. The client can be reused for multiple calls.
1004
+ # client = Google::Cloud::CloudControlsPartner::V1beta::CloudControlsPartnerCore::Client.new
1005
+ #
1006
+ # # Create a request. To set request fields, pass in keyword arguments.
1007
+ # request = Google::Cloud::CloudControlsPartner::V1beta::CreateCustomerRequest.new
1008
+ #
1009
+ # # Call the create_customer method.
1010
+ # result = client.create_customer request
1011
+ #
1012
+ # # The returned object is of type Google::Cloud::CloudControlsPartner::V1beta::Customer.
1013
+ # p result
1014
+ #
1015
+ def create_customer request, options = nil
1016
+ raise ::ArgumentError, "request must be provided" if request.nil?
1017
+
1018
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::CloudControlsPartner::V1beta::CreateCustomerRequest
1019
+
1020
+ # Converts hash and nil to an options object
1021
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1022
+
1023
+ # Customize the options with defaults
1024
+ metadata = @config.rpcs.create_customer.metadata.to_h
1025
+
1026
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1027
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1028
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1029
+ gapic_version: ::Google::Cloud::CloudControlsPartner::V1beta::VERSION
1030
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1031
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1032
+
1033
+ header_params = {}
1034
+ if request.parent
1035
+ header_params["parent"] = request.parent
1036
+ end
1037
+
1038
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1039
+ metadata[:"x-goog-request-params"] ||= request_params_header
1040
+
1041
+ options.apply_defaults timeout: @config.rpcs.create_customer.timeout,
1042
+ metadata: metadata,
1043
+ retry_policy: @config.rpcs.create_customer.retry_policy
1044
+
1045
+ options.apply_defaults timeout: @config.timeout,
1046
+ metadata: @config.metadata,
1047
+ retry_policy: @config.retry_policy
1048
+
1049
+ @cloud_controls_partner_core_stub.call_rpc :create_customer, request, options: options do |response, operation|
1050
+ yield response, operation if block_given?
1051
+ end
1052
+ rescue ::GRPC::BadStatus => e
1053
+ raise ::Google::Cloud::Error.from_error(e)
1054
+ end
1055
+
1056
+ ##
1057
+ # Update details of a single customer
1058
+ #
1059
+ # @overload update_customer(request, options = nil)
1060
+ # Pass arguments to `update_customer` via a request object, either of type
1061
+ # {::Google::Cloud::CloudControlsPartner::V1beta::UpdateCustomerRequest} or an equivalent Hash.
1062
+ #
1063
+ # @param request [::Google::Cloud::CloudControlsPartner::V1beta::UpdateCustomerRequest, ::Hash]
1064
+ # A request object representing the call parameters. Required. To specify no
1065
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1066
+ # @param options [::Gapic::CallOptions, ::Hash]
1067
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1068
+ #
1069
+ # @overload update_customer(customer: nil, update_mask: nil)
1070
+ # Pass arguments to `update_customer` via keyword arguments. Note that at
1071
+ # least one keyword argument is required. To specify no parameters, or to keep all
1072
+ # the default parameter values, pass an empty Hash as a request object (see above).
1073
+ #
1074
+ # @param customer [::Google::Cloud::CloudControlsPartner::V1beta::Customer, ::Hash]
1075
+ # Required. The customer to update
1076
+ # Format:
1077
+ # `organizations/{organization}/locations/{location}/customers/{customer}`
1078
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1079
+ # Optional. The list of fields to update
1080
+ #
1081
+ # @yield [response, operation] Access the result along with the RPC operation
1082
+ # @yieldparam response [::Google::Cloud::CloudControlsPartner::V1beta::Customer]
1083
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1084
+ #
1085
+ # @return [::Google::Cloud::CloudControlsPartner::V1beta::Customer]
1086
+ #
1087
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1088
+ #
1089
+ # @example Basic example
1090
+ # require "google/cloud/cloud_controls_partner/v1beta"
1091
+ #
1092
+ # # Create a client object. The client can be reused for multiple calls.
1093
+ # client = Google::Cloud::CloudControlsPartner::V1beta::CloudControlsPartnerCore::Client.new
1094
+ #
1095
+ # # Create a request. To set request fields, pass in keyword arguments.
1096
+ # request = Google::Cloud::CloudControlsPartner::V1beta::UpdateCustomerRequest.new
1097
+ #
1098
+ # # Call the update_customer method.
1099
+ # result = client.update_customer request
1100
+ #
1101
+ # # The returned object is of type Google::Cloud::CloudControlsPartner::V1beta::Customer.
1102
+ # p result
1103
+ #
1104
+ def update_customer request, options = nil
1105
+ raise ::ArgumentError, "request must be provided" if request.nil?
1106
+
1107
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::CloudControlsPartner::V1beta::UpdateCustomerRequest
1108
+
1109
+ # Converts hash and nil to an options object
1110
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1111
+
1112
+ # Customize the options with defaults
1113
+ metadata = @config.rpcs.update_customer.metadata.to_h
1114
+
1115
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1116
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1117
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1118
+ gapic_version: ::Google::Cloud::CloudControlsPartner::V1beta::VERSION
1119
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1120
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1121
+
1122
+ header_params = {}
1123
+ if request.customer&.name
1124
+ header_params["customer.name"] = request.customer.name
1125
+ end
1126
+
1127
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1128
+ metadata[:"x-goog-request-params"] ||= request_params_header
1129
+
1130
+ options.apply_defaults timeout: @config.rpcs.update_customer.timeout,
1131
+ metadata: metadata,
1132
+ retry_policy: @config.rpcs.update_customer.retry_policy
1133
+
1134
+ options.apply_defaults timeout: @config.timeout,
1135
+ metadata: @config.metadata,
1136
+ retry_policy: @config.retry_policy
1137
+
1138
+ @cloud_controls_partner_core_stub.call_rpc :update_customer, request, options: options do |response, operation|
1139
+ yield response, operation if block_given?
1140
+ end
1141
+ rescue ::GRPC::BadStatus => e
1142
+ raise ::Google::Cloud::Error.from_error(e)
1143
+ end
1144
+
1145
+ ##
1146
+ # Delete details of a single customer
1147
+ #
1148
+ # @overload delete_customer(request, options = nil)
1149
+ # Pass arguments to `delete_customer` via a request object, either of type
1150
+ # {::Google::Cloud::CloudControlsPartner::V1beta::DeleteCustomerRequest} or an equivalent Hash.
1151
+ #
1152
+ # @param request [::Google::Cloud::CloudControlsPartner::V1beta::DeleteCustomerRequest, ::Hash]
1153
+ # A request object representing the call parameters. Required. To specify no
1154
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1155
+ # @param options [::Gapic::CallOptions, ::Hash]
1156
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1157
+ #
1158
+ # @overload delete_customer(name: nil)
1159
+ # Pass arguments to `delete_customer` via keyword arguments. Note that at
1160
+ # least one keyword argument is required. To specify no parameters, or to keep all
1161
+ # the default parameter values, pass an empty Hash as a request object (see above).
1162
+ #
1163
+ # @param name [::String]
1164
+ # Required. name of the resource to be deleted
1165
+ # format: name=organizations/*/locations/*/customers/*
1166
+ #
1167
+ # @yield [response, operation] Access the result along with the RPC operation
1168
+ # @yieldparam response [::Google::Protobuf::Empty]
1169
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1170
+ #
1171
+ # @return [::Google::Protobuf::Empty]
1172
+ #
1173
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1174
+ #
1175
+ # @example Basic example
1176
+ # require "google/cloud/cloud_controls_partner/v1beta"
1177
+ #
1178
+ # # Create a client object. The client can be reused for multiple calls.
1179
+ # client = Google::Cloud::CloudControlsPartner::V1beta::CloudControlsPartnerCore::Client.new
1180
+ #
1181
+ # # Create a request. To set request fields, pass in keyword arguments.
1182
+ # request = Google::Cloud::CloudControlsPartner::V1beta::DeleteCustomerRequest.new
1183
+ #
1184
+ # # Call the delete_customer method.
1185
+ # result = client.delete_customer request
1186
+ #
1187
+ # # The returned object is of type Google::Protobuf::Empty.
1188
+ # p result
1189
+ #
1190
+ def delete_customer request, options = nil
1191
+ raise ::ArgumentError, "request must be provided" if request.nil?
1192
+
1193
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::CloudControlsPartner::V1beta::DeleteCustomerRequest
1194
+
1195
+ # Converts hash and nil to an options object
1196
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1197
+
1198
+ # Customize the options with defaults
1199
+ metadata = @config.rpcs.delete_customer.metadata.to_h
1200
+
1201
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1202
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1203
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1204
+ gapic_version: ::Google::Cloud::CloudControlsPartner::V1beta::VERSION
1205
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1206
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1207
+
1208
+ header_params = {}
1209
+ if request.name
1210
+ header_params["name"] = request.name
1211
+ end
1212
+
1213
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1214
+ metadata[:"x-goog-request-params"] ||= request_params_header
1215
+
1216
+ options.apply_defaults timeout: @config.rpcs.delete_customer.timeout,
1217
+ metadata: metadata,
1218
+ retry_policy: @config.rpcs.delete_customer.retry_policy
1219
+
1220
+ options.apply_defaults timeout: @config.timeout,
1221
+ metadata: @config.metadata,
1222
+ retry_policy: @config.retry_policy
1223
+
1224
+ @cloud_controls_partner_core_stub.call_rpc :delete_customer, request, options: options do |response, operation|
1225
+ yield response, operation if block_given?
1226
+ end
1227
+ rescue ::GRPC::BadStatus => e
1228
+ raise ::Google::Cloud::Error.from_error(e)
1229
+ end
1230
+
964
1231
  ##
965
1232
  # Configuration class for the CloudControlsPartnerCore API.
966
1233
  #
@@ -1005,6 +1272,13 @@ module Google
1005
1272
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1006
1273
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1007
1274
  # * (`nil`) indicating no credentials
1275
+ #
1276
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
1277
+ # external source for authentication to Google Cloud, you must validate it before
1278
+ # providing it to a Google API client library. Providing an unvalidated credential
1279
+ # configuration to Google APIs can compromise the security of your systems and data.
1280
+ # For more information, refer to [Validate credential configurations from external
1281
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
1008
1282
  # @return [::Object]
1009
1283
  # @!attribute [rw] scope
1010
1284
  # The OAuth scopes
@@ -1160,6 +1434,21 @@ module Google
1160
1434
  # @return [::Gapic::Config::Method]
1161
1435
  #
1162
1436
  attr_reader :get_partner
1437
+ ##
1438
+ # RPC-specific configuration for `create_customer`
1439
+ # @return [::Gapic::Config::Method]
1440
+ #
1441
+ attr_reader :create_customer
1442
+ ##
1443
+ # RPC-specific configuration for `update_customer`
1444
+ # @return [::Gapic::Config::Method]
1445
+ #
1446
+ attr_reader :update_customer
1447
+ ##
1448
+ # RPC-specific configuration for `delete_customer`
1449
+ # @return [::Gapic::Config::Method]
1450
+ #
1451
+ attr_reader :delete_customer
1163
1452
 
1164
1453
  # @private
1165
1454
  def initialize parent_rpcs = nil
@@ -1179,6 +1468,12 @@ module Google
1179
1468
  @list_access_approval_requests = ::Gapic::Config::Method.new list_access_approval_requests_config
1180
1469
  get_partner_config = parent_rpcs.get_partner if parent_rpcs.respond_to? :get_partner
1181
1470
  @get_partner = ::Gapic::Config::Method.new get_partner_config
1471
+ create_customer_config = parent_rpcs.create_customer if parent_rpcs.respond_to? :create_customer
1472
+ @create_customer = ::Gapic::Config::Method.new create_customer_config
1473
+ update_customer_config = parent_rpcs.update_customer if parent_rpcs.respond_to? :update_customer
1474
+ @update_customer = ::Gapic::Config::Method.new update_customer_config
1475
+ delete_customer_config = parent_rpcs.delete_customer if parent_rpcs.respond_to? :delete_customer
1476
+ @delete_customer = ::Gapic::Config::Method.new delete_customer_config
1182
1477
 
1183
1478
  yield self if block_given?
1184
1479
  end
@@ -890,6 +890,252 @@ module Google
890
890
  raise ::Google::Cloud::Error.from_error(e)
891
891
  end
892
892
 
893
+ ##
894
+ # Creates a new customer.
895
+ #
896
+ # @overload create_customer(request, options = nil)
897
+ # Pass arguments to `create_customer` via a request object, either of type
898
+ # {::Google::Cloud::CloudControlsPartner::V1beta::CreateCustomerRequest} or an equivalent Hash.
899
+ #
900
+ # @param request [::Google::Cloud::CloudControlsPartner::V1beta::CreateCustomerRequest, ::Hash]
901
+ # A request object representing the call parameters. Required. To specify no
902
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
903
+ # @param options [::Gapic::CallOptions, ::Hash]
904
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
905
+ #
906
+ # @overload create_customer(parent: nil, customer: nil, customer_id: nil)
907
+ # Pass arguments to `create_customer` via keyword arguments. Note that at
908
+ # least one keyword argument is required. To specify no parameters, or to keep all
909
+ # the default parameter values, pass an empty Hash as a request object (see above).
910
+ #
911
+ # @param parent [::String]
912
+ # Required. Parent resource
913
+ # Format: `organizations/{organization}/locations/{location}`
914
+ # @param customer [::Google::Cloud::CloudControlsPartner::V1beta::Customer, ::Hash]
915
+ # Required. The customer to create.
916
+ # @param customer_id [::String]
917
+ # Required. The customer id to use for the customer, which will become the
918
+ # final component of the customer's resource name. The specified value must
919
+ # be a valid Google cloud organization id.
920
+ # @yield [result, operation] Access the result along with the TransportOperation object
921
+ # @yieldparam result [::Google::Cloud::CloudControlsPartner::V1beta::Customer]
922
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
923
+ #
924
+ # @return [::Google::Cloud::CloudControlsPartner::V1beta::Customer]
925
+ #
926
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
927
+ #
928
+ # @example Basic example
929
+ # require "google/cloud/cloud_controls_partner/v1beta"
930
+ #
931
+ # # Create a client object. The client can be reused for multiple calls.
932
+ # client = Google::Cloud::CloudControlsPartner::V1beta::CloudControlsPartnerCore::Rest::Client.new
933
+ #
934
+ # # Create a request. To set request fields, pass in keyword arguments.
935
+ # request = Google::Cloud::CloudControlsPartner::V1beta::CreateCustomerRequest.new
936
+ #
937
+ # # Call the create_customer method.
938
+ # result = client.create_customer request
939
+ #
940
+ # # The returned object is of type Google::Cloud::CloudControlsPartner::V1beta::Customer.
941
+ # p result
942
+ #
943
+ def create_customer request, options = nil
944
+ raise ::ArgumentError, "request must be provided" if request.nil?
945
+
946
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::CloudControlsPartner::V1beta::CreateCustomerRequest
947
+
948
+ # Converts hash and nil to an options object
949
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
950
+
951
+ # Customize the options with defaults
952
+ call_metadata = @config.rpcs.create_customer.metadata.to_h
953
+
954
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
955
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
956
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
957
+ gapic_version: ::Google::Cloud::CloudControlsPartner::V1beta::VERSION,
958
+ transports_version_send: [:rest]
959
+
960
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
961
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
962
+
963
+ options.apply_defaults timeout: @config.rpcs.create_customer.timeout,
964
+ metadata: call_metadata,
965
+ retry_policy: @config.rpcs.create_customer.retry_policy
966
+
967
+ options.apply_defaults timeout: @config.timeout,
968
+ metadata: @config.metadata,
969
+ retry_policy: @config.retry_policy
970
+
971
+ @cloud_controls_partner_core_stub.create_customer request, options do |result, operation|
972
+ yield result, operation if block_given?
973
+ end
974
+ rescue ::Gapic::Rest::Error => e
975
+ raise ::Google::Cloud::Error.from_error(e)
976
+ end
977
+
978
+ ##
979
+ # Update details of a single customer
980
+ #
981
+ # @overload update_customer(request, options = nil)
982
+ # Pass arguments to `update_customer` via a request object, either of type
983
+ # {::Google::Cloud::CloudControlsPartner::V1beta::UpdateCustomerRequest} or an equivalent Hash.
984
+ #
985
+ # @param request [::Google::Cloud::CloudControlsPartner::V1beta::UpdateCustomerRequest, ::Hash]
986
+ # A request object representing the call parameters. Required. To specify no
987
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
988
+ # @param options [::Gapic::CallOptions, ::Hash]
989
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
990
+ #
991
+ # @overload update_customer(customer: nil, update_mask: nil)
992
+ # Pass arguments to `update_customer` via keyword arguments. Note that at
993
+ # least one keyword argument is required. To specify no parameters, or to keep all
994
+ # the default parameter values, pass an empty Hash as a request object (see above).
995
+ #
996
+ # @param customer [::Google::Cloud::CloudControlsPartner::V1beta::Customer, ::Hash]
997
+ # Required. The customer to update
998
+ # Format:
999
+ # `organizations/{organization}/locations/{location}/customers/{customer}`
1000
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1001
+ # Optional. The list of fields to update
1002
+ # @yield [result, operation] Access the result along with the TransportOperation object
1003
+ # @yieldparam result [::Google::Cloud::CloudControlsPartner::V1beta::Customer]
1004
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1005
+ #
1006
+ # @return [::Google::Cloud::CloudControlsPartner::V1beta::Customer]
1007
+ #
1008
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1009
+ #
1010
+ # @example Basic example
1011
+ # require "google/cloud/cloud_controls_partner/v1beta"
1012
+ #
1013
+ # # Create a client object. The client can be reused for multiple calls.
1014
+ # client = Google::Cloud::CloudControlsPartner::V1beta::CloudControlsPartnerCore::Rest::Client.new
1015
+ #
1016
+ # # Create a request. To set request fields, pass in keyword arguments.
1017
+ # request = Google::Cloud::CloudControlsPartner::V1beta::UpdateCustomerRequest.new
1018
+ #
1019
+ # # Call the update_customer method.
1020
+ # result = client.update_customer request
1021
+ #
1022
+ # # The returned object is of type Google::Cloud::CloudControlsPartner::V1beta::Customer.
1023
+ # p result
1024
+ #
1025
+ def update_customer request, options = nil
1026
+ raise ::ArgumentError, "request must be provided" if request.nil?
1027
+
1028
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::CloudControlsPartner::V1beta::UpdateCustomerRequest
1029
+
1030
+ # Converts hash and nil to an options object
1031
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1032
+
1033
+ # Customize the options with defaults
1034
+ call_metadata = @config.rpcs.update_customer.metadata.to_h
1035
+
1036
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1037
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1038
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1039
+ gapic_version: ::Google::Cloud::CloudControlsPartner::V1beta::VERSION,
1040
+ transports_version_send: [:rest]
1041
+
1042
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1043
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1044
+
1045
+ options.apply_defaults timeout: @config.rpcs.update_customer.timeout,
1046
+ metadata: call_metadata,
1047
+ retry_policy: @config.rpcs.update_customer.retry_policy
1048
+
1049
+ options.apply_defaults timeout: @config.timeout,
1050
+ metadata: @config.metadata,
1051
+ retry_policy: @config.retry_policy
1052
+
1053
+ @cloud_controls_partner_core_stub.update_customer request, options do |result, operation|
1054
+ yield result, operation if block_given?
1055
+ end
1056
+ rescue ::Gapic::Rest::Error => e
1057
+ raise ::Google::Cloud::Error.from_error(e)
1058
+ end
1059
+
1060
+ ##
1061
+ # Delete details of a single customer
1062
+ #
1063
+ # @overload delete_customer(request, options = nil)
1064
+ # Pass arguments to `delete_customer` via a request object, either of type
1065
+ # {::Google::Cloud::CloudControlsPartner::V1beta::DeleteCustomerRequest} or an equivalent Hash.
1066
+ #
1067
+ # @param request [::Google::Cloud::CloudControlsPartner::V1beta::DeleteCustomerRequest, ::Hash]
1068
+ # A request object representing the call parameters. Required. To specify no
1069
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1070
+ # @param options [::Gapic::CallOptions, ::Hash]
1071
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1072
+ #
1073
+ # @overload delete_customer(name: nil)
1074
+ # Pass arguments to `delete_customer` via keyword arguments. Note that at
1075
+ # least one keyword argument is required. To specify no parameters, or to keep all
1076
+ # the default parameter values, pass an empty Hash as a request object (see above).
1077
+ #
1078
+ # @param name [::String]
1079
+ # Required. name of the resource to be deleted
1080
+ # format: name=organizations/*/locations/*/customers/*
1081
+ # @yield [result, operation] Access the result along with the TransportOperation object
1082
+ # @yieldparam result [::Google::Protobuf::Empty]
1083
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1084
+ #
1085
+ # @return [::Google::Protobuf::Empty]
1086
+ #
1087
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1088
+ #
1089
+ # @example Basic example
1090
+ # require "google/cloud/cloud_controls_partner/v1beta"
1091
+ #
1092
+ # # Create a client object. The client can be reused for multiple calls.
1093
+ # client = Google::Cloud::CloudControlsPartner::V1beta::CloudControlsPartnerCore::Rest::Client.new
1094
+ #
1095
+ # # Create a request. To set request fields, pass in keyword arguments.
1096
+ # request = Google::Cloud::CloudControlsPartner::V1beta::DeleteCustomerRequest.new
1097
+ #
1098
+ # # Call the delete_customer method.
1099
+ # result = client.delete_customer request
1100
+ #
1101
+ # # The returned object is of type Google::Protobuf::Empty.
1102
+ # p result
1103
+ #
1104
+ def delete_customer request, options = nil
1105
+ raise ::ArgumentError, "request must be provided" if request.nil?
1106
+
1107
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::CloudControlsPartner::V1beta::DeleteCustomerRequest
1108
+
1109
+ # Converts hash and nil to an options object
1110
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1111
+
1112
+ # Customize the options with defaults
1113
+ call_metadata = @config.rpcs.delete_customer.metadata.to_h
1114
+
1115
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1116
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1117
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1118
+ gapic_version: ::Google::Cloud::CloudControlsPartner::V1beta::VERSION,
1119
+ transports_version_send: [:rest]
1120
+
1121
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1122
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1123
+
1124
+ options.apply_defaults timeout: @config.rpcs.delete_customer.timeout,
1125
+ metadata: call_metadata,
1126
+ retry_policy: @config.rpcs.delete_customer.retry_policy
1127
+
1128
+ options.apply_defaults timeout: @config.timeout,
1129
+ metadata: @config.metadata,
1130
+ retry_policy: @config.retry_policy
1131
+
1132
+ @cloud_controls_partner_core_stub.delete_customer request, options do |result, operation|
1133
+ yield result, operation if block_given?
1134
+ end
1135
+ rescue ::Gapic::Rest::Error => e
1136
+ raise ::Google::Cloud::Error.from_error(e)
1137
+ end
1138
+
893
1139
  ##
894
1140
  # Configuration class for the CloudControlsPartnerCore REST API.
895
1141
  #
@@ -932,6 +1178,13 @@ module Google
932
1178
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
933
1179
  # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
934
1180
  # * (`nil`) indicating no credentials
1181
+ #
1182
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
1183
+ # external source for authentication to Google Cloud, you must validate it before
1184
+ # providing it to a Google API client library. Providing an unvalidated credential
1185
+ # configuration to Google APIs can compromise the security of your systems and data.
1186
+ # For more information, refer to [Validate credential configurations from external
1187
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
935
1188
  # @return [::Object]
936
1189
  # @!attribute [rw] scope
937
1190
  # The OAuth scopes
@@ -1069,6 +1322,21 @@ module Google
1069
1322
  # @return [::Gapic::Config::Method]
1070
1323
  #
1071
1324
  attr_reader :get_partner
1325
+ ##
1326
+ # RPC-specific configuration for `create_customer`
1327
+ # @return [::Gapic::Config::Method]
1328
+ #
1329
+ attr_reader :create_customer
1330
+ ##
1331
+ # RPC-specific configuration for `update_customer`
1332
+ # @return [::Gapic::Config::Method]
1333
+ #
1334
+ attr_reader :update_customer
1335
+ ##
1336
+ # RPC-specific configuration for `delete_customer`
1337
+ # @return [::Gapic::Config::Method]
1338
+ #
1339
+ attr_reader :delete_customer
1072
1340
 
1073
1341
  # @private
1074
1342
  def initialize parent_rpcs = nil
@@ -1088,6 +1356,12 @@ module Google
1088
1356
  @list_access_approval_requests = ::Gapic::Config::Method.new list_access_approval_requests_config
1089
1357
  get_partner_config = parent_rpcs.get_partner if parent_rpcs.respond_to? :get_partner
1090
1358
  @get_partner = ::Gapic::Config::Method.new get_partner_config
1359
+ create_customer_config = parent_rpcs.create_customer if parent_rpcs.respond_to? :create_customer
1360
+ @create_customer = ::Gapic::Config::Method.new create_customer_config
1361
+ update_customer_config = parent_rpcs.update_customer if parent_rpcs.respond_to? :update_customer
1362
+ @update_customer = ::Gapic::Config::Method.new update_customer_config
1363
+ delete_customer_config = parent_rpcs.delete_customer if parent_rpcs.respond_to? :delete_customer
1364
+ @delete_customer = ::Gapic::Config::Method.new delete_customer_config
1091
1365
 
1092
1366
  yield self if block_given?
1093
1367
  end