调用DescribeWebPreciseAccessRule查询网站业务精确访问控制规则。

调试

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

请求参数

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

要执行的操作。取值:DescribeWebPreciseAccessRule

Domains.N RepeatList www.aliyun.com

网站业务的域名。

说明 域名必须已配置网站业务转发规则。您可以调用DescribeDomains查询所有域名。
RegionId String cn-hangzhou

DDoS高防服务地域ID。取值:

  • cn-hangzhou:表示DDoS高防(新BGP)服务
  • ap-southeast-1:表示DDoS高防(国际)服务
ResourceGroupId String default

DDoS高防实例在资源管理产品中所属的资源组ID。默认为空,即属于默认资源组。

返回数据

名称 类型 示例值 描述
PreciseAccessConfigList Array

网站业务精确访问控制规则。

Domain String www.aliyun.com

网站域名。

RuleList Array

规则列表。

Action String accept

匹配动作。取值:

  • accept:放行
  • block:封禁
  • challenge:挑战
ConditionList Array

匹配条件列表。

Content String 1.1.1.1

匹配内容。

Field String ip

匹配字段。

HeaderName String null

自定义HTTP头部字段名称。

说明 仅在Fieldheader时有效。
MatchMethod String belong

逻辑符。

Expires Long 0

规则有效期。单位:秒。规则的匹配动作为阻断时(actionblock)生效,在规则有效期内阻断访问请求。0表示永久生效。

Name String testrule

规则名称。

Owner String manual

规则来源。取值:

  • manual:手动添加(默认)
  • auto:自动生成
RequestId String 209EEFBF-B0C7-441E-8C28-D0945A57A638

本次请求的ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeWebPreciseAccessRule
&Domains.1=www.aliyun.com
&<公共请求参数>

正常返回示例

XML 格式

<DescribeWebPreciseAccessRuleResponse>
	  <PreciseAccessConfigList>
		    <RuleList>
			      <Owner>manual</Owner>
			      <Action>accept</Action>
			      <ConditionList>
				        <MatchMethod>belong</MatchMethod>
				        <Field>ip</Field>
				        <HeaderName></HeaderName>
				        <Content>1.***.***.2</Content>
			      </ConditionList>
			      <Expires>0</Expires>
			      <Name>testrule</Name>
		    </RuleList>
		    <Domain>www.aliyun.com</Domain>
	  </PreciseAccessConfigList>
	  <RequestId>209EEFBF-B0C7-441E-8C28-D0945A57A638</RequestId>
</DescribeWebPreciseAccessRuleResponse>

JSON 格式

{
	"PreciseAccessConfigList": [
		{
			"RuleList": [
				{
					"Owner": "manual",
					"Action": "accept",
					"ConditionList": [
						{
							"MatchMethod": "belong",
							"Field": "ip",
							"HeaderName": "",
							"Content": "1.***.***.2"
						}
					],
					"Expires": 0,
					"Name": "testrule"
				}
			],
			"Domain": "www.aliyun.com"
		}
	],
	"RequestId": "209EEFBF-B0C7-441E-8C28-D0945A57A638"
}

错误码

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