Requires authorization
Permanently deletes an empty bucket. Try it now or see an example .
The authenticated user must be a member of the project's team as an editor or owner .
Request
HTTP request
DELETE https://www.googleapis.com/storage/v1beta2/b/bucket
Parameters
| Parameter name | Value | Description |
|---|---|---|
| Path parameters | ||
bucket
|
string
|
Name of a bucket. |
| Optional query parameters | ||
ifMetagenerationMatch
|
unsigned long
|
Makes the return of the bucket metadata conditional on whether the bucket's current metageneration matches the given value. |
ifMetagenerationNotMatch
|
unsigned long
|
Makes the return of the bucket metadata conditional on whether the bucket's current metageneration does not match the given value. |
Authorization
This request requires authorization with at least one of the following scopes ( read more about authentication and authorization ).
| Scope |
|---|
https://www.googleapis.com/auth/devstorage.full_control
|
https://www.googleapis.com/auth/devstorage.read_write
|
Request body
Do not supply a request body with this method.
Response
If successful, this method returns an empty response body.
Examples
Note: The code examples available for this method do not represent all supported programming languages (see the client libraries page for a list of supported languages).
Java
Uses the Java client library .
storage.buckets().delete("mybucket").execute();
Python
Uses the Python client library .
client.buckets().delete(bucket=bucket_name).execute()
Ruby
Uses the Ruby client library .
# Delete a bucket in the project
bucket_delete_result = client.execute(
api_method: storage.buckets.delete,
parameters: {bucket: BUCKET}
)
puts "Deleting #{BUCKET}: #{bucket_delete_result.body}"
Go
Uses the Go client library .
// Delete a bucket in the project
bucketName := "BUCKET_NAME"
if err = service.Buckets.Delete(bucketName).Do(); err == nil {
fmt.Printf("Successfully deleted bucket: %s.\n", bucketName)
} else {
fmt.Printf("Buckets.Delete errors: %v", err)
}
Try it!
Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer .