最近更新时间：2023.11.16 15:51:42
首次发布时间：2021.08.31 10:37:28
调用 DescribeRules 接口查询指定HTTP/HTTPS监听器中的转发规则列表。
| 名称 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeRules | 要执行的操作，取值为DescribeRules。 |
| Version | String | 是 | 2020-04-01 | API版本信息，当前版本为：2020-04-01。 |
| ListenerId | String | 是 | lsn-2fea4ayvu2g3k5oxruuz**** | 监听器ID。您可以调用DescribeListeners接口获取监听器ID。 |
| 字段 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 20210811152539010225146063030**** | 请求ID。 |
| Rules | Array of Struct | - | 符合条件的转发规则的详细信息。具体请参见下表“Rules”。 |
| 字段 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RuleId | String | rule-2fegss1cplxxc5oxruvvq**** | 转发规则ID。 |
| Domain | String | www.test.com | 转发规则的域名。 |
| Url | String | / | 转发规则的URL。 |
| ServerGroupId | String | rsp-2fel9y8pxr56o5oxruuuu**** | 转发规则关联的后端服务器组ID。 |
| Description | String | rule1 | 转发规则的描述。 |
GET /?Action=DescribeRules&Version=2020-04-01&ListenerId=lsn-2fea4ayvu2g3k5oxruuz**** HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing Service: clb
{ "ResponseMetadata": { "RequestId": "20210811152539010225146063030****", "Action": "DescribeRules", "Version": "2020-04-01", "Service": "clb", "Region": "cn-beijing" }, "Result": { "RequestId": "20210811152539010225146063030****", "Rules": [ { "RuleId": "rule-2fegss1cplxxc5oxruvvq****", "Domain": "abc.com", "Url": "/abcc", "ServerGroupId": "rsp-3ciynvqsspiww6c6rrsz7****", "Description": "TEST" } ] } }
此处仅展示当前API的错误码，更多错误码请参见公共错误码。
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
400 | MissingParameter | The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the 'XXX'. | 该请求缺少必要参数。请确保发起请求已提供全部必要参数，比如XXX。 说明 其中，XXX表示缺少的参数名称。 |
| 404 | InvalidListener.NotFound | The specified Listener does not exist. | 指定的监听器不存在。 |