文档中心

对象存储

请输入

流控策略（QoS policy）

创建流控策略

TOS 支持使用可视化及 JSON 视图的方式自定义流控策略。本文介绍自定义创建流控策略的操作步骤。

注意事项

每个主账号所有流控策略的 JSON 描述总大小不能超过 20KB。

单个 Statement 中，Resource 和 Principal 的数量分别不能超过 10 条。

如果请求同时匹配多条流控策略，则多个流控策略会同时生效；在此情况下，若多个流控策略存在相同类别的流控限制条件，按照配额最低的流控限制条件为准进行限流。

流控策略定义某个地域具体资源具体条件的带宽上限，突发带宽是账号在地域纬度上总带宽的弹性上限。两者作用层级不同，同时生效。

例如某账号华北1（广州）的内网下载带宽为 10 Gbps，突发带宽为 5 Gbps，则总内网下载带宽配额为 15 Gbps，此时：

若为该账号下的 my-data 存储桶设置流控策略，限制其最大内网读带宽为 2 Gbps，则系统允许 my-data 存储桶最大内网读带宽为 2 Gbps。

若为该账号下的 my-data 存储桶设置流控策略，限制其最大内网读带宽为 20 Gbps，由于该账号总内网下载带宽配额为 15 Gbps，因此系统允许 my-data 存储桶最大内网读带宽为 15 Gbps。

主账号默认拥有全部权限，IAM 子用户默认没有任何权限。如果您需要使用子账号执行该操作，则需要主账号通过 IAM 策略或桶策略为该子账号授予以下权限。

设置流控策略：tos:PutQosPolicy

查看流控策略：tos:GetQosPolicy

删除流控策略：tos:DeleteQosPolicy

使用可视化视图创建流控策略

登录对象存储控制台。

在左侧导航栏，选择流控管理＞流控策略管理。

在流控策略管理页面左上方，选择地域。

在可视化视图页签下，单击创建策略。

在创建流控策略页面，设置如下参数。

参数	说明
策略配置方式	选择可视化视图。
策略名称	输入策略名称，规则如下：策略名称不能重复。只能包含大小写字母、数字、中划线（-）、下划线（_）、英文句号（.）、英文冒号（:）、百分号（%）。长度限制在 1～255 字符之间。如果不填，则 TOS 会自动生成策略名称。
策略类型	流控策略类型。阈值流控：支持多维度和多种资源组合限制访问 TOS 资源组的流量，实现多个业务隔离。优先级流控：在阈值流控的基础上，引入多级优先级和保底配额设计，保障核心业务稳定和资源利用率最大化。
流控值	设置流控类别，输入具体流控值，说明如下：写QPS：写请求的 QPS，取值为正整数。读QPS：读请求的 QPS，取值为正整数。 List类QPS：List 请求的 QPS，取值为正整数。写带宽：上传带宽，单位为 Mbps，取值为正整数。读带宽：下载带宽，单位为 Mbps，取值为正整数。同步FetchQps：同步 FetchQPS，取值为正整数。同步Fetch带宽：同步 Fetch 带宽，单位为 Mbps，取值为正整数。异步FetchQPS：异步 FetchQPS，取值为正整数。异步Fetch带宽：异步 Fetch 带宽，单位为 Mbps，取值为正整数。说明关于每个地域每个主账号的读写请求、带宽上限的详细介绍，请参见约束限制。
优先级	流控策略优先级，配置规则如下：取值为自然数，从数字 1 开始，需要连续且不能重复，例如支持 1/2、1/2/3，不支持 1/3。至少配置 2 个优先层级，最多支持 3 个。优先层级数字越大，优先级越高。说明仅当策略类型选择优先级流控时，该参数有效。添加优先级配置后，系统自动设置优先级，无需手动填写。您也可以单击操作列的上移、下移，调整优先级。
保底流控值	为特定优先级预留的最小资源量，即使在系统满负荷时也能确保获得。取值同参数流控值。说明仅当策略类型选择优先级流控时，该参数有效。各个优先级都必须配置保底配额且必须大于 0，即每增加一个优先级，都需要给这个优先级增加保底配额。所有优先级的保底配额之和必须小于或等于总配额。
授权用户	指定账号：用户范围为指定账号，说明如下：当前主账号：用户范围为当前主账号下的 IAM 用户（子用户）或角色，无需输入主账号 ID，单击添加一行，可以选择子用户名称或角色名称。其他主账号：用户范围为其他主账号、其他主账号的 IAM 用户（子用户）或角色，需要输入其他主账号 ID、其他主账号的子用户名称或角色名称。所有用户：用户范围为所有用户（包含匿名用户）。
用户策略	用于指定流控策略作用的用户范围，说明如下：包含以上用户：流控策略作用于授权用户。排除以上用户：流控策略作用于除授权用户外的其他用户。说明当授权用户为所有用户时，不支持设置用户策略为排除以上用户。
资源范围	所有桶：资源范围为所有存储桶。桶内对象：资源范围为某个存储桶，选择需指定存储桶，然后设置作用范围，说明如下：所有对象：桶内所有对象。指定对象：桶内指定对象。选择指定对象后，单击新增资源路径，可以设置指定对象前缀字段。说明如果在资源处同时选择所有桶和桶内对象，表示资源范围为所有桶。
资源策略	用于指定流控策略作用的资源范围，说明如下：包含以上资源：流控策略作用于指定资源。排除以上资源：流控策略作用于除指定资源外的其他资源。说明当资源为所有桶时，不支持设置资源策略为排除以上资源。
条件	单击添加一行，设置您所需要的条件及值。关于条件的详细说明，请参见条件说明。

