replace method

Future<GoogleCloudDatacatalogV1Taxonomy> replace(
  1. GoogleCloudDatacatalogV1ReplaceTaxonomyRequest request,
  2. String name, {
  3. String? $fields,
})

Replaces (updates) a taxonomy and all its policy tags.

The taxonomy and its entire hierarchy of policy tags must be represented literally by SerializedTaxonomy and the nested SerializedPolicyTag messages. This operation automatically does the following: - Deletes the existing policy tags that are missing from the SerializedPolicyTag. - Creates policy tags that don't have resource names. They are considered new. - Updates policy tags with valid resources names accordingly.

request - The metadata request object.

Request parameters:

name - Required. Resource name of the taxonomy to update. Value must have pattern ^projects/\[^/\]+/locations/\[^/\]+/taxonomies/\[^/\]+$.

$fields - Selector specifying which fields to include in a partial response.

Completes with a GoogleCloudDatacatalogV1Taxonomy.

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<GoogleCloudDatacatalogV1Taxonomy> replace(
  GoogleCloudDatacatalogV1ReplaceTaxonomyRequest request,
  core.String name, {
  core.String? $fields,
}) async {
  final body_ = convert.json.encode(request);
  final queryParams_ = <core.String, core.List<core.String>>{
    if ($fields != null) 'fields': [$fields],
  };

  final url_ = 'v1/' + core.Uri.encodeFull('$name') + ':replace';

  final response_ = await _requester.request(
    url_,
    'POST',
    body: body_,
    queryParams: queryParams_,
  );
  return GoogleCloudDatacatalogV1Taxonomy.fromJson(
      response_ as core.Map<core.String, core.dynamic>);
}