delete method

Future<Empty> delete(
  1. String name, {
  2. String? etag,
  3. bool? validateOnly,
  4. String? $fields,
})

Deletes the instance config.

Deletion is only allowed when no instances are using the configuration. If any instances are using the config, returns FAILED_PRECONDITION. Only user managed configurations can be deleted. Authorization requires spanner.instanceConfigs.delete permission on the resource name.

Request parameters:

name - Required. The name of the instance configuration to be deleted. Values are of the form projects//instanceConfigs/ Value must have pattern ^projects/\[^/\]+/instanceConfigs/\[^/\]+$.

etag - Used for optimistic concurrency control as a way to help prevent simultaneous deletes of an instance config from overwriting each other. If not empty, the API only deletes the instance config when the etag provided matches the current status of the requested instance config. Otherwise, deletes the instance config without checking the current status of the requested instance config.

validateOnly - An option to validate, but not actually execute, a request, and provide the same response.

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

Completes with a Empty.

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<Empty> delete(
  core.String name, {
  core.String? etag,
  core.bool? validateOnly,
  core.String? $fields,
}) async {
  final queryParams_ = <core.String, core.List<core.String>>{
    if (etag != null) 'etag': [etag],
    if (validateOnly != null) 'validateOnly': ['${validateOnly}'],
    if ($fields != null) 'fields': [$fields],
  };

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

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