阿里云首页 HTTPDNS

IPv4异步解析接口

异步解析接口

使用异步解析接口,首先查询缓存,若存在则返回结果,若不存在返回null并且进行异步域名解析更新缓存。

注意

  • 解析结果返回的IP是服务端返回的IP数组中的第一个IP,不一定是最优IP。

  • 如果您需要返回的IP是最优IP,您可以使用启用IP优选接口,使返回的IP为最优IP。

接口定义

 - (NSString *)getIpByHostAsync:(NSString *)host;

参数说明

参数

类型

是否必填

说明

host

NSString

域名(如www.aliyun.com)

异步解析获取解析结果列表

异步解析接口,获取IP列表,首先查询缓存,若存在则返回结果列表,若不存在返回null并且进行异步域名解析更新缓存。

接口定义

 - (NSArray *)getIpsByHostAsync:(NSString *)host;

参数说明

参数

类型

是否必填

说明

host

NSString

域名(如www.aliyun.com)

启用IP优选

设置IP探测列表,设置该接口后,如果解析了相应的域名,则SDK会对返回的IP进行IP探测,对返回的列表进行动态排序,以保证第一个IP是可用性最好的IP。

注意

SDK V1.6.12及以上版本支持。

接口定义

- (void)setIPRankingDatasource:(NSDictionary<NSString *, NSNumber *> *)IPRankingDatasource;

参数说明

参数

类型

是否必填

说明

IPRankingDatasource

NSDictionary<NSString *, NSNumber *>

设置对应域名的端口号

@{host: port}

代码示例

 HttpDnsService *httpdns = [[HttpDnsService alloc] initWithAccountID:XXXX];
    NSDictionary *IPRankingDatasource = @{
                                 @"www.abc.com" : @80,
                                 @"www.cba.com" : @443,
                                 @"www.bac.com" : @443
                                 };
    [httpdns setIPRankingDatasource:IPRankingDatasource];

异步解析获取URL使用场景下的格式化结果

异步解析接口,首先查询缓存,若存在则返回结果,若不存在返回空对象并且进行异步解析更新缓存。返回的结果是URL使用场景下的格式化结果。

接口定义

 - (NSString *)getIpByHostAsyncInURLFormat:(NSString *)host;

参数说明

参数

类型

是否必填

说明

host

NSString

域名