cloudflare 4.3.0 → 4.4.1

package/resources/radar/http/summary.d.ts

@@ -94,351 +94,654 @@ export declare class Summary extends APIResource {
     tlsVersion(options?: Core.RequestOptions): Core.APIPromise<SummaryTLSVersionResponse>;
 }
 export interface SummaryBotClassResponse {
+    /**
+     * Metadata for the results.
+     */
     meta: SummaryBotClassResponse.Meta;
     summary_0: SummaryBotClassResponse.Summary0;
 }
 export declare namespace SummaryBotClassResponse {
+    /**
+     * Metadata for the results.
+     */
     interface Meta {
+        confidenceInfo: Meta.ConfidenceInfo | null;
         dateRange: Array<Meta.DateRange>;
+        /**
+         * Timestamp of the last dataset update.
+         */
         lastUpdated: string;
-        normalization: string;
-        confidenceInfo?: Meta.ConfidenceInfo;
+        /**
+         * Normalization method applied to the results. Refer to
+         * [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).
+         */
+        normalization: 'PERCENTAGE' | 'MIN0_MAX' | 'MIN_MAX' | 'RAW_VALUES' | 'PERCENTAGE_CHANGE' | 'ROLLING_AVERAGE' | 'OVERLAPPED_PERCENTAGE' | 'RATIO';
+        /**
+         * Measurement units for the results.
+         */
+        units: Array<Meta.Unit>;
     }
     namespace Meta {
-        interface DateRange {
-            /**
-             * Adjusted end of date range.
-             */
-            endTime: string;
+        interface ConfidenceInfo {
+            annotations: Array<ConfidenceInfo.Annotation>;
             /**
-             * Adjusted start of date range.
+             * Provides an indication of how much confidence Cloudflare has in the data.
              */
-            startTime: string;
-        }
-        interface ConfidenceInfo {
-            annotations?: Array<ConfidenceInfo.Annotation>;
-            level?: number;
+            level: number;
         }
         namespace ConfidenceInfo {
+            /**
+             * Annotation associated with the result (e.g. outage or other type of event).
+             */
             interface Annotation {
                 dataSource: string;
                 description: string;
+                endDate: string;
                 eventType: string;
+                /**
+                 * Whether event is a single point in time or a time range.
+                 */
                 isInstantaneous: boolean;
-                endTime?: string;
-                linkedUrl?: string;
-                startTime?: string;
+                linkedUrl: string;
+                startDate: string;
             }
         }
+        interface DateRange {
+            /**
+             * Adjusted end of date range.
+             */
+            endTime: string;
+            /**
+             * Adjusted start of date range.
+             */
+            startTime: string;
+        }
+        interface Unit {
+            name: string;
+            value: string;
+        }
     }
     interface Summary0 {
+        /**
+         * A numeric string.
+         */
         bot: string;
+        /**
+         * A numeric string.
+         */
         human: string;
     }
 }
 export interface SummaryDeviceTypeResponse {
+    /**
+     * Metadata for the results.
+     */
     meta: SummaryDeviceTypeResponse.Meta;
     summary_0: SummaryDeviceTypeResponse.Summary0;
 }
 export declare namespace SummaryDeviceTypeResponse {
+    /**
+     * Metadata for the results.
+     */
     interface Meta {
+        confidenceInfo: Meta.ConfidenceInfo | null;
         dateRange: Array<Meta.DateRange>;
+        /**
+         * Timestamp of the last dataset update.
+         */
         lastUpdated: string;
-        normalization: string;
-        confidenceInfo?: Meta.ConfidenceInfo;
+        /**
+         * Normalization method applied to the results. Refer to
+         * [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).
+         */
+        normalization: 'PERCENTAGE' | 'MIN0_MAX' | 'MIN_MAX' | 'RAW_VALUES' | 'PERCENTAGE_CHANGE' | 'ROLLING_AVERAGE' | 'OVERLAPPED_PERCENTAGE' | 'RATIO';
+        /**
+         * Measurement units for the results.
+         */
+        units: Array<Meta.Unit>;
     }
     namespace Meta {
-        interface DateRange {
-            /**
-             * Adjusted end of date range.
-             */
-            endTime: string;
+        interface ConfidenceInfo {
+            annotations: Array<ConfidenceInfo.Annotation>;
             /**
-             * Adjusted start of date range.
+             * Provides an indication of how much confidence Cloudflare has in the data.
              */
-            startTime: string;
-        }
-        interface ConfidenceInfo {
-            annotations?: Array<ConfidenceInfo.Annotation>;
-            level?: number;
+            level: number;
         }
         namespace ConfidenceInfo {
+            /**
+             * Annotation associated with the result (e.g. outage or other type of event).
+             */
             interface Annotation {
                 dataSource: string;
                 description: string;
+                endDate: string;
                 eventType: string;
+                /**
+                 * Whether event is a single point in time or a time range.
+                 */
                 isInstantaneous: boolean;
-                endTime?: string;
-                linkedUrl?: string;
-                startTime?: string;
+                linkedUrl: string;
+                startDate: string;
             }
         }
+        interface DateRange {
+            /**
+             * Adjusted end of date range.
+             */
+            endTime: string;
+            /**
+             * Adjusted start of date range.
+             */
+            startTime: string;
+        }
+        interface Unit {
+            name: string;
+            value: string;
+        }
     }
     interface Summary0 {
+        /**
+         * A numeric string.
+         */
         desktop: string;
+        /**
+         * A numeric string.
+         */
         mobile: string;
+        /**
+         * A numeric string.
+         */
         other: string;
     }
 }
 export interface SummaryHTTPProtocolResponse {
+    /**
+     * Metadata for the results.
+     */
     meta: SummaryHTTPProtocolResponse.Meta;
     summary_0: SummaryHTTPProtocolResponse.Summary0;
 }
 export declare namespace SummaryHTTPProtocolResponse {
+    /**
+     * Metadata for the results.
+     */
     interface Meta {
+        confidenceInfo: Meta.ConfidenceInfo | null;
         dateRange: Array<Meta.DateRange>;
+        /**
+         * Timestamp of the last dataset update.
+         */
         lastUpdated: string;
-        normalization: string;
-        confidenceInfo?: Meta.ConfidenceInfo;
+        /**
+         * Normalization method applied to the results. Refer to
+         * [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).
+         */
+        normalization: 'PERCENTAGE' | 'MIN0_MAX' | 'MIN_MAX' | 'RAW_VALUES' | 'PERCENTAGE_CHANGE' | 'ROLLING_AVERAGE' | 'OVERLAPPED_PERCENTAGE' | 'RATIO';
+        /**
+         * Measurement units for the results.
+         */
+        units: Array<Meta.Unit>;
     }
     namespace Meta {
-        interface DateRange {
-            /**
-             * Adjusted end of date range.
-             */
-            endTime: string;
+        interface ConfidenceInfo {
+            annotations: Array<ConfidenceInfo.Annotation>;
             /**
-             * Adjusted start of date range.
+             * Provides an indication of how much confidence Cloudflare has in the data.
              */
-            startTime: string;
-        }
-        interface ConfidenceInfo {
-            annotations?: Array<ConfidenceInfo.Annotation>;
-            level?: number;
+            level: number;
         }
         namespace ConfidenceInfo {
+            /**
+             * Annotation associated with the result (e.g. outage or other type of event).
+             */
             interface Annotation {
                 dataSource: string;
                 description: string;
+                endDate: string;
                 eventType: string;
+                /**
+                 * Whether event is a single point in time or a time range.
+                 */
                 isInstantaneous: boolean;
-                endTime?: string;
-                linkedUrl?: string;
-                startTime?: string;
+                linkedUrl: string;
+                startDate: string;
             }
         }
+        interface DateRange {
+            /**
+             * Adjusted end of date range.
+             */
+            endTime: string;
+            /**
+             * Adjusted start of date range.
+             */
+            startTime: string;
+        }
+        interface Unit {
+            name: string;
+            value: string;
+        }
     }
     interface Summary0 {
+        /**
+         * A numeric string.
+         */
         http: string;
+        /**
+         * A numeric string.
+         */
         https: string;
     }
 }
 export interface SummaryHTTPVersionResponse {
+    /**
+     * Metadata for the results.
+     */
     meta: SummaryHTTPVersionResponse.Meta;
     summary_0: SummaryHTTPVersionResponse.Summary0;
 }
 export declare namespace SummaryHTTPVersionResponse {
+    /**
+     * Metadata for the results.
+     */
     interface Meta {
+        confidenceInfo: Meta.ConfidenceInfo | null;
         dateRange: Array<Meta.DateRange>;
+        /**
+         * Timestamp of the last dataset update.
+         */
         lastUpdated: string;
-        normalization: string;
-        confidenceInfo?: Meta.ConfidenceInfo;
+        /**
+         * Normalization method applied to the results. Refer to
+         * [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).
+         */
+        normalization: 'PERCENTAGE' | 'MIN0_MAX' | 'MIN_MAX' | 'RAW_VALUES' | 'PERCENTAGE_CHANGE' | 'ROLLING_AVERAGE' | 'OVERLAPPED_PERCENTAGE' | 'RATIO';
+        /**
+         * Measurement units for the results.
+         */
+        units: Array<Meta.Unit>;
     }
     namespace Meta {
-        interface DateRange {
-            /**
-             * Adjusted end of date range.
-             */
-            endTime: string;
+        interface ConfidenceInfo {
+            annotations: Array<ConfidenceInfo.Annotation>;
             /**
-             * Adjusted start of date range.
+             * Provides an indication of how much confidence Cloudflare has in the data.
              */
-            startTime: string;
-        }
-        interface ConfidenceInfo {
-            annotations?: Array<ConfidenceInfo.Annotation>;
-            level?: number;
+            level: number;
         }
         namespace ConfidenceInfo {
+            /**
+             * Annotation associated with the result (e.g. outage or other type of event).
+             */
             interface Annotation {
                 dataSource: string;
                 description: string;
+                endDate: string;
                 eventType: string;
+                /**
+                 * Whether event is a single point in time or a time range.
+                 */
                 isInstantaneous: boolean;
-                endTime?: string;
-                linkedUrl?: string;
-                startTime?: string;
+                linkedUrl: string;
+                startDate: string;
             }
         }
+        interface DateRange {
+            /**
+             * Adjusted end of date range.
+             */
+            endTime: string;
+            /**
+             * Adjusted start of date range.
+             */
+            startTime: string;
+        }
+        interface Unit {
+            name: string;
+            value: string;
+        }
     }
     interface Summary0 {
+        /**
+         * A numeric string.
+         */
         'HTTP/1.x': string;
+        /**
+         * A numeric string.
+         */
         'HTTP/2': string;
+        /**
+         * A numeric string.
+         */
         'HTTP/3': string;
     }
 }
 export interface SummaryIPVersionResponse {
+    /**
+     * Metadata for the results.
+     */
     meta: SummaryIPVersionResponse.Meta;
     summary_0: SummaryIPVersionResponse.Summary0;
 }
 export declare namespace SummaryIPVersionResponse {
+    /**
+     * Metadata for the results.
+     */
     interface Meta {
+        confidenceInfo: Meta.ConfidenceInfo | null;
         dateRange: Array<Meta.DateRange>;
+        /**
+         * Timestamp of the last dataset update.
+         */
         lastUpdated: string;
-        normalization: string;
-        confidenceInfo?: Meta.ConfidenceInfo;
+        /**
+         * Normalization method applied to the results. Refer to
+         * [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).
+         */
+        normalization: 'PERCENTAGE' | 'MIN0_MAX' | 'MIN_MAX' | 'RAW_VALUES' | 'PERCENTAGE_CHANGE' | 'ROLLING_AVERAGE' | 'OVERLAPPED_PERCENTAGE' | 'RATIO';
+        /**
+         * Measurement units for the results.
+         */
+        units: Array<Meta.Unit>;
     }
     namespace Meta {
-        interface DateRange {
-            /**
-             * Adjusted end of date range.
-             */
-            endTime: string;
+        interface ConfidenceInfo {
+            annotations: Array<ConfidenceInfo.Annotation>;
             /**
-             * Adjusted start of date range.
+             * Provides an indication of how much confidence Cloudflare has in the data.
              */
-            startTime: string;
-        }
-        interface ConfidenceInfo {
-            annotations?: Array<ConfidenceInfo.Annotation>;
-            level?: number;
+            level: number;
         }
         namespace ConfidenceInfo {
+            /**
+             * Annotation associated with the result (e.g. outage or other type of event).
+             */
             interface Annotation {
                 dataSource: string;
                 description: string;
+                endDate: string;
                 eventType: string;
+                /**
+                 * Whether event is a single point in time or a time range.
+                 */
                 isInstantaneous: boolean;
-                endTime?: string;
-                linkedUrl?: string;
-                startTime?: string;
+                linkedUrl: string;
+                startDate: string;
             }
         }
+        interface DateRange {
+            /**
+             * Adjusted end of date range.
+             */
+            endTime: string;
+            /**
+             * Adjusted start of date range.
+             */
+            startTime: string;
+        }
+        interface Unit {
+            name: string;
+            value: string;
+        }
     }
     interface Summary0 {
+        /**
+         * A numeric string.
+         */
         IPv4: string;
+        /**
+         * A numeric string.
+         */
         IPv6: string;
     }
 }
 export interface SummaryOSResponse {
+    /**
+     * Metadata for the results.
+     */
     meta: SummaryOSResponse.Meta;
     summary_0: SummaryOSResponse.Summary0;
 }
 export declare namespace SummaryOSResponse {
+    /**
+     * Metadata for the results.
+     */
     interface Meta {
+        confidenceInfo: Meta.ConfidenceInfo | null;
         dateRange: Array<Meta.DateRange>;
+        /**
+         * Timestamp of the last dataset update.
+         */
         lastUpdated: string;
-        normalization: string;
-        confidenceInfo?: Meta.ConfidenceInfo;
+        /**
+         * Normalization method applied to the results. Refer to
+         * [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).
+         */
+        normalization: 'PERCENTAGE' | 'MIN0_MAX' | 'MIN_MAX' | 'RAW_VALUES' | 'PERCENTAGE_CHANGE' | 'ROLLING_AVERAGE' | 'OVERLAPPED_PERCENTAGE' | 'RATIO';
+        /**
+         * Measurement units for the results.
+         */
+        units: Array<Meta.Unit>;
     }
     namespace Meta {
-        interface DateRange {
-            /**
-             * Adjusted end of date range.
-             */
-            endTime: string;
+        interface ConfidenceInfo {
+            annotations: Array<ConfidenceInfo.Annotation>;
             /**
-             * Adjusted start of date range.
+             * Provides an indication of how much confidence Cloudflare has in the data.
              */
-            startTime: string;
-        }
-        interface ConfidenceInfo {
-            annotations?: Array<ConfidenceInfo.Annotation>;
-            level?: number;
+            level: number;
         }
         namespace ConfidenceInfo {
+            /**
+             * Annotation associated with the result (e.g. outage or other type of event).
+             */
             interface Annotation {
                 dataSource: string;
                 description: string;
+                endDate: string;
                 eventType: string;
+                /**
+                 * Whether event is a single point in time or a time range.
+                 */
                 isInstantaneous: boolean;
-                endTime?: string;
-                linkedUrl?: string;
-                startTime?: string;
+                linkedUrl: string;
+                startDate: string;
             }
         }
+        interface DateRange {
+            /**
+             * Adjusted end of date range.
+             */
+            endTime: string;
+            /**
+             * Adjusted start of date range.
+             */
+            startTime: string;
+        }
+        interface Unit {
+            name: string;
+            value: string;
+        }
     }
     interface Summary0 {
+        /**
+         * A numeric string.
+         */
         ANDROID: string;
+        /**
+         * A numeric string.
+         */
         IOS: string;
     }
 }
 export interface SummaryPostQuantumResponse {
+    /**
+     * Metadata for the results.
+     */
     meta: SummaryPostQuantumResponse.Meta;
     summary_0: SummaryPostQuantumResponse.Summary0;
 }
 export declare namespace SummaryPostQuantumResponse {
+    /**
+     * Metadata for the results.
+     */
     interface Meta {
+        confidenceInfo: Meta.ConfidenceInfo | null;
         dateRange: Array<Meta.DateRange>;
+        /**
+         * Timestamp of the last dataset update.
+         */
         lastUpdated: string;
-        normalization: string;
-        confidenceInfo?: Meta.ConfidenceInfo;
+        /**
+         * Normalization method applied to the results. Refer to
+         * [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).
+         */
+        normalization: 'PERCENTAGE' | 'MIN0_MAX' | 'MIN_MAX' | 'RAW_VALUES' | 'PERCENTAGE_CHANGE' | 'ROLLING_AVERAGE' | 'OVERLAPPED_PERCENTAGE' | 'RATIO';
+        /**
+         * Measurement units for the results.
+         */
+        units: Array<Meta.Unit>;
     }
     namespace Meta {
-        interface DateRange {
-            /**
-             * Adjusted end of date range.
-             */
-            endTime: string;
+        interface ConfidenceInfo {
+            annotations: Array<ConfidenceInfo.Annotation>;
             /**
-             * Adjusted start of date range.
+             * Provides an indication of how much confidence Cloudflare has in the data.
              */
-            startTime: string;
-        }
-        interface ConfidenceInfo {
-            annotations?: Array<ConfidenceInfo.Annotation>;
-            level?: number;
+            level: number;
         }
         namespace ConfidenceInfo {
+            /**
+             * Annotation associated with the result (e.g. outage or other type of event).
+             */
             interface Annotation {
                 dataSource: string;
                 description: string;
+                endDate: string;
                 eventType: string;
+                /**
+                 * Whether event is a single point in time or a time range.
+                 */
                 isInstantaneous: boolean;
-                endTime?: string;
-                linkedUrl?: string;
-                startTime?: string;
+                linkedUrl: string;
+                startDate: string;
             }
         }
+        interface DateRange {
+            /**
+             * Adjusted end of date range.
+             */
+            endTime: string;
+            /**
+             * Adjusted start of date range.
+             */
+            startTime: string;
+        }
+        interface Unit {
+            name: string;
+            value: string;
+        }
     }
     interface Summary0 {
+        /**
+         * A numeric string.
+         */
         NOT_SUPPORTED: string;
+        /**
+         * A numeric string.
+         */
         SUPPORTED: string;
     }
 }
 export interface SummaryTLSVersionResponse {
+    /**
+     * Metadata for the results.
+     */
     meta: SummaryTLSVersionResponse.Meta;
     summary_0: SummaryTLSVersionResponse.Summary0;
 }
 export declare namespace SummaryTLSVersionResponse {
+    /**
+     * Metadata for the results.
+     */
     interface Meta {
+        confidenceInfo: Meta.ConfidenceInfo | null;
         dateRange: Array<Meta.DateRange>;
+        /**
+         * Timestamp of the last dataset update.
+         */
         lastUpdated: string;
-        normalization: string;
-        confidenceInfo?: Meta.ConfidenceInfo;
+        /**
+         * Normalization method applied to the results. Refer to
+         * [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).
+         */
+        normalization: 'PERCENTAGE' | 'MIN0_MAX' | 'MIN_MAX' | 'RAW_VALUES' | 'PERCENTAGE_CHANGE' | 'ROLLING_AVERAGE' | 'OVERLAPPED_PERCENTAGE' | 'RATIO';
+        /**
+         * Measurement units for the results.
+         */
+        units: Array<Meta.Unit>;
     }
     namespace Meta {
-        interface DateRange {
-            /**
-             * Adjusted end of date range.
-             */
-            endTime: string;
+        interface ConfidenceInfo {
+            annotations: Array<ConfidenceInfo.Annotation>;
             /**
-             * Adjusted start of date range.
+             * Provides an indication of how much confidence Cloudflare has in the data.
              */
-            startTime: string;
-        }
-        interface ConfidenceInfo {
-            annotations?: Array<ConfidenceInfo.Annotation>;
-            level?: number;
+            level: number;
         }
         namespace ConfidenceInfo {
+            /**
+             * Annotation associated with the result (e.g. outage or other type of event).
+             */
             interface Annotation {
                 dataSource: string;
                 description: string;
+                endDate: string;
                 eventType: string;
+                /**
+                 * Whether event is a single point in time or a time range.
+                 */
                 isInstantaneous: boolean;
-                endTime?: string;
-                linkedUrl?: string;
-                startTime?: string;
+                linkedUrl: string;
+                startDate: string;
             }
         }
+        interface DateRange {
+            /**
+             * Adjusted end of date range.
+             */
+            endTime: string;
+            /**
+             * Adjusted start of date range.
+             */
+            startTime: string;
+        }
+        interface Unit {
+            name: string;
+            value: string;
+        }
     }
     interface Summary0 {
+        /**
+         * A numeric string.
+         */
         'TLS 1.0': string;
+        /**
+         * A numeric string.
+         */
         'TLS 1.1': string;
+        /**
+         * A numeric string.
+         */
         'TLS 1.2': string;
+        /**
+         * A numeric string.
+         */
         'TLS 1.3': string;
+        /**
+         * A numeric string.
+         */
         'TLS QUIC': string;
     }
 }