调用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头部字段名称。

说明 仅在Field为header时有效。
MatchMethod String belong

逻辑符。
Expires Long 0

规则有效期。单位：秒。规则的匹配动作为阻断时（action为block）生效，在规则有效期内阻断访问请求。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"
}

错误码

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