@ngrok/ngrok-api 0.10.0 → 0.12.0

package/src/datatypes.ts

@@ -416,6 +416,60 @@ export interface HTTPResponseBackendList {
   nextPageUri?: string;
 }
 
+export interface StaticBackend {
+  /** unique identifier for this static backend */
+  id: string;
+  /** URI of the StaticBackend API resource */
+  uri: string;
+  /** timestamp when the backend was created, RFC 3339 format */
+  createdAt: Date;
+  /** human-readable description of this backend. Optional */
+  description?: string;
+  /** arbitrary user-defined machine-readable data of this backend. Optional */
+  metadata?: string;
+  /** the address to forward to */
+  address: string;
+  /** tls configuration to use */
+  tls: StaticBackendTLS;
+}
+
+export interface StaticBackendTLS {
+  /** if TLS is checked */
+  enabled: boolean;
+}
+
+export interface StaticBackendCreate {
+  /** human-readable description of this backend. Optional */
+  description?: string;
+  /** arbitrary user-defined machine-readable data of this backend. Optional */
+  metadata?: string;
+  /** the address to forward to */
+  address: string;
+  /** tls configuration to use */
+  tls: StaticBackendTLS;
+}
+
+export interface StaticBackendUpdate {
+  id: string;
+  /** human-readable description of this backend. Optional */
+  description?: string;
+  /** arbitrary user-defined machine-readable data of this backend. Optional */
+  metadata?: string;
+  /** the address to forward to */
+  address: string;
+  /** tls configuration to use */
+  tls: StaticBackendTLS;
+}
+
+export interface StaticBackendList {
+  /** the list of all static backends on this account */
+  backends: Array<StaticBackend>;
+  /** URI of the static backends list API resource */
+  uri: string;
+  /** URI of the next page, or null if there is no next page */
+  nextPageUri?: string;
+}
+
 export interface TunnelGroupBackend {
   /** unique identifier for this TunnelGroup backend */
   id: string;
@@ -504,6 +558,43 @@ export interface WeightedBackendList {
   nextPageUri?: string;
 }
 
+export interface BotUser {
+  /** unique API key resource identifier */
+  id: string;
+  /** URI to the API resource of this bot user */
+  uri: string;
+  /** human-readable name used to identify the bot */
+  name: string;
+  /** whether or not the bot is active */
+  active: boolean;
+  /** timestamp when the api key was created, RFC 3339 format */
+  createdAt: Date;
+}
+
+export interface BotUserCreate {
+  /** human-readable name used to identify the bot */
+  name: string;
+  /** whether or not the bot is active */
+  active?: boolean;
+}
+
+export interface BotUserUpdate {
+  id: string;
+  /** human-readable name used to identify the bot */
+  name?: string;
+  /** whether or not the bot is active */
+  active?: boolean;
+}
+
+export interface BotUserList {
+  /** the list of all bot users on this account */
+  botUsers: Array<BotUser>;
+  /** URI of the bot users list API resource */
+  uri: string;
+  /** URI of the next page, or null if there is no next page */
+  nextPageUri?: string;
+}
+
 export interface CertificateAuthorityCreate {
   /** human-readable description of this Certificate Authority. optional, max 255 bytes. */
   description?: string;
@@ -607,7 +698,7 @@ export interface CredentialList {
 export interface EndpointWebhookValidation {
   /** `true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified */
   enabled?: boolean;
-  /** a string indicating which webhook provider will be sending webhooks to this endpoint. Value must be one of the supported providers defined at https://ngrok.com/docs/cloud-edge/modules/webhook */
+  /** a string indicating which webhook provider will be sending webhooks to this endpoint. Value must be one of the supported providers defined at https://ngrok.com/docs/cloud-edge/modules/webhook-verification */
   provider: string;
   /** a string secret used to validate requests from the given provider. All providers except AWS SNS require a secret */
   secret: string;
@@ -915,6 +1006,19 @@ export interface EndpointWebsocketTCPConverter {
   enabled?: boolean;
 }
 
+export interface EndpointUserAgentFilter {
+  enabled?: boolean;
+  allow: Array<string>;
+  deny: Array<string>;
+}
+
+export interface EndpointTrafficPolicy {
+  /** `true` if the module will be applied to traffic, `false` to disable. default `true` if unspecified */
+  enabled?: boolean;
+  /** the traffic policy that should be applied to the traffic on your endpoint. */
+  value: string;
+}
+
 export interface EdgeRouteItem {
   /** unique identifier of this edge */
   edgeId: string;
@@ -955,6 +1059,9 @@ export interface HTTPSEdgeRouteCreate {
   oidc?: EndpointOIDC;
   /** websocket to tcp adapter configuration or `null` */
   websocketTcpConverter?: EndpointWebsocketTCPConverter;
+  userAgentFilter?: EndpointUserAgentFilter;
+  /** the traffic policy associated with this edge or null */
+  trafficPolicy?: EndpointTrafficPolicy;
 }
 
 export interface HTTPSEdgeRouteUpdate {
@@ -992,6 +1099,9 @@ export interface HTTPSEdgeRouteUpdate {
   oidc?: EndpointOIDC;
   /** websocket to tcp adapter configuration or `null` */
   websocketTcpConverter?: EndpointWebsocketTCPConverter;
+  userAgentFilter?: EndpointUserAgentFilter;
+  /** the traffic policy associated with this edge or null */
+  trafficPolicy?: EndpointTrafficPolicy;
 }
 
 export interface HTTPSEdgeRoute {
@@ -1033,6 +1143,9 @@ export interface HTTPSEdgeRoute {
   oidc?: EndpointOIDC;
   /** websocket to tcp adapter configuration or `null` */
   websocketTcpConverter?: EndpointWebsocketTCPConverter;
+  userAgentFilter?: EndpointUserAgentFilter;
+  /** the traffic policy associated with this edge or null */
+  trafficPolicy?: EndpointTrafficPolicy;
 }
 
 export interface HTTPSEdgeList {
@@ -1115,6 +1228,11 @@ export interface EdgeTLSTerminationAtEdgeReplace {
   module: EndpointTLSTerminationAtEdge;
 }
 
+export interface EdgeTrafficPolicyReplace {
+  id: string;
+  module: EndpointTrafficPolicy;
+}
+
 export interface EdgeRouteBackendReplace {
   edgeId: string;
   id: string;
@@ -1181,6 +1299,18 @@ export interface EdgeRouteWebsocketTCPConverterReplace {
   module: EndpointWebsocketTCPConverter;
 }
 
+export interface EdgeRouteUserAgentFilterReplace {
+  edgeId: string;
+  id: string;
+  module: EndpointUserAgentFilter;
+}
+
+export interface EdgeRouteTrafficPolicyReplace {
+  edgeId: string;
+  id: string;
+  module: EndpointTrafficPolicy;
+}
+
 export interface TCPEdgeList {
   /** the list of all TCP Edges on this account */
   tcpEdges: Array<TCPEdge>;
@@ -1200,6 +1330,8 @@ export interface TCPEdgeCreate {
   /** edge modules */
   backend?: EndpointBackendMutate;
   ipRestriction?: EndpointIPPolicyMutate;
+  /** the traffic policy associated with this edge or null */
+  trafficPolicy?: EndpointTrafficPolicy;
 }
 
 export interface TCPEdgeUpdate {
@@ -1214,6 +1346,8 @@ export interface TCPEdgeUpdate {
   /** edge modules */
   backend?: EndpointBackendMutate;
   ipRestriction?: EndpointIPPolicyMutate;
+  /** the traffic policy associated with this edge or null */
+  trafficPolicy?: EndpointTrafficPolicy;
 }
 
 export interface TCPEdge {
@@ -1232,6 +1366,8 @@ export interface TCPEdge {
   /** edge modules */
   backend?: EndpointBackend;
   ipRestriction?: EndpointIPPolicy;
+  /** the traffic policy associated with this edge or null */
+  trafficPolicy?: EndpointTrafficPolicy;
 }
 
 export interface TLSEdgeList {
@@ -1255,6 +1391,8 @@ export interface TLSEdgeCreate {
   ipRestriction?: EndpointIPPolicyMutate;
   mutualTls?: EndpointMutualTLSMutate;
   tlsTermination?: EndpointTLSTermination;
+  /** the traffic policy associated with this edge or null */
+  trafficPolicy?: EndpointTrafficPolicy;
 }
 
 export interface TLSEdgeUpdate {
@@ -1271,6 +1409,8 @@ export interface TLSEdgeUpdate {
   ipRestriction?: EndpointIPPolicyMutate;
   mutualTls?: EndpointMutualTLSMutate;
   tlsTermination?: EndpointTLSTermination;
+  /** the traffic policy associated with this edge or null */
+  trafficPolicy?: EndpointTrafficPolicy;
 }
 
 export interface TLSEdge {
@@ -1291,6 +1431,8 @@ export interface TLSEdge {
   ipRestriction?: EndpointIPPolicy;
   mutualTls?: EndpointMutualTLS;
   tlsTermination?: EndpointTLSTermination;
+  /** the traffic policy associated with this edge or null */
+  trafficPolicy?: EndpointTrafficPolicy;
 }
 
 export interface Endpoint {
@@ -1390,6 +1532,7 @@ export interface EventTarget {
   cloudwatchLogs?: EventTargetCloudwatchLogs;
   /** Configuration used to send events to Datadog. */
   datadog?: EventTargetDatadog;
+  azureLogsIngestion?: EventTargetAzureLogsIngestion;
 }
 
 export interface EventTargetFirehose {
@@ -1424,6 +1567,21 @@ export interface EventTargetDatadog {
   ddsite?: string;
 }
 
+export interface EventTargetAzureLogsIngestion {
+  /** Tenant ID for the Azure account */
+  tenantId: string;
+  /** Client ID for the application client */
+  clientId: string;
+  /** Client Secret for the application client */
+  clientSecret: string;
+  /** Data collection endpoint logs ingestion URI */
+  logsIngestionUri: string;
+  /** Data collection rule immutable ID */
+  dataCollectionRuleId: string;
+  /** Data collection stream name to use as destination, located instide the DCR */
+  dataCollectionStreamName: string;
+}
+
 export interface AWSAuth {
   /** A role for ngrok to assume on your behalf to deposit events into your AWS account. */
   role?: AWSRole;
@@ -1727,7 +1885,7 @@ export interface ReservedAddrList {
 export interface ReservedDomainCreate {
   /** hostname of the reserved domain */
   domain: string;
-  /** reserve the domain in this geographic ngrok datacenter. Optional, default is us. (au, eu, ap, us, jp, in, sa) */
+  /** deprecated: With the launch of the ngrok Global Network domains traffic is now handled globally. This field applied only to endpoints. Note that agents may still connect to specific regions. Optional, null by default. (au, eu, ap, us, jp, in, sa) */
   region: string;
   /** human-readable description of what this reserved domain will be used for */
   description?: string;
@@ -1764,9 +1922,9 @@ export interface ReservedDomain {
   metadata?: string;
   /** hostname of the reserved domain */
   domain: string;
-  /** reserve the domain in this geographic ngrok datacenter. Optional, default is us. (au, eu, ap, us, jp, in, sa) */
+  /** deprecated: With the launch of the ngrok Global Network domains traffic is now handled globally. This field applied only to endpoints. Note that agents may still connect to specific regions. Optional, null by default. (au, eu, ap, us, jp, in, sa) */
   region: string;
-  /** DNS CNAME target for a custom hostname, or null if the reserved domain is a subdomain of *.ngrok.io */
+  /** DNS CNAME target for a custom hostname, or null if the reserved domain is a subdomain of an ngrok owned domain (e.g. *.ngrok.app) */
   cnameTarget?: string;
   /** object referencing the TLS certificate used for connections to this domain. This can be either a user-uploaded certificate, the most recently issued automatic one, or null otherwise. */
   certificate?: Ref;