# 设置桶的网站配置
#### 功能介绍
OBS允许在桶内保存静态的网页资源，如.html网页文件、flash文件、音视频文件等，当客户端通过桶的Website接入点访问这些对象资源时，浏览器可以直接解析出这些支持的网页资源，呈现给最终用户。典型的应用场景有：
- 重定向所有的请求到另外一个站点。
- 设定特定的重定向规则来重定向特定的请求。
调用设置桶的网站配置接口，您可以为指定桶设置网站配置信息。
#### 接口约束
- 尽量避免目标桶名中带有"."，否则通过HTTPS访问时可能出现客户端校验证书出错。
- 设置桶的网站配置请求消息体的上限是10KB。
- 您必须是桶拥有者或拥有设置桶的网站配置的权限，才能设置桶的网站配置。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:bucket:PutBucketWebsite权限，如果使用桶策略则需授予PutBucketWebsite权限。相关授权方式介绍可参见[OBS权限控制概述](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0001.html)，配置方式详见[使用IAM自定义策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0121.html)、[自定义创建桶策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0123.html)。
 
#### 命令结构
- Windows操作系统
  ```
  obsutil website obs://bucket -method=put -localfile=xxx [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  ```
  
- macOS/Linux操作系统
  ```
  ./obsutil website obs://bucket -method=put -localfile=xxx [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  ```
  
 
#### 运行示例
- 以Windows操作系统为例，运行**obsutil website obs://test-bucket -method=put** **-localfile=d:\\temp\\website.xml** ，指定基于website.xml文件为桶bucket设置桶的网站配置。
  ```
  obsutil website obs://test-bucket -method=put -localfile=d:\temp\website.xml
  Start at 2024-09-30 07:59:28.8675681 +0000 UTC
  Put website configuration succeed for bucket [test-bucket], requestId is [000001996F7400854017D9959895ABE0]
  ```
  
 
#### 参数说明
| **参数**    | **约束**  | **描述**                                                                                            |
|:---|:---|:---|
| bucket    | 必选      | 桶名。                                                                                               |
| method    | 必选      | 指定方法，设置桶的网站配置时该值为put。                                                                             |
| localfile | 必选      | 待导入的本地网站配置文件路径。                                                                                   |
| config    | 附加参数，可选 | 运行当前命令时的自定义配置文件。可支持的配置参数请参考[配置参数说明](https://support.huaweicloud.com/utiltg-obs/obs_11_0035.html)。 |
| e         | 附加参数，可选 | 指定终端节点。                                                                                           |
| i         | 附加参数，可选 | 指定用户的AK。                                                                                          |
| k         | 附加参数，可选 | 指定用户的SK。                                                                                          |
| t         | 附加参数，可选 | 指定用户的securitytoken。                                                                               |
   
#### 相关链接
- 关于设置桶的网站配置的API说明，请参见[设置桶的网站配置](https://support.huaweicloud.com/api-obs/obs_04_0071.html)。
- 设置桶的Website配置过程中返回的错误码含义、问题原因及处理措施可参考[OBS错误码](https://support.huaweicloud.com/api-obs/obs_04_0115.html#section1)。
- 静态网站托管相关常见问题请参见[静态网站托管相关常见问题](https://support.huaweicloud.com/obs_faq/obs_faq_0500.html)。