Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)



Buckets: delete

Requires authorization

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/v1beta1/b/bucket

Parameters

Parameter name Value Description
Required parameters
bucket string Name of a bucket.

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.write_only
https://www.googleapis.com/auth/devstorage.read_write
https://www.googleapis.com/auth/devstorage.full_control

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).

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}"

Try it!

Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer .

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.