patch method
- GcpUserAccessBinding request,
- String name, {
- bool? append,
- String? updateMask,
- String? $fields,
Updates a GcpUserAccessBinding.
Completion of this long-running operation does not necessarily signify that the changed binding is deployed onto all affected users, which may take more time.
request - The metadata request object.
Request parameters:
name - Immutable. Assigned by the server during creation. The last
segment has an arbitrary length and has only URI unreserved characters (as
defined by
RFC 3986 Section 2.3).
Should not be specified by the client during creation. Example:
"organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N"
Value must have pattern
^organizations/\[^/\]+/gcpUserAccessBindings/\[^/\]+$.
append - Optional. This field controls whether or not certain repeated
settings in the update request overwrite or append to existing settings on
the binding. If true, then append. Otherwise overwrite. So far, only
scoped_access_settings with session_settings supports appending.
Global access_levels, access_levels in scoped_access_settings,
dry_run_access_levels, and session_settings are not compatible with
append functionality, and the request will return an error if
append=true when these settings are in the update_mask. The request
will also return an error if append=true when "scoped_access_settings"
is not set in the update_mask.
updateMask - Required. Only the fields specified in this mask are
updated. Because name and group_key cannot be changed, update_mask
is required and may only contain the following fields: access_levels,
dry_run_access_levels, session_settings, scoped_access_settings.
update_mask { paths: "access_levels" }
$fields - Selector specifying which fields to include in a partial
response.
Completes with a Operation.
Completes with a commons.ApiRequestError if the API endpoint returned an error.
If the used http.Client completes with an error when making a REST call,
this method will complete with the same error.
Implementation
async.Future<Operation> patch(
GcpUserAccessBinding request,
core.String name, {
core.bool? append,
core.String? updateMask,
core.String? $fields,
}) async {
final body_ = convert.json.encode(request);
final queryParams_ = <core.String, core.List<core.String>>{
'append': ?append == null ? null : ['${append}'],
'updateMask': ?updateMask == null ? null : [updateMask],
'fields': ?$fields == null ? null : [$fields],
};
final url_ = 'v1/' + core.Uri.encodeFull('$name');
final response_ = await _requester.request(
url_,
'PATCH',
body: body_,
queryParams: queryParams_,
);
return Operation.fromJson(response_ as core.Map<core.String, core.dynamic>);
}