import { APIResource } from "../../../../core/resource.mjs"; import { APIPromise } from "../../../../core/api-promise.mjs"; import { RequestOptions } from "../../../../internal/request-options.mjs"; export declare class BaseAses extends APIResource { static readonly _key: readonly ['radar', 'bgp', 'top', 'ases']; /** * Retrieves the top autonomous systems by BGP updates (announcements only). * * @example * ```ts * const ase = await client.radar.bgp.top.ases.get(); * ``` */ get(query?: AseGetParams | null | undefined, options?: RequestOptions): APIPromise; /** * Retrieves the full list of autonomous systems on the global routing table * ordered by announced prefixes count. The data comes from public BGP MRT data * archives and updates every 2 hours. * * @example * ```ts * const response = await client.radar.bgp.top.ases.prefixes(); * ``` */ prefixes(query?: AsePrefixesParams | null | undefined, options?: RequestOptions): APIPromise; } export declare class Ases extends BaseAses { } export interface AseGetResponse { meta: AseGetResponse.Meta; top_0: Array; } export declare namespace AseGetResponse { interface Meta { dateRange: Array; } namespace Meta { interface DateRange { /** * Adjusted end of date range. */ endTime: string; /** * Adjusted start of date range. */ startTime: string; } } interface Top0 { asn: number; ASName: string; /** * Percentage of updates by this AS out of the total updates by all autonomous * systems. */ value: string; } } export interface AsePrefixesResponse { asns: Array; meta: AsePrefixesResponse.Meta; } export declare namespace AsePrefixesResponse { interface ASN { asn: number; country: string; name: string; pfxs_count: number; } interface Meta { data_time: string; query_time: string; total_peers: number; } } export interface AseGetParams { /** * Filters results by Autonomous System. Specify one or more Autonomous System * Numbers (ASNs) as a comma-separated list. Prefix with `-` to exclude ASNs from * results. For example, `-174, 3356` excludes results from AS174, but includes * results from AS3356. */ asn?: Array; /** * End of the date range (inclusive). Alternative to `dateRange`; provide together * with `dateStart`. When requesting comparison series, every series must resolve * to the same duration as the main series. Each `dateStart`/`dateEnd` is floored * to the nearest 15 minutes before evaluation, so windows whose durations match * only before alignment may be rejected. */ dateEnd?: Array; /** * Filters results by relative date range ending at the current time, with each * value producing a separate series. Use `d` for days (up to `364d`) or `w` * for weeks (up to `52w`). Append `control` to request the equivalent previous * period for comparison: the comparison window is shifted back by the current * window's length rounded up to a whole number of weeks, so it keeps the same * weekday alignment and does not overlap the current window (e.g. `7dcontrol` * covers days -14 to -7, `10dcontrol` covers days -24 to -14). For example, pass * `7d` and `7dcontrol` to compare this week with the previous week. All series * must resolve to the same duration as the main series; relative ranges (including * `control`) satisfy this automatically. Use this parameter or set specific start * and end dates (`dateStart` and `dateEnd` parameters). */ dateRange?: Array; /** * Start of the date range. Alternative to `dateRange`; provide together with * `dateEnd`. When requesting comparison series, every series must resolve to the * same duration as the main series. Each `dateStart`/`dateEnd` is floored to the * nearest 15 minutes before evaluation, so windows whose durations match only * before alignment may be rejected. */ dateStart?: Array; /** * Format in which results will be returned. */ format?: 'JSON' | 'CSV'; /** * Limits the number of objects returned in the response. */ limit?: number; /** * Array of names used to label the series in the response. */ name?: Array; /** * Filters results by BGP network prefix. */ prefix?: Array; /** * Filters results by BGP update type. */ updateType?: Array<'ANNOUNCEMENT' | 'WITHDRAWAL'>; } export interface AsePrefixesParams { /** * Alpha-2 country code. */ country?: string; /** * Format in which results will be returned. */ format?: 'JSON' | 'CSV'; /** * Maximum number of ASes to return. */ limit?: number; } export declare namespace Ases { export { type AseGetResponse as AseGetResponse, type AsePrefixesResponse as AsePrefixesResponse, type AseGetParams as AseGetParams, type AsePrefixesParams as AsePrefixesParams, }; } //# sourceMappingURL=ases.d.mts.map