All Products
Search
Document Center

Cloud Firewall:DeleteAddressBook

Last Updated:Oct 15, 2025

Deletes an address book.

Operation description

This operation deletes an address book for access control.

QPS limit

The queries per second (QPS) limit for a single user is 10 calls per second. If you exceed the limit, API calls are throttled. This may affect your business. Plan your calls accordingly.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

SourceIp deprecated

string

No

The source IP address of the request.

192.0.XX.XX

Lang

string

No

The language of the content within the request and response.

Valid values:

  • en :

    English

  • zh :

    Chinese (default)

zh

GroupUuid

string

Yes

The unique ID of the address book.

Note

To obtain this ID, call the DescribeAddressBook operation.

0657ab9d-fe8b-4174-b2a6-6baf358e****

When you call this operation, you must include the common request parameters. For more information about common request parameters, see Common parameters. For the request format, see the request example in the Examples section of this topic.

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID.

850A84D6-0DE4-4797-A1E8-00090125EEB1

Examples

Success response

JSON format

{
  "RequestId": "850A84D6-0DE4-4797-A1E8-00090125EEB1"
}

Error codes

HTTP status code

Error code

Error message

Description

400 ErrorRecordLog An error occurred while updating the operation log. An error occurred while updating the operation log.
400 ErrorDBSelect An error occurred while querying database. An error occurred while querying database.
400 ErrorAddressGroupReference The address group is in use and cannot be deleted. The address group is in use and cannot be deleted.
400 ErrorParametersUid The aliUid parameter is invalid. The aliUid parameter is invalid.
400 ErrorAddressGroupNotExist The address group does not exist. The address group does not exist.
401 ErrorAuthentication An authentication error occurred. An authentication error occurred.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.