@pulumi/juniper-mist
Version:
A Pulumi package for creating and managing Juniper Mist resources.
267 lines (266 loc) • 10.1 kB
TypeScript
import * as pulumi from "@pulumi/pulumi";
/**
* This resource manages Org Webhooks.
*
* A Webhook is a configuration that allows real-time events and data from the Org to be pushed to a provided url.\
* It enables the collection of information about various topics such as device events, alarms, and audits updates at the org level.\
* The Webhook can be set up and customized using the Mist API, allowing users to receive and analyze specific data from a particular site.
*
* ## Import
*
* Using `pulumi import`, import `mist_org_webhook` with:
*
* Org Webhook can be imported by specifying the org_id and the webhook_id
*
* ```sh
* $ pulumi import junipermist:org/webhook:Webhook webhook_one 17b46405-3a6d-4715-8bb4-6bb6d06f316a.d3c42998-9012-4859-9743-6b9bee475309
* ```
*/
export declare class Webhook extends pulumi.CustomResource {
/**
* Get an existing Webhook resource's state with the given name, ID, and optional extra
* properties used to qualify the lookup.
*
* @param name The _unique_ name of the resulting resource.
* @param id The _unique_ provider ID of the resource to lookup.
* @param state Any extra arguments used during the lookup.
* @param opts Optional settings to control the behavior of the CustomResource.
*/
static get(name: string, id: pulumi.Input<pulumi.ID>, state?: WebhookState, opts?: pulumi.CustomResourceOptions): Webhook;
/**
* Returns true if the given object is an instance of Webhook. This is designed to work even
* when multiple copies of the Pulumi SDK have been loaded into the same process.
*/
static isInstance(obj: any): obj is Webhook;
/**
* Whether webhook is enabled
*/
readonly enabled: pulumi.Output<boolean>;
/**
* If `type`=`http-post`, additional custom HTTP headers to add. The headers name and value must be string, total bytes of headers name and value must be less than 1000
*/
readonly headers: pulumi.Output<{
[key: string]: string;
} | undefined>;
/**
* Name of the webhook
*/
readonly name: pulumi.Output<string>;
/**
* Required when `oauth2GrantType`==`clientCredentials`
*/
readonly oauth2ClientId: pulumi.Output<string | undefined>;
/**
* Required when `oauth2GrantType`==`clientCredentials`
*/
readonly oauth2ClientSecret: pulumi.Output<string | undefined>;
/**
* required when `type`==`oauth2`. enum: `clientCredentials`, `password`
*/
readonly oauth2GrantType: pulumi.Output<string | undefined>;
/**
* Required when `oauth2GrantType`==`password`
*/
readonly oauth2Password: pulumi.Output<string | undefined>;
/**
* Required when `type`==`oauth2`, if provided, will be used in the token request
*/
readonly oauth2Scopes: pulumi.Output<string[] | undefined>;
/**
* Required when `type`==`oauth2`
*/
readonly oauth2TokenUrl: pulumi.Output<string | undefined>;
/**
* Required when `oauth2GrantType`==`password`
*/
readonly oauth2Username: pulumi.Output<string | undefined>;
readonly orgId: pulumi.Output<string>;
/**
* Only if `type`=`http-post`
*/
readonly secret: pulumi.Output<string | undefined>;
/**
* Some solutions may not be able to parse multiple events from a single message (e.g. IBM Qradar, DSM). When set to
* `true`, only a single event will be sent per message. this feature is only available on certain topics (see List Webhook
* Topics)
*/
readonly singleEventPerMessage: pulumi.Output<boolean | undefined>;
/**
* Required if `type`=`splunk`. If splunkToken is not defined for a type Splunk webhook, it will not send, regardless if
* the webhook receiver is configured to accept it.
*/
readonly splunkToken: pulumi.Output<string | undefined>;
/**
* enum: `alarms`, `audits`, `client-info`, `client-join`, `client-sessions`, `device-events`, `device-updowns`, `guest-authorizations`, `mxedge-events`, `nac-accounting`, `nac-events`
*/
readonly topics: pulumi.Output<string[]>;
/**
* enum: `aws-sns`, `google-pubsub`, `http-post`, `oauth2`, `splunk`
*/
readonly type: pulumi.Output<string>;
readonly url: pulumi.Output<string>;
/**
* When url uses HTTPS, whether to verify the certificate
*/
readonly verifyCert: pulumi.Output<boolean>;
/**
* Create a Webhook resource with the given unique name, arguments, and options.
*
* @param name The _unique_ name of the resource.
* @param args The arguments to use to populate this resource's properties.
* @param opts A bag of options that control this resource's behavior.
*/
constructor(name: string, args: WebhookArgs, opts?: pulumi.CustomResourceOptions);
}
/**
* Input properties used for looking up and filtering Webhook resources.
*/
export interface WebhookState {
/**
* Whether webhook is enabled
*/
enabled?: pulumi.Input<boolean>;
/**
* If `type`=`http-post`, additional custom HTTP headers to add. The headers name and value must be string, total bytes of headers name and value must be less than 1000
*/
headers?: pulumi.Input<{
[key: string]: pulumi.Input<string>;
}>;
/**
* Name of the webhook
*/
name?: pulumi.Input<string>;
/**
* Required when `oauth2GrantType`==`clientCredentials`
*/
oauth2ClientId?: pulumi.Input<string>;
/**
* Required when `oauth2GrantType`==`clientCredentials`
*/
oauth2ClientSecret?: pulumi.Input<string>;
/**
* required when `type`==`oauth2`. enum: `clientCredentials`, `password`
*/
oauth2GrantType?: pulumi.Input<string>;
/**
* Required when `oauth2GrantType`==`password`
*/
oauth2Password?: pulumi.Input<string>;
/**
* Required when `type`==`oauth2`, if provided, will be used in the token request
*/
oauth2Scopes?: pulumi.Input<pulumi.Input<string>[]>;
/**
* Required when `type`==`oauth2`
*/
oauth2TokenUrl?: pulumi.Input<string>;
/**
* Required when `oauth2GrantType`==`password`
*/
oauth2Username?: pulumi.Input<string>;
orgId?: pulumi.Input<string>;
/**
* Only if `type`=`http-post`
*/
secret?: pulumi.Input<string>;
/**
* Some solutions may not be able to parse multiple events from a single message (e.g. IBM Qradar, DSM). When set to
* `true`, only a single event will be sent per message. this feature is only available on certain topics (see List Webhook
* Topics)
*/
singleEventPerMessage?: pulumi.Input<boolean>;
/**
* Required if `type`=`splunk`. If splunkToken is not defined for a type Splunk webhook, it will not send, regardless if
* the webhook receiver is configured to accept it.
*/
splunkToken?: pulumi.Input<string>;
/**
* enum: `alarms`, `audits`, `client-info`, `client-join`, `client-sessions`, `device-events`, `device-updowns`, `guest-authorizations`, `mxedge-events`, `nac-accounting`, `nac-events`
*/
topics?: pulumi.Input<pulumi.Input<string>[]>;
/**
* enum: `aws-sns`, `google-pubsub`, `http-post`, `oauth2`, `splunk`
*/
type?: pulumi.Input<string>;
url?: pulumi.Input<string>;
/**
* When url uses HTTPS, whether to verify the certificate
*/
verifyCert?: pulumi.Input<boolean>;
}
/**
* The set of arguments for constructing a Webhook resource.
*/
export interface WebhookArgs {
/**
* Whether webhook is enabled
*/
enabled?: pulumi.Input<boolean>;
/**
* If `type`=`http-post`, additional custom HTTP headers to add. The headers name and value must be string, total bytes of headers name and value must be less than 1000
*/
headers?: pulumi.Input<{
[key: string]: pulumi.Input<string>;
}>;
/**
* Name of the webhook
*/
name?: pulumi.Input<string>;
/**
* Required when `oauth2GrantType`==`clientCredentials`
*/
oauth2ClientId?: pulumi.Input<string>;
/**
* Required when `oauth2GrantType`==`clientCredentials`
*/
oauth2ClientSecret?: pulumi.Input<string>;
/**
* required when `type`==`oauth2`. enum: `clientCredentials`, `password`
*/
oauth2GrantType?: pulumi.Input<string>;
/**
* Required when `oauth2GrantType`==`password`
*/
oauth2Password?: pulumi.Input<string>;
/**
* Required when `type`==`oauth2`, if provided, will be used in the token request
*/
oauth2Scopes?: pulumi.Input<pulumi.Input<string>[]>;
/**
* Required when `type`==`oauth2`
*/
oauth2TokenUrl?: pulumi.Input<string>;
/**
* Required when `oauth2GrantType`==`password`
*/
oauth2Username?: pulumi.Input<string>;
orgId: pulumi.Input<string>;
/**
* Only if `type`=`http-post`
*/
secret?: pulumi.Input<string>;
/**
* Some solutions may not be able to parse multiple events from a single message (e.g. IBM Qradar, DSM). When set to
* `true`, only a single event will be sent per message. this feature is only available on certain topics (see List Webhook
* Topics)
*/
singleEventPerMessage?: pulumi.Input<boolean>;
/**
* Required if `type`=`splunk`. If splunkToken is not defined for a type Splunk webhook, it will not send, regardless if
* the webhook receiver is configured to accept it.
*/
splunkToken?: pulumi.Input<string>;
/**
* enum: `alarms`, `audits`, `client-info`, `client-join`, `client-sessions`, `device-events`, `device-updowns`, `guest-authorizations`, `mxedge-events`, `nac-accounting`, `nac-events`
*/
topics: pulumi.Input<pulumi.Input<string>[]>;
/**
* enum: `aws-sns`, `google-pubsub`, `http-post`, `oauth2`, `splunk`
*/
type?: pulumi.Input<string>;
url: pulumi.Input<string>;
/**
* When url uses HTTPS, whether to verify the certificate
*/
verifyCert?: pulumi.Input<boolean>;
}