调用ModifyAddressBook接口修改访问控制策略中设置的地址簿。

使用说明

本接口一般用于修改访问控制策略中设置的地址簿。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifyAddressBook

系统规定参数。取值:ModifyAddressBook

SourceIp String 192.0.XX.XX

访问者源IP地址。

Lang String zh

请求和接收消息的语言类型。取值:

  • zh(默认):中文
  • en:英文
AddressList String 192.0.XX.XX/32,192.0.XX.XX/24

地址簿中的地址列表,多个地址间用英文逗号分隔。当GroupType为ipportdomain时,您必须配置此参数。

  • 当GroupType为ip时,地址列表中填写IP地址,例如:1.2.XX.XX/32,1.2.XX.XX/24。
  • 当GroupType为port时,地址列表中填写端口或端口范围,例如:80/80,100/200。
  • 当GroupType为domain时,地址列表中填写域名,例如:demo1.aliyun.com,demo2.aliyun.com。
Description String bj-001

地址簿的描述信息。

GroupName String bj-001

地址簿的名称。

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

地址簿的唯一标识ID。

说明 修改访问控制策略中设置的地址簿信息,需要提供该地址簿的唯一标识ID,该ID可调用DescribeAddressBook接口查询。
AutoAddTagEcs String 1

是否自动添加新匹配标签的ECS公网IP到地址簿。取值:

  • 1:表示自动添加
  • 0:表示不自动添加
TagRelation String and

多个ECS标签间的关系。取值:

  • and:多个标签间为“与”关系,即同时匹配多个标签的ECS公网IP才会被加入地址簿。
  • or:多个标签间为“或”关系,即只要匹配一个标签的ECS公网IP就会被加入地址簿。
TagList.N.TagValue String 1

待匹配的ECS标签值。

TagList.N.TagKey String TXY

待匹配的ECS标签Key。

调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见公共参数

调用API的请求格式,请参见本文示例中的请求示例。

返回数据

名称 类型 示例值 描述
RequestId String CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D

本次请求的ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyAddressBook
&SourceIp=192.0.XX.XX
&Lang=zh
&AddressList=192.0.XX.XX/32,192.0.XX.XX/24
&Description=bj-001
&GroupName=bj-001
&GroupUuid=0657ab9d-fe8b-4174-b2a6-6baf358e****
&AutoAddTagEcs=1
&TagRelation=and
&TagList=[{"TagValue":"1","TagKey":"TXY"}]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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