定向分组新增目标地址。

调试

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

请求参数

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

系统规定参数。取值:AddDirectionalAddress

GroupId String 10000002595

分组ID。

Source String user_defined

地址类型:

客户配置: user_defined

阿里云预配:aliyun_defined

AddressType String Domain

目标地址类型:

Ip:Ip

域名:Domain

Address String *.aliyun.com

目标地址

SerialNo String 123123

请求编号,支持幂等。

MsgNotify Boolean false

执行成功后是否通过MQ推送,默认false:

false:不推送

true: 推送(目前不支持)

UrlInsecurityForce Boolean false

检测到的高危风险域名是否强制添加,默认被拦截,不添加

返回数据

名称 类型 示例值 描述
Data Boolean true

地址是否添加成功。

true:添加成功。

false:添加失败。

RequestId String E4F94B97-1D64-4080-BFD2-67461667AA43

请求ID,阿里云为该请求生成的标识符。

ErrorMessage String InstanceId cannot be empty.

调用失败时,返回的错误信息。

Success Boolean true

是否调用成功。

true:调用成功。

false:调用失败。

LocalizedMessage String InstanceId cannot be empty.

根据当前所在地展示对应语言的错误提示。

Code String 200

接口返回码。

200:调用成功。

其他:调用失败。错误码详情,请参见错误码。

示例

请求示例

http(s)://[Endpoint]/?Action=AddDirectionalAddress
&GroupId=10000002595
&Source=user_defined
&AddressType=Domain
&Address=*.aliyun.com
&SerialNo=123123
&MsgNotify=false
&公共请求参数

正常返回示例

XML格式

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

<AddDirectionalAddressResponse>
    <Data>true</Data>
    <RequestId>E4F94B97-1D64-4080-BFD2-67461667AA43</RequestId>
    <ErrorMessage>InstanceId cannot be empty.</ErrorMessage>
    <Success>true</Success>
    <LocalizedMessage>InstanceId cannot be empty.</LocalizedMessage>
    <Code>200</Code>
</AddDirectionalAddressResponse>

JSON格式

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

{
  "Data" : true,
  "RequestId" : "E4F94B97-1D64-4080-BFD2-67461667AA43",
  "ErrorMessage" : "InstanceId cannot be empty.",
  "Success" : true,
  "LocalizedMessage" : "InstanceId cannot be empty.",
  "Code" : "200"
}