调用CreateCenInterRegionTrafficQosPolicy接口创建跨地域流量调度策略。

使用说明

  • 仅企业版转发路由器下的跨地域连接支持创建跨地域流量调度策略。

    如果您的跨地域连接使用了测试带宽,则不支持创建跨地域流量调度策略。

  • 流量调度功能仅作用在企业版转发路由器的出方向。

    例如,您创建了华东1(杭州)与华北1(青岛)地域的跨地域连接,并在华东1(杭州)地域和华北1(青岛)地域的转发路由器下配置流量调度功能后,仅当流量从华东1(杭州)地域去往华北1(青岛)地域的过程中,流量调度功能帮您保证各类业务的使用带宽。

  • CreateCenInterRegionTrafficQosPolicy接口属于异步接口,即系统会先返回一个流量调度策略ID,但该流量调度策略并未创建完成,系统后台的创建任务仍在进行。您可以调用ListCenInterRegionTrafficQosPolicies接口查询流量调度策略的状态。
    • 当流量调度策略处于Creating状态时,表示流量调度策略正在创建中,在该状态下,您只能对流量调度策略执行查询操作,不能执行其他操作。
    • 当流量调度策略处于Active状态时,表示流量调度策略创建完成。

前提条件

在调用CreateCenInterRegionTrafficQosPolicy接口前,确保已满足以下条件:

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateCenInterRegionTrafficQosPolicy

系统规定参数。取值:CreateCenInterRegionTrafficQosPolicy

ClientToken String 123e4567-e89b-12d3-a456-426655****

客户端Token,用于保证请求的幂等性。

由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符。

DryRun Boolean false

是否只预检此次请求。取值:

  • true:发送检查请求,不会创建流量调度策略。检查项包括是否填写了必需参数、请求格式、业务限制等。如果检查不通过,则返回对应错误。如果检查通过,则返回错误码DryRunOperation
  • false(默认值):发送正常请求,通过检查后直接创建流量调度策略。
TransitRouterId String tr-8vbuqeo5h5pu3m01d****

转发路由器实例ID。

TransitRouterAttachmentId String tr-attach-r6g0m3epjehw57****

跨地域连接ID。

TrafficQosPolicyName String nametest

流量调度策略的名称。

名称长度为2~128个字符,以大小写字母或中文开头,可包含数字、短划线(-)和下划线(_)。

TrafficQosPolicyDescription String desctest

流量调度策略的描述信息。

描述长度为2~128个字符,以大小写字母或中文开头,可包含数字、短划线(-)和下划线(_)。

TrafficQosQueues.N.QosQueueName String nametest

当前队列的名称。

一个流量调度策略最多支持创建3个队列,每个队列可以被指定一个队列名称。

名称长度为2~128个字符,以大小写字母或中文开头,可包含数字、短划线(-)和下划线(_)。

TrafficQosQueues.N.RemainBandwidthPercent String 1

当前队列可使用的跨地域带宽的百分比。

一个流量调度策略最多支持创建3个队列,每个队列可以被指定允许使用的跨地域带宽百分比。

例如,您输入1,则表示符合当前队列的流量报文最多只能使用1%的跨地域带宽。

说明 一个流量调度策略下,所有队列的跨地域带宽百分比之和不能超过100%。
TrafficQosQueues.N.Dscps.N Integer 5

当前队列匹配的DSCP值。

一个流量调度策略最多支持创建3个队列,每个队列最多支持匹配60个DSCP值,DSCP值之间使用半角逗号(,)分隔。

TrafficQosQueues.N.QosQueueDescription String desctest

当前队列的描述信息。

一个流量调度策略最多支持创建3个队列,每个队列可以被添加一个队列描述信息。

描述长度为2~128个字符,以大小写字母或中文开头,可包含数字、短划线(-)和下划线(_)。

返回数据

名称 类型 示例值 描述
TrafficQosPolicyId String qos-eczzew0v1kzrb5****

流量调度策略ID。

RequestId String 6DF9A765-BCD2-5C7E-8C32-C35C8A361A39

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateCenInterRegionTrafficQosPolicy
&ClientToken=123e4567-e89b-12d3-a456-426655****
&DryRun=false
&TransitRouterId=tr-8vbuqeo5h5pu3m01d****
&TransitRouterAttachmentId=tr-attach-r6g0m3epjehw57****
&TrafficQosPolicyName=nametest
&TrafficQosPolicyDescription=desctest
&TrafficQosQueues=[{"QosQueueName":"nametest","RemainBandwidthPercent":"1","Dscps":[5],"QosQueueDescription":"desctest"}]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateCenInterRegionTrafficQosPolicyResponse>
    <TrafficQosPolicyId>qos-eczzew0v1kzrb5****</TrafficQosPolicyId>
    <RequestId>6DF9A765-BCD2-5C7E-8C32-C35C8A361A39</RequestId>
</CreateCenInterRegionTrafficQosPolicyResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TrafficQosPolicyId" : "qos-eczzew0v1kzrb5****",
  "RequestId" : "6DF9A765-BCD2-5C7E-8C32-C35C8A361A39"
}

错误码

访问错误中心查看更多错误码。