设置完成后，单击下一步。

确认信息无误后，单击确定。

使用 JSON 视图创建流控策略

登录对象存储控制台。

在左侧导航栏，选择流控管理＞流控策略管理。

在流控策略管理页面左上方，选择地域。

单击 JSON视图页签。

单击编辑，设置策略内容，关于流控策略参数说明，请参见参数说明。

阈值流控示例如下：

以下策略设置 aaa 子用户在 bucketname 桶的上传带宽上限为 5000 Mbps。

{
"Statement": [
{
"Sid": "test",
"Quota": {
"WritesQps": "",
"ReadsQps": "",
"ListQps": "",
"WritesRate": "5000",
"ReadsRate": "",
"FetchQps": "",
"FetchRate": "",
"AsyncFetchQps": "",
"AsyncFetchRate": ""
},
"Principal": [
"trn:iam::214748****:user/aaa"
],
"Resource": "trn:tos:::bucketname/*"
}
]
}

优先级流控示例如下：

以下策略设置 aaa 子用户在 bucket1/bucket2/bucket3 桶的上传带宽上限为 5000Mbps，桶 bucket1 为优先级 1，保底上传带宽为 1000Mbps；桶 bucket2 为优先级 2，保底上传带宽为 1000Mbps；桶 bucket3 为优先级 3，保底上传带宽为 3000Mbps。

{
"Statement": [
{
"Sid": "test-qos-policy",
"Quota": {
"WritesRate": "5000"
},
"Priority": [
{
"PriorityLevel": 3,
"GuaranteedQuota": {
"WritesRate": "3000"
},
"Principal": [
"trn:iam::200000:user/aaa"
],
"Resource": "trn:tos:::bucket3/*"
},
{
"PriorityLevel": 2,
"GuaranteedQuota": {
"WritesRate": "1000"
},
"Principal": [
"trn:iam::200000:user/aaa"
],
"Resource": "trn:tos:::bucket2/*"
},
{
"PriorityLevel": 1,
"GuaranteedQuota": {
"WritesRate": "1000"
},
"Principal": [
"trn:iam::200000:user/aaa"
],
"Resource": "trn:tos:::bucket1/*"
}
]
}
]
}

参数设置完成后，单击保存。