delete method
Deletes the specified account regardless of its type: standalone, advanced account or sub-account.
Deleting an advanced account leads to the deletion of all of its
sub-accounts. Executing this method requires admin access. The deletion
succeeds only if the account does not provide services to any other
account and has no processed offers. You can use the force
parameter to
override this.
Request parameters:
name
- Required. The name of the account to delete. Format:
accounts/{account}
Value must have pattern ^accounts/\[^/\]+$
.
force
- Optional. If set to true
, the account is deleted even if it
provides services to other accounts or has processed offers.
$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.bool? force,
core.String? $fields,
}) async {
final queryParams_ = <core.String, core.List<core.String>>{
if (force != null) 'force': ['${force}'],
if ($fields != null) 'fields': [$fields],
};
final url_ = 'accounts/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>);
}