调用ModifyAddressBook接口修改安全访问控制的地址簿。

调试

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

请求参数

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

系统规定参数。取值:ModifyAddressBook。

Description String DEMO地址簿

地址簿的描述信息。

GroupName String demo_address_book

地址簿的名称。

GroupUuid String 0657ab9d-fe8b-4174-b2a6-6baf358ea4ad

地址簿的唯一标识ID。

修改安全访问控制的地址簿信息,需要提供该地址簿的唯一标识ID,该ID可调用DescribeAddressBook接口获取。

AddressList String 1.1.1.1/32, 2.2.2.0/24

地址簿中的地址列表,多个地址间用英文逗号分隔。

说明 当GroupType为ip、port或domain时必须设置。
  • 当GroupType为ip时,地址列表中填写IP地址。例如:1.2.3.4/32, 1.2.3.0/24
  • 当GroupType为port时,地址列表中填写端口或端口范围。例如:80, 100/200
  • 当GroupType为domain时,地址列表中填写域名。例如:demo1.aliyun.com, demo2.aliyun.com
AutoAddTagEcs String 1

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

  • 1:表示自动添加
  • 0:表示不自动添加
Lang String zh

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

  • zh:中文
  • en:英文
SourceIp String 1.2.3.4

访问者源IP地址。

TagList.N.TagKey String key1

待匹配的ECS标签Key。

TagList.N.TagValue String value1

待匹配的ECS标签值。

TagRelation String and

多个ECS标签间的的关系。

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

返回数据

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

结果的请求ID。

示例

请求示例


http(s)://[Endpoint]/?Action=ModifyAddressBook
&GroupUuid=0657ab9d-fe8b-4174-b2a6-6baf358ea4ad
&Description=DEMO地址簿
&GroupName=demo_address_book
&GroupType=ip
&AddressList=1.1.1.1/32,2.2.2.0/24
&<公共请求参数>

正常返回示例

XML 格式

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

JSON 格式

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

错误码

访问错误中心查看更多错误码。