SetCdnFullDomainsBlockIP - CDN - Alibaba Cloud Documentation Center

Blocks or unblocks IP addresses from accessing domain names.

Operation description

Note

To use this operation, submit a ticket.
This operation is suitable for blocking or unblocking a maximum of 1,000 IP addresses or CIDR blocks at a time.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

Operation: the value that you can use in the Action element to specify the operation on a resource.
Access level: the access level of each operation. The levels are read, write, and list.
Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
Condition Key: the condition key that is defined by the cloud service.
Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.

Operation	Access level	Resource type	Condition key	Associated operation
cdn:SetCdnFullDomainsBlockIP	update	All Resources ``	none	none

Request parameters

Parameter	Type	Required	Description	Example
IPList	string	Yes	The IP addresses that you want to block or unblock. Separate multiple IP addresses with commas (,). You can specify up to 1,000 IP addresses.	1.XXX.XXX.1,2.XXX.XXX.2
OperationType	string	Yes	The type of the operation. block unblock	block
BlockInterval	integer	No	The duration for which IP addresses or CIDR blocks are blocked. Unit: seconds. The value 0 specifies that IP addresses or CIDR blocks are permanently blocked. This parameter is available only if you set OperationType to block.	3000
UpdateType	string	No	The type of the blocking duration. This parameter is available only if you set OperationType to block. Valid values: cover: The blocking duration that is specified in the request takes effect. uncover: The longer one of the blocking duration that is specified in the request and the remaining blocking duration takes effect. Default value: cover.	cover

Response parameters

Parameter	Type	Description	Example
	object	Schema of Response
Code	integer	The status code. The status code 0 indicates that the call is successful. If another status code is returned, the call fails.	0
Message	string	The additional information returned. If the request was successful, OK is returned. If the request failed, an error message is returned.	OK
RequestId	string	The request ID.	23ACE7E2-2302-42E3-98F8-E5E697FD86C3

Examples

Sample success responses

JSONformat

{
  "Code": 0,
  "Message": "OK",
  "RequestId": "23ACE7E2-2302-42E3-98F8-E5E697FD86C3"
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidParameter	The specified parameter is invalid.	-
400	QuotaExceeded	The quota is exceeded.	The quota is exhausted.
403	OperationDenied	You do not have access to this operation.	You are not authorized to operate the specified resource; please check your authorization using RAM.

For a list of error codes, visit the Service error codes.