调用AddGtmAddressPool新增地址池。

调试

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

请求参数

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

系统规定参数。取值：AddGtmAddressPool。
InstanceId String 是 gtm-cn-xxxxxxx

实例ID。
MinAvailableAddrNum Integer 是 2

最小可用地址数量。
Name String 是 阿里云集群

地址池名称。
Type String 是 IP

地址池类型。取值：

  • IP：IPv4地址
  • DOMAIN：域名
Lang String 否 en

用户语言。
Addr.N.Value String 否 1.1.1.1

地址池地址。
Addr.N.LbaWeight Integer 否 1

地址池权重。
Addr.N.Mode String 否 SMART

地址池模式。取值：

  • SMART：智能返回
  • ONLINE：永远在线
  • OFFLINE：永远离线
MonitorStatus String 否 OPEN

健康检查开启状态。取值：

  • OPEN：开启
  • CLOSE（默认）：关闭
ProtocolType String 否 HTTPS

检查协议。取值：

  • HTTP
  • HTTPS
  • PING
  • TCP
Interval Integer 否 60

检查间隔，单位：秒，取值范围：60。
EvaluationCount Integer 否 2

连续次数。
Timeout Integer 否 60

超时时间，单位：毫秒，取值范围：2000、3000、5000、10000。
MonitorExtendInfo String 否 {"host":"aliyun.com","port":80}

扩展信息。根据不同协议，进行传参：

HTTP、HTTPS：

  • port：检查端口
  • failureRate：失败率
  • code：返回码（大于此值会被判定为异常）。取值：400、500。
  • host：Host设置
  • path：URL路径

PING:

  • packetNum：ping包数
  • packetLossRate：ping丢包率
  • failureRate：失败率

TCP：

  • port：检查端口
  • failureRate：失败率
IspCityNode.N.CityCode String 否 546

监控节点的城市Code。具体取值请参考DescribeGtmMonitorAvailableConfig的返回值。
IspCityNode.N.IspCode String 否 465
  • 具体取值可参考：DescribeGtmMonitorAvailableConfig接口返回数据。
  • GroupType为BGP或Overseas时，IspCityNode.N.IspCode为非必传值，默认为465。
  • GroupType为非BGP或Overseas时，IspCityNode.N.IspCode为必传值。并与IspCityNode.N.CityCode匹配使用。

返回数据

名称 类型 示例值 描述
RequestId String 6856BCF6-11D6-4D7E-AC53-FD579933522B

请求ID。
AddrPoolId String hraf3x

地址池ID。
MonitorConfigId String hraf14

健康检查配置ID。

示例

请求示例

http(s)://alidns.aliyuncs.com/?Action=AddGtmAddressPool
&InstanceId=gtm-cn-xxxxxxx
&MinAvailableAddrNum=2
&Name=阿里云集群
&Type=IP
&<公共请求参数>

正常返回示例

XML 格式 

<AddGtmAddressPoolResponse>
      <RequestId>6856BCF6-11D6-4D7E-AC53-FD579933522B</RequestId>
	  <AddrPoolId>hraf3x</AddrPoolId>
	  <MonitorConfigId>hraf14</MonitorConfigId>
</AddGtmAddressPoolResponse>

JSON 格式 

{
    "RequestId": "6856BCF6-11D6-4D7E-AC53-FD579933522B",
    "AddrPoolId": "hraf3x",
    "MonitorConfigId": "hraf14"
}

错误码

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