定向分组新增目标地址。
调试
您可以在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"
}