API | 操作名 | 操作描述 |
设置静态网站 | 设置存储桶的静态网站配置 | |
查询静态网站配置 | 查询存储桶的静态网站配置 | |
删除静态网站配置 | 删除存储桶的静态网站配置 |
put_bucket_website(Bucket, WebsiteConfiguration={}, **kwargs)
# -*- coding=utf-8from qcloud_cos import CosConfigfrom qcloud_cos import CosS3Clientimport sysimport osimport logging# 正常情况日志级别使用 INFO,需要定位时可以修改为 DEBUG,此时 SDK 会打印和服务端的通信信息logging.basicConfig(level=logging.INFO, stream=sys.stdout)# 1. 设置用户属性, 包括 secret_id, secret_key, region 等。Appid 已在 CosConfig 中移除,请在参数 Bucket 中带上 Appid。Bucket 由 BucketName-Appid 组成secret_id = os.environ['COS_SECRET_ID'] # 用户的 SecretId,建议使用子账号密钥,授权遵循最小权限指引,降低使用风险。子账号密钥获取可参见 https://www.tencentcloud.com/document/product/598/32675secret_key = os.environ['COS_SECRET_KEY'] # 用户的 SecretKey,建议使用子账号密钥,授权遵循最小权限指引,降低使用风险。子账号密钥获取可参见 https://www.tencentcloud.com/document/product/598/32675region = 'ap-beijing' # 替换为用户的 region,已创建桶归属的 region 可以在控制台查看,https://console.tencentcloud.com/cos5/bucket# COS 支持的所有 region 列表参见 https://www.tencentcloud.com/document/product/436/6224token = None # 如果使用永久密钥不需要填入token,如果使用临时密钥需要填入,临时密钥生成和使用指引参见 https://www.tencentcloud.com/document/product/436/14048scheme = 'https' # 指定使用 http/https 协议来访问 COS,默认为 https,可不填config = CosConfig(Region=region, SecretId=secret_id, SecretKey=secret_key, Token=token, Scheme=scheme)client = CosS3Client(config)response = client.put_bucket_website(Bucket='bucket',WebsiteConfiguration={'IndexDocument': {'Suffix': 'string'},'ErrorDocument': {'Key': 'string'},'RedirectAllRequestsTo': {'Protocol': 'http'|'https'},'RoutingRules': [{'Condition': {'HttpErrorCodeReturnedEquals': 'string','KeyPrefixEquals': 'string'},'Redirect': {'HttpRedirectCode': 'string','Protocol': 'http'|'https','ReplaceKeyPrefixWith': 'string','ReplaceKeyWith': 'string'}}]})
参数名称 | 参数描述 | 类型 | 是否必填 |
Bucket | 设置静态网站的存储桶,格式为 BucketName-APPID ,详情请参见 命名规范 | String | 是 |
IndexDocument | 设置静态网站首页的配置 | Dict | 是 |
Suffix | 静态网站首页地址的后缀配置 | String | 是 |
ErrorDocument | 设置静态网站错误页面配置 | Dict | 否 |
Key | 错误页面地址 | String | 否 |
RedirectAllRequestsTo | 设置全站重定向配置 | Dict | 否 |
Protocol | 全站重定向协议,可选值为 http、https | String | 否 |
RoutingRules | 设置静态网站路由规则 | List | 否 |
Condition | 路由的条件,包括错误码重定向和前缀重定向 | Dict | 否 |
HttpErrorCodeReturnedEquals | 错误码重定向的条件 | String | 否 |
KeyPrefixEquals | 前缀重定向的条件 | String | 否 |
Redirect | 重定向的具体规则 | Dict | 否 |
HttpRedirectCode | 重定向时的错误码 | String | 否 |
Protocol | 重定向的协议,可选值为 http、https | String | 否 |
ReplaceKeyPrefixWith | 重定向时替换前缀为指定的 key | String | 否 |
ReplaceKeyWith | 重定向时替换整个路径为指定的 key | String | 否 |
get_bucket_website(Bucket, **kwargs)
# -*- coding=utf-8from qcloud_cos import CosConfigfrom qcloud_cos import CosS3Clientimport sysimport osimport logging# 正常情况日志级别使用 INFO,需要定位时可以修改为 DEBUG,此时 SDK 会打印和服务端的通信信息logging.basicConfig(level=logging.INFO, stream=sys.stdout)# 1. 设置用户属性, 包括 secret_id, secret_key, region 等。Appid 已在 CosConfig 中移除,请在参数 Bucket 中带上 Appid。Bucket 由 BucketName-Appid 组成secret_id = os.environ['COS_SECRET_ID'] # 用户的 SecretId,建议使用子账号密钥,授权遵循最小权限指引,降低使用风险。子账号密钥获取可参见 https://www.tencentcloud.com/document/product/598/32675secret_key = os.environ['COS_SECRET_KEY'] # 用户的 SecretKey,建议使用子账号密钥,授权遵循最小权限指引,降低使用风险。子账号密钥获取可参见 https://www.tencentcloud.com/document/product/598/32675region = 'ap-beijing' # 替换为用户的 region,已创建桶归属的 region 可以在控制台查看,https://console.tencentcloud.com/cos5/bucket# COS 支持的所有 region 列表参见 https://www.tencentcloud.com/document/product/436/6224token = None # 如果使用永久密钥不需要填入 token,如果使用临时密钥需要填入,临时密钥生成和使用指引参见 https://www.tencentcloud.com/document/product/436/14048scheme = 'https' # 指定使用 http/https 协议来访问 COS,默认为 https,可不填config = CosConfig(Region=region, SecretId=secret_id, SecretKey=secret_key, Token=token, Scheme=scheme)client = CosS3Client(config)response = client.get_bucket_website(Bucket='examplebucket-1250000000')
参数名称 | 参数描述 | 类型 | 是否必填 |
Bucket | 查询静态网站配置的存储桶,格式为 BucketName-APPID ,详情请参见 命名规范 | String | 是 |
{'IndexDocument': {'Suffix': 'string'},'ErrorDocument': {'Key': 'string'},'RedirectAllRequestsTo': {'Protocol': 'http'|'https'},'RoutingRules': [{'Condition': {'HttpErrorCodeReturnedEquals': 'string','KeyPrefixEquals': 'string'},'Redirect': {'HttpRedirectCode': 'string','Protocol': 'http'|'https','ReplaceKeyPrefixWith': 'string','ReplaceKeyWith': 'string'}}]}
参数名称 | 参数描述 | 类型 |
IndexDocument | 设置静态网站首页的配置 | Dict |
Suffix | 静态网站首页地址的后缀配置 | String |
ErrorDocument | 设置静态网站错误页面配置 | Dict |
Key | 错误页面地址 | String |
RedirectAllRequestsTo | 设置全站重定向配置 | Dict |
Protocol | 全站重定向协议,可选值为 http、https | String |
RoutingRules | 设置静态网站路由规则 | List |
Condition | 路由的条件,包括错误码重定向和前缀重定向 | Dict |
HttpErrorCodeReturnedEquals | 错误码重定向的条件 | String |
KeyPrefixEquals | 前缀重定向的条件 | String |
Redirect | 重定向的具体规则 | Dict |
HttpRedirectCode | 重定向时的错误码 | String |
Protocol | 重定向的协议,可选值为 http、https | String |
ReplaceKeyPrefixWith | 重定向时替换前缀为指定的 key | String |
ReplaceKeyWith | 重定向时替换整个路径为指定的 key | String |
delete_bucket_website(Bucket, **kwargs)
# -*- coding=utf-8from qcloud_cos import CosConfigfrom qcloud_cos import CosS3Clientimport sysimport osimport logging# 正常情况日志级别使用 INFO,需要定位时可以修改为 DEBUG,此时 SDK 会打印和服务端的通信信息logging.basicConfig(level=logging.INFO, stream=sys.stdout)# 1. 设置用户属性, 包括 secret_id, secret_key, region等。Appid 已在 CosConfig 中移除,请在参数 Bucket 中带上 Appid。Bucket 由 BucketName-Appid 组成secret_id = os.environ['COS_SECRET_ID'] # 用户的 SecretId,建议使用子账号密钥,授权遵循最小权限指引,降低使用风险。子账号密钥获取可参见 https://www.tencentcloud.com/document/product/598/32675secret_key = os.environ['COS_SECRET_KEY'] # 用户的 SecretKey,建议使用子账号密钥,授权遵循最小权限指引,降低使用风险。子账号密钥获取可参见 https://www.tencentcloud.com/document/product/598/32675region = 'ap-beijing' # 替换为用户的 region,已创建桶归属的 region 可以在控制台查看,https://console.tencentcloud.com/cos5/bucket# COS 支持的所有 region 列表参见 https://www.tencentcloud.com/document/product/436/6224token = None # 如果使用永久密钥不需要填入 token,如果使用临时密钥需要填入,临时密钥生成和使用指引参见 https://www.tencentcloud.com/document/product/436/14048scheme = 'https' # 指定使用 http/https 协议来访问 COS,默认为 https,可不填config = CosConfig(Region=region, SecretId=secret_id, SecretKey=secret_key, Token=token, Scheme=scheme)client = CosS3Client(config)response = client.delete_bucket_website(Bucket='examplebucket-1250000000')
参数名称 | 参数描述 | 类型 | 是否必填 |
Bucket | 被删除静态网站配置的存储桶,格式为 BucketName-APPID ,详情请参见 命名规范 | String | 是 |
本页内容是否解决了您的问题?