设置桶的网站配置

功能介绍

OBS允许在桶内保存静态的网页资源，如.html网页文件、flash文件、音视频文件等，当客户端通过桶的Website接入点访问这些对象资源时，浏览器可以直接解析出这些支持的网页资源，呈现给最终用户。典型的应用场景有：

• 重定向所有的请求到另外一个站点。
• 设定特定的重定向规则来重定向特定的请求。

调用设置桶的网站配置接口，您可以为指定桶设置网站配置信息。

接口约束

• 尽量避免目标桶名中带有“.”，否则通过HTTPS访问时可能出现客户端校验证书出错。
• 设置桶的网站配置请求消息体的上限是10KB。
• 您必须是桶拥有者或拥有设置桶的网站配置的权限，才能设置桶的网站配置。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:bucket:PutBucketWebsite权限，如果使用桶策略则需授予PutBucketWebsite权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、自定义创建桶策略。

命令结构

• 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]

参数说明

相关链接

• 关于设置桶的网站配置的API说明，请参见设置桶的网站配置。
• 设置桶的Website配置过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码。
• 静态网站托管相关常见问题请参见静态网站托管相关常见问题。