You can call this operation to create a defense rule to protect your assets from brute-force attacks.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes CreateAntiBruteForceRule

The operation that you want to perform.

Set the value to: CreateAntiBruteForceRule.

SourceIp String No 1.2.3.4

The source IP address of the request.
Name String No Defense rules against brute-force attacks

Specifies the name of a defense rule.
Span Integer No 15

The time period during which the number of logon attempts are calculated.
FailCount Integer No 10

The maximum number of logon attempts specified in the defense rule.
ForbiddenTime Integer No 10

The time period during which logons from the blocked IP address are blocked.
UuidList.N RepeatList No uuid-1312133-ssas,uuid-1234-qwer-dss

The list of servers to which the defense rule is applied.
DefaultRule Boolean No true

Specifies whether to set the defense rule as the default rule. Valid values:

  • true: Yes
  • false: No

Response parameters

Parameter Type Example Description
CreateAntiBruteForceRule Struct

The result of the request.
RuleId Long 6363

The ID of the defense rule.
RequestId String FB3E435F-4116-46F9-A5DE-C338DDA04F47

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/? Action=CreateAntiBruteForceRule
&<Common request parameters>

Sample success responses

XML format 

<CreateAntiBruteForceRuleResponse>
  <CreateAntiBruteForceRule>
        <RuleId>6363</RuleId>
  </CreateAntiBruteForceRule>
  <requestId>FB3E435F-4116-46F9-A5DE-C338DDA04F47</requestId>
</CreateAntiBruteForceRuleResponse>

JSON format 

{
	"CreateAntiBruteForceRule": {
		"RuleId": 6363
	},
	"requestId": "FB3E435F-4116-46F9-A5DE-C338DDA04F47"

}

Error codes

For a list of error codes, visit the API Error Center.