静态网站托管

更新时间：2026-09-21

静态网站托管相关方法

通过 Python SDK 可以为 BOS Bucket 设置静态网站托管，指定首页文件和 404 页面文件。Bucket 需已存在，示例中的 bucket_name 请替换为实际 Bucket 名称。

参数	必填	说明
`bucket_name`	是	已创建的 BOS Bucket 名称。
`index`	否	静态网站首页文件名称，例如 `index.html`。
`not_found`	否	访问不存在资源时返回的 404 页面文件名称，例如 `404.html`。

代码示例

                Python
                
            

                from baidubce.auth.bce_credentials import BceCredentials
from baidubce.bce_client_configuration import BceClientConfiguration
from baidubce.services.bos.bos_client import BosClient

access_key_id = "your-access-key-id"
secret_access_key = "your-secret-access-key"
endpoint = "bj.bcebos.com"
bucket_name = "example-bucket"

config = BceClientConfiguration(
    credentials=BceCredentials(access_key_id, secret_access_key),
    endpoint=endpoint,
)
bos_client = BosClient(config)

## 设置静态网站托管
put_response = bos_client.put_bucket_static_website(
    bucket_name,
    index="index.html",
    not_found="404.html",
)

## 查看静态网站托管
get_response = bos_client.get_bucket_static_website(bucket_name)
print(get_response.index)
print(get_response.not_found)

## 删除静态网站托管
delete_response = bos_client.delete_bucket_static_website(bucket_name)
            

代码说明：

方法	返回值说明
`put_bucket_static_website`	设置成功时返回 `BceResponse`，响应体为空，可通过 `put_response.metadata` 查看响应元数据。
`get_bucket_static_website`	查询成功时返回 `BceResponse`，包含 `index`、`not_found`、`not_found_http_status` 和 `raw_data` 等字段。Python SDK 会将响应体中的 `notFound` 转换为 `not_found`。
`delete_bucket_static_website`	删除成功时返回 `BceResponse`，响应体为空，可通过 `delete_response.metadata` 查看响应元数据。

示例输出：

Text

1index.html
2404.html

参数说明

参数	是否必须	说明
`access_key_id`	是	用于初始化 SDK 客户端的访问密钥 ID，请使用占位符替换为实际值。
`secret_access_key`	是	用于初始化 SDK 客户端的访问密钥，请使用占位符替换为实际值。
`endpoint`	是	BOS 服务端点，例如 `bj.bcebos.com`。
`bucket_name`	是	已创建的 BOS Bucket 名称。
`index`	否	静态网站首页文件名称，例如 `index.html`。
`not_found`	否	访问不存在资源时返回的 404 页面文件名称，例如 `404.html`。

评价此篇文章

有帮助没帮助

数据加密

合规保留

百度智能云

BOS 对象存储

BOS 对象存储

静态网站托管

静态网站托管相关方法

代码示例