Modifies the address book that is configured for access control.

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 ModifyAddressBook

The operation that you want to perform. Set the value to ModifyAddressBook.

Description String Yes bj-001

The description of the address book.

GroupName String Yes bj-001

The name of the address book.

GroupUuid String Yes 0657ab9d-fe8b-4174-b2a6-6baf358e****

The ID of the address book.

Note To modify the address book, you must provide the ID of the address book. You can call the DescribeAddressBook operation to query the IDs.
SourceIp String No 1.2.XX.XX

The source IP address of the request.

Lang String No zh

The natural language of the request and response. Valid values:

  • zh: Chinese
  • en: English
AddressList String No 1.1.XX.XX/32,2.2.XX.XX/24

The addresses in the address book. Separate multiple addresses with commas (,). If you set GroupType to ip, port, or domain, you must specify this parameter.

  • If you set GroupType to ip, you must specify IP addresses for the address book. Example: 1.2.XX.XX/32,1.2.XX.XX/24.
  • If you set GroupType to port, you must specify port numbers or port ranges for the address book. Example: 80/80,100/200.
  • If you set GroupType to domain, you must specify domain names for the address book. Example: demo1.aliyun.com,demo2.aliyun.com.
AutoAddTagEcs String No 1

Specifies whether to automatically add public IP addresses of Elastic Compute Service (ECS) instances to the address book if they match the specified tags. Valid values:

  • 1: yes
  • 0: no
TagRelation String No and

The logical relation among ECS tags. Valid values:

  • and: Only the public IP addresses of ECS instances that match all the specified tags can be added to the address book.
  • or: The public IP addresses of ECS instances that match any of the specified tags can be added to the address book.
TagList.N.TagKey String No TXY

The key of ECS tag N that you want to match.

TagList.N.TagValue String No 1

The value of ECS tag N that you want to match.

All Alibaba Cloud API operations must include common request parameters. For more information about common request parameters, see Common parameters.

For more information about sample requests, see the "Examples" section of this topic.

Response parameters

Parameter Type Example Description
RequestId String CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ModifyAddressBook
&Description=bj-001
&GroupName=bj-001
&GroupUuid=0657ab9d-fe8b-4174-b2a6-6baf358e****
&<Common request parameters>

Sample success responses

XML format

<ModifyAddressBookResponse>
  <RequestId>CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D</RequestId>
</ModifyAddressBookResponse>

JSON format

{
    "RequestId": "CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D"
}