delete method
Deletes an object and its metadata.
Deletions are permanent if versioning is not enabled for the bucket, or if the generation parameter is used.
Request parameters:
bucket
- Name of the bucket in which the object resides.
object
- Name of the object. For information about how to URL encode
object names to be path safe, see
Encoding URI Path Parts.
generation
- If present, permanently deletes a specific revision of this
object (as opposed to the latest version, the default).
ifGenerationMatch
- Makes the operation conditional on whether the
object's current generation matches the given value. Setting to 0 makes
the operation succeed only if there are no live versions of the object.
ifGenerationNotMatch
- Makes the operation conditional on whether the
object's current generation does not match the given value. If no live
object exists, the precondition fails. Setting to 0 makes the operation
succeed only if there is a live version of the object.
ifMetagenerationMatch
- Makes the operation conditional on whether the
object's current metageneration matches the given value.
ifMetagenerationNotMatch
- Makes the operation conditional on whether
the object's current metageneration does not match the given value.
userProject
- The project to be billed for this request. Required for
Requester Pays buckets.
$fields
- Selector specifying which fields to include in a partial
response.
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<void> delete(
core.String bucket,
core.String object, {
core.String? generation,
core.String? ifGenerationMatch,
core.String? ifGenerationNotMatch,
core.String? ifMetagenerationMatch,
core.String? ifMetagenerationNotMatch,
core.String? userProject,
core.String? $fields,
}) async {
final queryParams_ = <core.String, core.List<core.String>>{
if (generation != null) 'generation': [generation],
if (ifGenerationMatch != null) 'ifGenerationMatch': [ifGenerationMatch],
if (ifGenerationNotMatch != null)
'ifGenerationNotMatch': [ifGenerationNotMatch],
if (ifMetagenerationMatch != null)
'ifMetagenerationMatch': [ifMetagenerationMatch],
if (ifMetagenerationNotMatch != null)
'ifMetagenerationNotMatch': [ifMetagenerationNotMatch],
if (userProject != null) 'userProject': [userProject],
if ($fields != null) 'fields': [$fields],
};
final url_ = 'b/' +
commons.escapeVariable('$bucket') +
'/o/' +
commons.escapeVariable('$object');
await _requester.request(
url_,
'DELETE',
queryParams: queryParams_,
downloadOptions: null,
);
}