Deleting the Static Website Hosting Configuration of a Bucket

Function

You can host static website resources such as HTML web pages, flash files, or audio and video files in an OBS bucket, so that you can provide these hosted resources using the bucket's website endpoint to end users. Typical use cases include:

• Redirecting all requests to another website
• Redirecting specific requests to another website

This API deletes the static website hosting configuration of the bucket.

Constraints

• To delete the static website hosting configuration of a bucket, you must be the bucket owner or have the required permission (obs:bucket:DeleteBucketWebsite in IAM or DeleteBucketWebsite in a bucket policy). For details, see Differences Between OBS Permissions Control Methods, Using IAM Roles or Policies to Grant Access to OBS, and Creating a Custom Bucket Policy.

Command Line Structure

• Windows

  obsutil website obs://bucket -method=delete [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

• macOS or Linux

  ./obsutil website obs://bucket -method=delete [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

Examples

• Take the Windows OS as an example. Run obsutil website obs://test-bucket -method=delete to delete the static website hosting configuration of bucket bucket.

  obsutil website obs://test-bucket -method=delete
  
  Start at 2024-09-30 07:59:28.8675681 +0000 UTC
  
  Delete website configuration succeed for bucket [test-bucket], requestId is [000001996F7D087A40149E6E68F39FC3]

Parameter Description

Helpful Links

• For details about the API for deleting the static website hosting configuration of a bucket, see Deleting the Static Website Hosting Configuration of a Bucket.
• For details about the meanings, causes, and handling methods of error codes that may be returned during the operation, see OBS Error Codes.
• For the FAQ about static website hosting, see Static Website Hosting FAQ.