cloudflare 7.0.0 → 7.1.0

package/src/resources/radar/as112/as112.ts

@@ -554,19 +554,35 @@ export interface AS112SummaryV2Params {
   continent?: Array<string>;
 
   /**
-   * End of the date range (inclusive).
+   * 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<string>;
 
   /**
-   * Filters results by date range. For example, use `7d` and `7dcontrol` to compare
-   * this week with the previous week. Use this parameter or set specific start and
-   * end dates (`dateStart` and `dateEnd` parameters).
+   * Filters results by relative date range ending at the current time, with each
+   * value producing a separate series. Use `<n>d` for days (up to `364d`) or `<n>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<string>;
 
   /**
-   * Start of the date range.
+   * 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<string>;
 
@@ -578,7 +594,8 @@ export interface AS112SummaryV2Params {
   /**
    * Limits the number of objects per group to the top items within the specified
    * time range. When item count exceeds the limit, extra items appear grouped under
-   * an "other" category.
+   * an "other" category. Only supported on high-cardinality dimensions; otherwise
+   * the request is rejected. Minimum value is 2.
    */
   limitPerGroup?: number;
 
@@ -725,6 +742,9 @@ export interface AS112TimeseriesParams {
    * Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals).
    * Refer to
    * [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).
+   * When omitted, the interval is auto-selected from the requested date range; finer
+   * intervals are only available for shorter ranges. If the requested interval is
+   * too granular for the date range, the request is rejected.
    */
   aggInterval?: '15m' | '1h' | '1d' | '1w';
 
@@ -736,19 +756,35 @@ export interface AS112TimeseriesParams {
   continent?: Array<string>;
 
   /**
-   * End of the date range (inclusive).
+   * 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<string>;
 
   /**
-   * Filters results by date range. For example, use `7d` and `7dcontrol` to compare
-   * this week with the previous week. Use this parameter or set specific start and
-   * end dates (`dateStart` and `dateEnd` parameters).
+   * Filters results by relative date range ending at the current time, with each
+   * value producing a separate series. Use `<n>d` for days (up to `364d`) or `<n>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<string>;
 
   /**
-   * Start of the date range.
+   * 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<string>;
 
@@ -900,6 +936,9 @@ export interface AS112TimeseriesGroupsV2Params {
    * Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals).
    * Refer to
    * [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/).
+   * When omitted, the interval is auto-selected from the requested date range; finer
+   * intervals are only available for shorter ranges. If the requested interval is
+   * too granular for the date range, the request is rejected.
    */
   aggInterval?: '15m' | '1h' | '1d' | '1w';
 
@@ -911,19 +950,35 @@ export interface AS112TimeseriesGroupsV2Params {
   continent?: Array<string>;
 
   /**
-   * End of the date range (inclusive).
+   * 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<string>;
 
   /**
-   * Filters results by date range. For example, use `7d` and `7dcontrol` to compare
-   * this week with the previous week. Use this parameter or set specific start and
-   * end dates (`dateStart` and `dateEnd` parameters).
+   * Filters results by relative date range ending at the current time, with each
+   * value producing a separate series. Use `<n>d` for days (up to `364d`) or `<n>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<string>;
 
   /**
-   * Start of the date range.
+   * 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<string>;
 
@@ -935,7 +990,8 @@ export interface AS112TimeseriesGroupsV2Params {
   /**
    * Limits the number of objects per group to the top items within the specified
    * time range. When item count exceeds the limit, extra items appear grouped under
-   * an "other" category.
+   * an "other" category. Only supported on high-cardinality dimensions; otherwise
+   * the request is rejected. Minimum value is 2.
    */
   limitPerGroup?: number;
 

package/src/resources/radar/as112/summary.ts

@@ -958,19 +958,35 @@ export interface SummaryDNSSECParams {
   continent?: Array<string>;
 
   /**
-   * End of the date range (inclusive).
+   * 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<string>;
 
   /**
-   * Filters results by date range. For example, use `7d` and `7dcontrol` to compare
-   * this week with the previous week. Use this parameter or set specific start and
-   * end dates (`dateStart` and `dateEnd` parameters).
+   * Filters results by relative date range ending at the current time, with each
+   * value producing a separate series. Use `<n>d` for days (up to `364d`) or `<n>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<string>;
 
   /**
-   * Start of the date range.
+   * 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<string>;
 
@@ -1126,19 +1142,35 @@ export interface SummaryEdnsParams {
   continent?: Array<string>;
 
   /**
-   * End of the date range (inclusive).
+   * 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<string>;
 
   /**
-   * Filters results by date range. For example, use `7d` and `7dcontrol` to compare
-   * this week with the previous week. Use this parameter or set specific start and
-   * end dates (`dateStart` and `dateEnd` parameters).
+   * Filters results by relative date range ending at the current time, with each
+   * value producing a separate series. Use `<n>d` for days (up to `364d`) or `<n>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<string>;
 
   /**
-   * Start of the date range.
+   * 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<string>;
 
@@ -1294,19 +1326,35 @@ export interface SummaryIPVersionParams {
   continent?: Array<string>;
 
   /**
-   * End of the date range (inclusive).
+   * 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<string>;
 
   /**
-   * Filters results by date range. For example, use `7d` and `7dcontrol` to compare
-   * this week with the previous week. Use this parameter or set specific start and
-   * end dates (`dateStart` and `dateEnd` parameters).
+   * Filters results by relative date range ending at the current time, with each
+   * value producing a separate series. Use `<n>d` for days (up to `364d`) or `<n>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<string>;
 
   /**
-   * Start of the date range.
+   * 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<string>;
 
@@ -1462,19 +1510,35 @@ export interface SummaryProtocolParams {
   continent?: Array<string>;
 
   /**
-   * End of the date range (inclusive).
+   * 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<string>;
 
   /**
-   * Filters results by date range. For example, use `7d` and `7dcontrol` to compare
-   * this week with the previous week. Use this parameter or set specific start and
-   * end dates (`dateStart` and `dateEnd` parameters).
+   * Filters results by relative date range ending at the current time, with each
+   * value producing a separate series. Use `<n>d` for days (up to `364d`) or `<n>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<string>;
 
   /**
-   * Start of the date range.
+   * 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<string>;
 
@@ -1625,19 +1689,35 @@ export interface SummaryQueryTypeParams {
   continent?: Array<string>;
 
   /**
-   * End of the date range (inclusive).
+   * 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<string>;
 
   /**
-   * Filters results by date range. For example, use `7d` and `7dcontrol` to compare
-   * this week with the previous week. Use this parameter or set specific start and
-   * end dates (`dateStart` and `dateEnd` parameters).
+   * Filters results by relative date range ending at the current time, with each
+   * value producing a separate series. Use `<n>d` for days (up to `364d`) or `<n>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<string>;
 
   /**
-   * Start of the date range.
+   * 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<string>;
 
@@ -1649,7 +1729,8 @@ export interface SummaryQueryTypeParams {
   /**
    * Limits the number of objects per group to the top items within the specified
    * time range. When item count exceeds the limit, extra items appear grouped under
-   * an "other" category.
+   * an "other" category. Only supported on high-cardinality dimensions; otherwise
+   * the request is rejected. Minimum value is 2.
    */
   limitPerGroup?: number;
 
@@ -1705,19 +1786,35 @@ export interface SummaryResponseCodesParams {
   continent?: Array<string>;
 
   /**
-   * End of the date range (inclusive).
+   * 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<string>;
 
   /**
-   * Filters results by date range. For example, use `7d` and `7dcontrol` to compare
-   * this week with the previous week. Use this parameter or set specific start and
-   * end dates (`dateStart` and `dateEnd` parameters).
+   * Filters results by relative date range ending at the current time, with each
+   * value producing a separate series. Use `<n>d` for days (up to `364d`) or `<n>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<string>;
 
   /**
-   * Start of the date range.
+   * 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<string>;
 
@@ -1729,7 +1826,8 @@ export interface SummaryResponseCodesParams {
   /**
    * Limits the number of objects per group to the top items within the specified
    * time range. When item count exceeds the limit, extra items appear grouped under
-   * an "other" category.
+   * an "other" category. Only supported on high-cardinality dimensions; otherwise
+   * the request is rejected. Minimum value is 2.
    */
   limitPerGroup?: number;