调用GetQosAttribute查询QOS详情信息_智能接入网关(SAG)-阿里云帮助中心

调用GetQosAttribute接口查询QoS策略实例信息。

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
smartag:GetQosAttribute	get	*Qos `acs:smartag:{#regionId}:{#accountId}:qos/{#QosId}`	无	无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	QoS 策略实例所属地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。	cn-shanghai
QosId	string	是	QoS 策略实例 ID。	qos-1iqifund3gcno5****

返回参数

名称	类型	描述	示例值
	object	返回结果。
QosPolicies	array<object>	QoS 策略实例的五元组规则信息列表。
QosPolicy	object	QoS 策略实例的五元组规则信息。
EndTime	long	五元组规则失效时间。时间显示为北京时间，格式为：UTC 时间+8 小时。	2021-07-29T00:00:00+0800
StartTime	long	五元组规则开始生效时间。	2021-06-21T00:00:00+0800
DestCidr	string	目的网段。	0.0.0.0/0
DestPortRange	string	目的端口范围。取值范围：-1或 1~65535。目的端口范围格式示例： 1/200，表示端口范围 1 至 200。 80/80，表示端口 80。 -1/-1，表示不限制端口。	-1/-1
IpProtocol	string	五元组规则应用的协议类型。	ALL
Priority	integer	五元组规则所属的限速规则的优先级。数值越小，优先级越高。	1
QosPolicieDescription	string	五元组规则的描述信息。	test
SourceCidr	string	源网段。	0.0.0.0/0
QosPolicieName	string	五元组规则名称。	test
SourcePortRange	string	源端口范围。取值范围：-1或 1~65535。源端口范围格式例如： 1/200，表示端口范围 1 至 200。 80/80，表示端口 80。 -1/-1，表示不限制端口。	-1/-1
QosCars	array<object>	配置异常的 QoS 策略限速规则信息。
QosCar	object	QoS 策略实例的限速规则信息列表。
MaxBandwidthAbs	integer	最大带宽。单位：Mbps。	2
QosCarName	string	限速规则的名称。	test
PercentSourceType	string	按百分比限速时的带宽类型： CcnBandwidth：云连接网带宽。 InternetUpBandwidth：公网上行带宽。	InternetUpBandwidth
MinBandwidthAbs	integer	最小带宽。单位：Mbps。	1
MaxBandwidthPercent	integer	最大带宽百分比。	20
QosCarDescription	string	限速规则的描述信息。	test
LimitType	string	限速类型： Absolute：按带宽值。 Percent：按百分比。	Absolute
Priority	integer	限速规则的优先级。优先级支持设置 1~3 级，数值越小，优先级越高。	1
MinBandwidthPercent	integer	最小带宽百分比。	10
QosCarId	string	限速规则 ID。	qoscar-xir1apa8ayjp56ei****
RequestId	string	请求 ID。	91058E01-1806-45D5-B305-19E4D0A5CE04
ErrorConfigSmartAGCount	integer	配置异常的智能接入网关实例个数。	1
QosName	string	QoS 策略实例的名称。	test
QosDescription	string	QoS 策略实例的描述信息。	test

示例

正常返回示例

JSON格式

{
  "QosPolicies": [
    {
      "EndTime": 0,
      "StartTime": 0,
      "DestCidr": "0.0.0.0/0",
      "DestPortRange": "-1/-1",
      "IpProtocol": "ALL",
      "Priority": 1,
      "QosPolicieDescription": "test",
      "SourceCidr": "0.0.0.0/0",
      "QosPolicieName": "test",
      "SourcePortRange": "-1/-1"
    }
  ],
  "QosCars": [
    {
      "MaxBandwidthAbs": 2,
      "QosCarName": "test",
      "PercentSourceType": "InternetUpBandwidth",
      "MinBandwidthAbs": 1,
      "MaxBandwidthPercent": 20,
      "QosCarDescription": "test",
      "LimitType": "Absolute",
      "Priority": 1,
      "MinBandwidthPercent": 10,
      "QosCarId": "qoscar-xir1apa8ayjp56ei****"
    }
  ],
  "RequestId": "91058E01-1806-45D5-B305-19E4D0A5CE04",
  "ErrorConfigSmartAGCount": 1,
  "QosName": "test",
  "QosDescription": "test"
}

错误码

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