patch method
- ConnectivityTest request,
- String name, {
- String? updateMask,
- String? $fields,
Updates the configuration of an existing ConnectivityTest
.
After you update a test, the reachability analysis is performed as part of
the long running operation, which completes when the analysis completes.
The Reachability state in the test resource is updated with the new
result. If the endpoint specifications in ConnectivityTest
are invalid
(for example, they contain non-existent resources in the network, or the
user does not have read permissions to the network configurations of
listed projects), then the reachability result returns a value of UNKNOWN.
If the endpoint specifications in ConnectivityTest
are incomplete, the
reachability result returns a value of AMBIGUOUS
. See the documentation
in ConnectivityTest
for more details.
request
- The metadata request object.
Request parameters:
name
- Identifier. Unique name of the resource using the form:
projects/{project_id}/locations/global/connectivityTests/{test_id}
Value must have pattern
^projects/\[^/\]+/locations/global/connectivityTests/\[^/\]+$
.
updateMask
- Required. Mask of fields to update. At least one path must
be supplied in this field.
$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(
ConnectivityTest request,
core.String name, {
core.String? updateMask,
core.String? $fields,
}) async {
final body_ = convert.json.encode(request);
final queryParams_ = <core.String, core.List<core.String>>{
if (updateMask != null) 'updateMask': [updateMask],
if ($fields != null) 'fields': [$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>);
}