cloudflare 7.0.0 → 7.1.0

package/src/resources/magic-transit/cf-interconnects.ts

@@ -167,6 +167,8 @@ export namespace CfInterconnectUpdateResponse {
      */
     automatic_return_routing?: boolean;
 
+    bgp?: ModifiedInterconnect.BGP;
+
     /**
      * The name of the interconnect. The name cannot share a name with other tunnels.
      */
@@ -190,9 +192,11 @@ export namespace CfInterconnectUpdateResponse {
     health_check?: MagicTransitAPI.HealthCheck;
 
     /**
-     * A 31-bit prefix (/31 in CIDR notation) supporting two hosts, one for each side
-     * of the tunnel. Select the subnet from the following private IP space:
-     * 10.0.0.0–10.255.255.255, 172.16.0.0–172.31.255.255, 192.168.0.0–192.168.255.255.
+     * The IPv4 interface address for the interconnect. For MPLS Interconnects, use a
+     * /30 or /31 prefix. For GRE Interconnects, a /29, /30, or /31 prefix may be used.
+     * A /29 prefix is only allowed for v1.5 interconnects, and the address must be the
+     * .3 host of the subnet (the fourth address overall; the network address is not
+     * usable). Select the subnet from RFC 1918 or the approved link-local ranges.
      */
     interface_address?: string;
 
@@ -220,6 +224,15 @@ export namespace CfInterconnectUpdateResponse {
      */
     name?: string;
 
+    /**
+     * Immutable interconnect version configured at creation time. One of:
+     *
+     * - "1"
+     * - "1.5"
+     * - "2"
+     */
+    version?: string;
+
     /**
      * An identifier that correlates this interconnect with the corresponding V2 CNI
      * interconnect resource.
@@ -228,6 +241,66 @@ export namespace CfInterconnectUpdateResponse {
   }
 
   export namespace ModifiedInterconnect {
+    export interface BGP {
+      /**
+       * @deprecated Deprecated. Use customer_asn.
+       */
+      as_no?: number;
+
+      /**
+       * @deprecated Read-only for v1.5; derived from interface_address.
+       */
+      cloudflare_endpoint?: string;
+
+      /**
+       * ASN used on the customer end of the BGP session.
+       */
+      customer_asn?: number;
+
+      /**
+       * @deprecated Read-only for v1.5; derived from interface_address.
+       */
+      customer_endpoint?: string;
+
+      /**
+       * ID of the BGP filter profile applied to routes advertised to the customer.
+       */
+      export_filter_id?: string;
+
+      /**
+       * Prefixes in this list will be advertised to the customer device, in addition to
+       * the routes in the Magic routing table.
+       */
+      extra_prefixes?: Array<string>;
+
+      /**
+       * ID of the BGP filter profile applied to routes received from the customer.
+       */
+      import_filter_id?: string;
+
+      /**
+       * MD5 key to use for session authentication.
+       *
+       * Note that _this is not a security measure_. MD5 is not a valid security
+       * mechanism, and the key is not treated as a secret value. This is _only_
+       * supported for preventing misconfiguration, not for defending against malicious
+       * attacks.
+       *
+       * The MD5 key, if set, must be of non-zero length and consist only of the
+       * following types of character:
+       *
+       * - ASCII alphanumerics: `[a-zA-Z0-9]`
+       * - Special characters in the set `'!@#$%^&*()+[]{}<>/.,;:_-~`= \|`
+       *
+       * In other words, MD5 keys may contain any printable ASCII character aside from
+       * newline (0x0A), quotation mark (`"`), vertical tab (0x0B), carriage return
+       * (0x0D), tab (0x09), form feed (0x0C), and the question mark (`?`). Requests
+       * specifying an MD5 key with one or more of these disallowed characters will be
+       * rejected.
+       */
+      md5_key?: string;
+    }
+
     /**
      * The configuration specific to GRE interconnects.
      */
@@ -259,6 +332,8 @@ export namespace CfInterconnectListResponse {
      */
     automatic_return_routing?: boolean;
 
+    bgp?: Interconnect.BGP;
+
     /**
      * The name of the interconnect. The name cannot share a name with other tunnels.
      */
@@ -282,9 +357,11 @@ export namespace CfInterconnectListResponse {
     health_check?: MagicTransitAPI.HealthCheck;
 
     /**
-     * A 31-bit prefix (/31 in CIDR notation) supporting two hosts, one for each side
-     * of the tunnel. Select the subnet from the following private IP space:
-     * 10.0.0.0–10.255.255.255, 172.16.0.0–172.31.255.255, 192.168.0.0–192.168.255.255.
+     * The IPv4 interface address for the interconnect. For MPLS Interconnects, use a
+     * /30 or /31 prefix. For GRE Interconnects, a /29, /30, or /31 prefix may be used.
+     * A /29 prefix is only allowed for v1.5 interconnects, and the address must be the
+     * .3 host of the subnet (the fourth address overall; the network address is not
+     * usable). Select the subnet from RFC 1918 or the approved link-local ranges.
      */
     interface_address?: string;
 
@@ -312,6 +389,15 @@ export namespace CfInterconnectListResponse {
      */
     name?: string;
 
+    /**
+     * Immutable interconnect version configured at creation time. One of:
+     *
+     * - "1"
+     * - "1.5"
+     * - "2"
+     */
+    version?: string;
+
     /**
      * An identifier that correlates this interconnect with the corresponding V2 CNI
      * interconnect resource.
@@ -320,6 +406,66 @@ export namespace CfInterconnectListResponse {
   }
 
   export namespace Interconnect {
+    export interface BGP {
+      /**
+       * @deprecated Deprecated. Use customer_asn.
+       */
+      as_no?: number;
+
+      /**
+       * @deprecated Read-only for v1.5; derived from interface_address.
+       */
+      cloudflare_endpoint?: string;
+
+      /**
+       * ASN used on the customer end of the BGP session.
+       */
+      customer_asn?: number;
+
+      /**
+       * @deprecated Read-only for v1.5; derived from interface_address.
+       */
+      customer_endpoint?: string;
+
+      /**
+       * ID of the BGP filter profile applied to routes advertised to the customer.
+       */
+      export_filter_id?: string;
+
+      /**
+       * Prefixes in this list will be advertised to the customer device, in addition to
+       * the routes in the Magic routing table.
+       */
+      extra_prefixes?: Array<string>;
+
+      /**
+       * ID of the BGP filter profile applied to routes received from the customer.
+       */
+      import_filter_id?: string;
+
+      /**
+       * MD5 key to use for session authentication.
+       *
+       * Note that _this is not a security measure_. MD5 is not a valid security
+       * mechanism, and the key is not treated as a secret value. This is _only_
+       * supported for preventing misconfiguration, not for defending against malicious
+       * attacks.
+       *
+       * The MD5 key, if set, must be of non-zero length and consist only of the
+       * following types of character:
+       *
+       * - ASCII alphanumerics: `[a-zA-Z0-9]`
+       * - Special characters in the set `'!@#$%^&*()+[]{}<>/.,;:_-~`= \|`
+       *
+       * In other words, MD5 keys may contain any printable ASCII character aside from
+       * newline (0x0A), quotation mark (`"`), vertical tab (0x0B), carriage return
+       * (0x0D), tab (0x09), form feed (0x0C), and the question mark (`?`). Requests
+       * specifying an MD5 key with one or more of these disallowed characters will be
+       * rejected.
+       */
+      md5_key?: string;
+    }
+
     /**
      * The configuration specific to GRE interconnects.
      */
@@ -353,6 +499,8 @@ export namespace CfInterconnectBulkUpdateResponse {
      */
     automatic_return_routing?: boolean;
 
+    bgp?: ModifiedInterconnect.BGP;
+
     /**
      * The name of the interconnect. The name cannot share a name with other tunnels.
      */
@@ -376,9 +524,11 @@ export namespace CfInterconnectBulkUpdateResponse {
     health_check?: MagicTransitAPI.HealthCheck;
 
     /**
-     * A 31-bit prefix (/31 in CIDR notation) supporting two hosts, one for each side
-     * of the tunnel. Select the subnet from the following private IP space:
-     * 10.0.0.0–10.255.255.255, 172.16.0.0–172.31.255.255, 192.168.0.0–192.168.255.255.
+     * The IPv4 interface address for the interconnect. For MPLS Interconnects, use a
+     * /30 or /31 prefix. For GRE Interconnects, a /29, /30, or /31 prefix may be used.
+     * A /29 prefix is only allowed for v1.5 interconnects, and the address must be the
+     * .3 host of the subnet (the fourth address overall; the network address is not
+     * usable). Select the subnet from RFC 1918 or the approved link-local ranges.
      */
     interface_address?: string;
 
@@ -406,6 +556,15 @@ export namespace CfInterconnectBulkUpdateResponse {
      */
     name?: string;
 
+    /**
+     * Immutable interconnect version configured at creation time. One of:
+     *
+     * - "1"
+     * - "1.5"
+     * - "2"
+     */
+    version?: string;
+
     /**
      * An identifier that correlates this interconnect with the corresponding V2 CNI
      * interconnect resource.
@@ -414,6 +573,66 @@ export namespace CfInterconnectBulkUpdateResponse {
   }
 
   export namespace ModifiedInterconnect {
+    export interface BGP {
+      /**
+       * @deprecated Deprecated. Use customer_asn.
+       */
+      as_no?: number;
+
+      /**
+       * @deprecated Read-only for v1.5; derived from interface_address.
+       */
+      cloudflare_endpoint?: string;
+
+      /**
+       * ASN used on the customer end of the BGP session.
+       */
+      customer_asn?: number;
+
+      /**
+       * @deprecated Read-only for v1.5; derived from interface_address.
+       */
+      customer_endpoint?: string;
+
+      /**
+       * ID of the BGP filter profile applied to routes advertised to the customer.
+       */
+      export_filter_id?: string;
+
+      /**
+       * Prefixes in this list will be advertised to the customer device, in addition to
+       * the routes in the Magic routing table.
+       */
+      extra_prefixes?: Array<string>;
+
+      /**
+       * ID of the BGP filter profile applied to routes received from the customer.
+       */
+      import_filter_id?: string;
+
+      /**
+       * MD5 key to use for session authentication.
+       *
+       * Note that _this is not a security measure_. MD5 is not a valid security
+       * mechanism, and the key is not treated as a secret value. This is _only_
+       * supported for preventing misconfiguration, not for defending against malicious
+       * attacks.
+       *
+       * The MD5 key, if set, must be of non-zero length and consist only of the
+       * following types of character:
+       *
+       * - ASCII alphanumerics: `[a-zA-Z0-9]`
+       * - Special characters in the set `'!@#$%^&*()+[]{}<>/.,;:_-~`= \|`
+       *
+       * In other words, MD5 keys may contain any printable ASCII character aside from
+       * newline (0x0A), quotation mark (`"`), vertical tab (0x0B), carriage return
+       * (0x0D), tab (0x09), form feed (0x0C), and the question mark (`?`). Requests
+       * specifying an MD5 key with one or more of these disallowed characters will be
+       * rejected.
+       */
+      md5_key?: string;
+    }
+
     /**
      * The configuration specific to GRE interconnects.
      */
@@ -445,6 +664,8 @@ export namespace CfInterconnectGetResponse {
      */
     automatic_return_routing?: boolean;
 
+    bgp?: Interconnect.BGP;
+
     /**
      * The name of the interconnect. The name cannot share a name with other tunnels.
      */
@@ -468,9 +689,11 @@ export namespace CfInterconnectGetResponse {
     health_check?: MagicTransitAPI.HealthCheck;
 
     /**
-     * A 31-bit prefix (/31 in CIDR notation) supporting two hosts, one for each side
-     * of the tunnel. Select the subnet from the following private IP space:
-     * 10.0.0.0–10.255.255.255, 172.16.0.0–172.31.255.255, 192.168.0.0–192.168.255.255.
+     * The IPv4 interface address for the interconnect. For MPLS Interconnects, use a
+     * /30 or /31 prefix. For GRE Interconnects, a /29, /30, or /31 prefix may be used.
+     * A /29 prefix is only allowed for v1.5 interconnects, and the address must be the
+     * .3 host of the subnet (the fourth address overall; the network address is not
+     * usable). Select the subnet from RFC 1918 or the approved link-local ranges.
      */
     interface_address?: string;
 
@@ -498,6 +721,15 @@ export namespace CfInterconnectGetResponse {
      */
     name?: string;
 
+    /**
+     * Immutable interconnect version configured at creation time. One of:
+     *
+     * - "1"
+     * - "1.5"
+     * - "2"
+     */
+    version?: string;
+
     /**
      * An identifier that correlates this interconnect with the corresponding V2 CNI
      * interconnect resource.
@@ -506,6 +738,66 @@ export namespace CfInterconnectGetResponse {
   }
 
   export namespace Interconnect {
+    export interface BGP {
+      /**
+       * @deprecated Deprecated. Use customer_asn.
+       */
+      as_no?: number;
+
+      /**
+       * @deprecated Read-only for v1.5; derived from interface_address.
+       */
+      cloudflare_endpoint?: string;
+
+      /**
+       * ASN used on the customer end of the BGP session.
+       */
+      customer_asn?: number;
+
+      /**
+       * @deprecated Read-only for v1.5; derived from interface_address.
+       */
+      customer_endpoint?: string;
+
+      /**
+       * ID of the BGP filter profile applied to routes advertised to the customer.
+       */
+      export_filter_id?: string;
+
+      /**
+       * Prefixes in this list will be advertised to the customer device, in addition to
+       * the routes in the Magic routing table.
+       */
+      extra_prefixes?: Array<string>;
+
+      /**
+       * ID of the BGP filter profile applied to routes received from the customer.
+       */
+      import_filter_id?: string;
+
+      /**
+       * MD5 key to use for session authentication.
+       *
+       * Note that _this is not a security measure_. MD5 is not a valid security
+       * mechanism, and the key is not treated as a secret value. This is _only_
+       * supported for preventing misconfiguration, not for defending against malicious
+       * attacks.
+       *
+       * The MD5 key, if set, must be of non-zero length and consist only of the
+       * following types of character:
+       *
+       * - ASCII alphanumerics: `[a-zA-Z0-9]`
+       * - Special characters in the set `'!@#$%^&*()+[]{}<>/.,;:_-~`= \|`
+       *
+       * In other words, MD5 keys may contain any printable ASCII character aside from
+       * newline (0x0A), quotation mark (`"`), vertical tab (0x0B), carriage return
+       * (0x0D), tab (0x09), form feed (0x0C), and the question mark (`?`). Requests
+       * specifying an MD5 key with one or more of these disallowed characters will be
+       * rejected.
+       */
+      md5_key?: string;
+    }
+
     /**
      * The configuration specific to GRE interconnects.
      */
@@ -532,6 +824,11 @@ export interface CfInterconnectUpdateParams {
    */
   automatic_return_routing?: boolean;
 
+  /**
+   * Body param
+   */
+  bgp?: CfInterconnectUpdateParams.BGP;
+
   /**
    * Body param: An optional description of the interconnect.
    */
@@ -548,9 +845,12 @@ export interface CfInterconnectUpdateParams {
   health_check?: MagicTransitAPI.HealthCheckParam;
 
   /**
-   * Body param: A 31-bit prefix (/31 in CIDR notation) supporting two hosts, one for
-   * each side of the tunnel. Select the subnet from the following private IP space:
-   * 10.0.0.0–10.255.255.255, 172.16.0.0–172.31.255.255, 192.168.0.0–192.168.255.255.
+   * Body param: The IPv4 interface address for the interconnect. For MPLS
+   * Interconnects, use a /30 or /31 prefix. For GRE Interconnects, a /29, /30, or
+   * /31 prefix may be used. A /29 prefix is only allowed for v1.5 interconnects, and
+   * the address must be the .3 host of the subnet (the fourth address overall; the
+   * network address is not usable). Select the subnet from RFC 1918 or the approved
+   * link-local ranges.
    */
   interface_address?: string;
 
@@ -582,6 +882,66 @@ export interface CfInterconnectUpdateParams {
 }
 
 export namespace CfInterconnectUpdateParams {
+  export interface BGP {
+    /**
+     * @deprecated Deprecated. Use customer_asn.
+     */
+    as_no?: number;
+
+    /**
+     * @deprecated Read-only for v1.5; derived from interface_address.
+     */
+    cloudflare_endpoint?: string;
+
+    /**
+     * ASN used on the customer end of the BGP session.
+     */
+    customer_asn?: number;
+
+    /**
+     * @deprecated Read-only for v1.5; derived from interface_address.
+     */
+    customer_endpoint?: string;
+
+    /**
+     * ID of the BGP filter profile applied to routes advertised to the customer.
+     */
+    export_filter_id?: string;
+
+    /**
+     * Prefixes in this list will be advertised to the customer device, in addition to
+     * the routes in the Magic routing table.
+     */
+    extra_prefixes?: Array<string>;
+
+    /**
+     * ID of the BGP filter profile applied to routes received from the customer.
+     */
+    import_filter_id?: string;
+
+    /**
+     * MD5 key to use for session authentication.
+     *
+     * Note that _this is not a security measure_. MD5 is not a valid security
+     * mechanism, and the key is not treated as a secret value. This is _only_
+     * supported for preventing misconfiguration, not for defending against malicious
+     * attacks.
+     *
+     * The MD5 key, if set, must be of non-zero length and consist only of the
+     * following types of character:
+     *
+     * - ASCII alphanumerics: `[a-zA-Z0-9]`
+     * - Special characters in the set `'!@#$%^&*()+[]{}<>/.,;:_-~`= \|`
+     *
+     * In other words, MD5 keys may contain any printable ASCII character aside from
+     * newline (0x0A), quotation mark (`"`), vertical tab (0x0B), carriage return
+     * (0x0D), tab (0x09), form feed (0x0C), and the question mark (`?`). Requests
+     * specifying an MD5 key with one or more of these disallowed characters will be
+     * rejected.
+     */
+    md5_key?: string;
+  }
+
   /**
    * The configuration specific to GRE interconnects.
    */

package/src/resources/magic-transit/connectors/connectors.ts

@@ -1,6 +1,16 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../core/resource';
+import * as InterruptsAPI from './interrupts';
+import {
+  BaseInterrupts,
+  InterruptCreateParams,
+  InterruptCreateResponse,
+  InterruptListParams,
+  InterruptListResponse,
+  InterruptListResponsesSinglePage,
+  Interrupts,
+} from './interrupts';
 import * as EventsAPI from './events/events';
 import {
   BaseEvents,
@@ -31,7 +41,7 @@ export class BaseConnectors extends APIResource {
   ] as const);
 
   /**
-   * Add a connector to your account
+   * Creates a Magic WAN Connector.
    *
    * @example
    * ```ts
@@ -52,7 +62,8 @@ export class BaseConnectors extends APIResource {
   }
 
   /**
-   * Replace Connector or Re-provision License Key
+   * Updates properties of a Magic WAN Connector. May be used to re-provision a
+   * license key.
    *
    * @example
    * ```ts
@@ -78,7 +89,7 @@ export class BaseConnectors extends APIResource {
   }
 
   /**
-   * List Connectors
+   * Lists Magic WAN Connectors.
    *
    * @example
    * ```ts
@@ -103,7 +114,7 @@ export class BaseConnectors extends APIResource {
   }
 
   /**
-   * Remove a connector from your account
+   * Deletes a Magic WAN Connector.
    *
    * @example
    * ```ts
@@ -129,7 +140,8 @@ export class BaseConnectors extends APIResource {
   }
 
   /**
-   * Edit Connector to update specific properties or Re-provision License Key
+   * Edits properties of a Magic WAN Connector. May be used to re-provision a license
+   * key.
    *
    * @example
    * ```ts
@@ -154,7 +166,7 @@ export class BaseConnectors extends APIResource {
   }
 
   /**
-   * Fetch Connector
+   * Gets a Magic WAN Connector.
    *
    * @example
    * ```ts
@@ -178,6 +190,7 @@ export class BaseConnectors extends APIResource {
   }
 }
 export class Connectors extends BaseConnectors {
+  interrupts: InterruptsAPI.Interrupts = new InterruptsAPI.Interrupts(this._client);
   events: EventsAPI.Events = new EventsAPI.Events(this._client);
   snapshots: SnapshotsAPI.Snapshots = new SnapshotsAPI.Snapshots(this._client);
 }
@@ -704,6 +717,8 @@ export interface ConnectorGetParams {
   account_id: string;
 }
 
+Connectors.Interrupts = Interrupts;
+Connectors.BaseInterrupts = BaseInterrupts;
 Connectors.Events = Events;
 Connectors.BaseEvents = BaseEvents;
 Connectors.Snapshots = Snapshots;
@@ -726,6 +741,16 @@ export declare namespace Connectors {
     type ConnectorGetParams as ConnectorGetParams,
   };
 
+  export {
+    Interrupts as Interrupts,
+    BaseInterrupts as BaseInterrupts,
+    type InterruptCreateResponse as InterruptCreateResponse,
+    type InterruptListResponse as InterruptListResponse,
+    type InterruptListResponsesSinglePage as InterruptListResponsesSinglePage,
+    type InterruptCreateParams as InterruptCreateParams,
+    type InterruptListParams as InterruptListParams,
+  };
+
   export {
     Events as Events,
     BaseEvents as BaseEvents,