@pulumi/sumologic
Version:
A Pulumi package for creating and managing sumologic cloud resources.
222 lines (221 loc) • 9.72 kB
TypeScript
import * as pulumi from "@pulumi/pulumi";
import * as inputs from "./types/input";
import * as outputs from "./types/output";
/**
* Provides a [Sumologic CloudTrail source](https://help.sumologic.com/03Send-Data/Sources/02Sources-for-Hosted-Collectors/Amazon-Web-Services/AWS-CloudTrail-Source).
*
* __IMPORTANT:__ The AWS credentials are stored in plain-text in the state. This is a potential security issue.
*
* ## Example Usage
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as sumologic from "@pulumi/sumologic";
*
* const collector = new sumologic.Collector("collector", {
* name: "my-collector",
* description: "Just testing this",
* });
* const cloudtrailSource = new sumologic.CloudtrailSource("cloudtrail_source", {
* name: "Amazon Cloultrail",
* description: "My description",
* category: "aws/cloudtrail",
* contentType: "AwsCloudTrailBucket",
* scanInterval: 300000,
* paused: false,
* collectorId: collector.id,
* authentication: {
* type: "S3BucketAuthentication",
* accessKey: "someKey",
* secretKey: "******",
* },
* path: {
* type: "S3BucketPathExpression",
* bucketName: "Bucket1",
* pathExpression: "*",
* },
* });
* ```
*
* ## Import
*
* CloudTrail sources can be imported using the collector and source IDs (`collector/source`), e.g.:
*
* hcl
*
* ```sh
* $ pulumi import sumologic:index/cloudtrailSource:CloudtrailSource test 123/456
* ```
*
* CloudTrail sources can be imported using the collector name and source name (`collectorName/sourceName`), e.g.:
*
* hcl
*
* ```sh
* $ pulumi import sumologic:index/cloudtrailSource:CloudtrailSource test my-test-collector/my-test-source
* ```
*
* [1]: https://help.sumologic.com/Send_Data/Sources/03Use_JSON_to_Configure_Sources/JSON_Parameters_for_Hosted_Sources
*
* [2]: https://help.sumologic.com/03Send-Data/Sources/02Sources-for-Hosted-Collectors/Amazon-Web-Services/AWS-CloudTrail-Source
*/
export declare class CloudtrailSource extends pulumi.CustomResource {
/**
* Get an existing CloudtrailSource 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?: CloudtrailSourceState, opts?: pulumi.CustomResourceOptions): CloudtrailSource;
/**
* Returns true if the given object is an instance of CloudtrailSource. 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 CloudtrailSource;
/**
* Authentication details for connecting to the S3 bucket.
*/
readonly authentication: pulumi.Output<outputs.CloudtrailSourceAuthentication>;
readonly automaticDateParsing: pulumi.Output<boolean | undefined>;
readonly category: pulumi.Output<string | undefined>;
readonly collectorId: pulumi.Output<number>;
/**
* The content-type of the collected data. Details can be found in the [Sumologic documentation for hosted sources](https://help.sumologic.com/Send_Data/Sources/03Use_JSON_to_Configure_Sources/JSON_Parameters_for_Hosted_Sources).
*/
readonly contentType: pulumi.Output<string>;
readonly cutoffRelativeTime: pulumi.Output<string | undefined>;
readonly cutoffTimestamp: pulumi.Output<number | undefined>;
readonly defaultDateFormats: pulumi.Output<outputs.CloudtrailSourceDefaultDateFormat[] | undefined>;
readonly description: pulumi.Output<string | undefined>;
readonly fields: pulumi.Output<{
[key: string]: string;
} | undefined>;
readonly filters: pulumi.Output<outputs.CloudtrailSourceFilter[] | undefined>;
readonly forceTimezone: pulumi.Output<boolean | undefined>;
readonly hashAlgorithm: pulumi.Output<string | undefined>;
readonly hostName: pulumi.Output<string | undefined>;
readonly manualPrefixRegexp: pulumi.Output<string | undefined>;
readonly multilineProcessingEnabled: pulumi.Output<boolean | undefined>;
readonly name: pulumi.Output<string>;
/**
* The location to scan for new data.
*/
readonly path: pulumi.Output<outputs.CloudtrailSourcePath>;
/**
* When set to true, the scanner is paused. To disable, set to false.
*/
readonly paused: pulumi.Output<boolean | undefined>;
/**
* Time interval in milliseconds of scans for new data. The default is 300000 and the minimum value is 1000 milliseconds.
*/
readonly scanInterval: pulumi.Output<number | undefined>;
readonly timezone: pulumi.Output<string | undefined>;
/**
* The HTTP endpoint to use with [SNS to notify Sumo Logic of new files](https://help.sumologic.com/03Send-Data/Sources/02Sources-for-Hosted-Collectors/Amazon-Web-Services/AWS-S3-Source#Set_up_SNS_in_AWS_(Optional)).
*/
readonly url: pulumi.Output<string>;
readonly useAutolineMatching: pulumi.Output<boolean | undefined>;
/**
* Create a CloudtrailSource 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: CloudtrailSourceArgs, opts?: pulumi.CustomResourceOptions);
}
/**
* Input properties used for looking up and filtering CloudtrailSource resources.
*/
export interface CloudtrailSourceState {
/**
* Authentication details for connecting to the S3 bucket.
*/
authentication?: pulumi.Input<inputs.CloudtrailSourceAuthentication>;
automaticDateParsing?: pulumi.Input<boolean>;
category?: pulumi.Input<string>;
collectorId?: pulumi.Input<number>;
/**
* The content-type of the collected data. Details can be found in the [Sumologic documentation for hosted sources](https://help.sumologic.com/Send_Data/Sources/03Use_JSON_to_Configure_Sources/JSON_Parameters_for_Hosted_Sources).
*/
contentType?: pulumi.Input<string>;
cutoffRelativeTime?: pulumi.Input<string>;
cutoffTimestamp?: pulumi.Input<number>;
defaultDateFormats?: pulumi.Input<pulumi.Input<inputs.CloudtrailSourceDefaultDateFormat>[]>;
description?: pulumi.Input<string>;
fields?: pulumi.Input<{
[key: string]: pulumi.Input<string>;
}>;
filters?: pulumi.Input<pulumi.Input<inputs.CloudtrailSourceFilter>[]>;
forceTimezone?: pulumi.Input<boolean>;
hashAlgorithm?: pulumi.Input<string>;
hostName?: pulumi.Input<string>;
manualPrefixRegexp?: pulumi.Input<string>;
multilineProcessingEnabled?: pulumi.Input<boolean>;
name?: pulumi.Input<string>;
/**
* The location to scan for new data.
*/
path?: pulumi.Input<inputs.CloudtrailSourcePath>;
/**
* When set to true, the scanner is paused. To disable, set to false.
*/
paused?: pulumi.Input<boolean>;
/**
* Time interval in milliseconds of scans for new data. The default is 300000 and the minimum value is 1000 milliseconds.
*/
scanInterval?: pulumi.Input<number>;
timezone?: pulumi.Input<string>;
/**
* The HTTP endpoint to use with [SNS to notify Sumo Logic of new files](https://help.sumologic.com/03Send-Data/Sources/02Sources-for-Hosted-Collectors/Amazon-Web-Services/AWS-S3-Source#Set_up_SNS_in_AWS_(Optional)).
*/
url?: pulumi.Input<string>;
useAutolineMatching?: pulumi.Input<boolean>;
}
/**
* The set of arguments for constructing a CloudtrailSource resource.
*/
export interface CloudtrailSourceArgs {
/**
* Authentication details for connecting to the S3 bucket.
*/
authentication: pulumi.Input<inputs.CloudtrailSourceAuthentication>;
automaticDateParsing?: pulumi.Input<boolean>;
category?: pulumi.Input<string>;
collectorId: pulumi.Input<number>;
/**
* The content-type of the collected data. Details can be found in the [Sumologic documentation for hosted sources](https://help.sumologic.com/Send_Data/Sources/03Use_JSON_to_Configure_Sources/JSON_Parameters_for_Hosted_Sources).
*/
contentType: pulumi.Input<string>;
cutoffRelativeTime?: pulumi.Input<string>;
cutoffTimestamp?: pulumi.Input<number>;
defaultDateFormats?: pulumi.Input<pulumi.Input<inputs.CloudtrailSourceDefaultDateFormat>[]>;
description?: pulumi.Input<string>;
fields?: pulumi.Input<{
[key: string]: pulumi.Input<string>;
}>;
filters?: pulumi.Input<pulumi.Input<inputs.CloudtrailSourceFilter>[]>;
forceTimezone?: pulumi.Input<boolean>;
hashAlgorithm?: pulumi.Input<string>;
hostName?: pulumi.Input<string>;
manualPrefixRegexp?: pulumi.Input<string>;
multilineProcessingEnabled?: pulumi.Input<boolean>;
name?: pulumi.Input<string>;
/**
* The location to scan for new data.
*/
path: pulumi.Input<inputs.CloudtrailSourcePath>;
/**
* When set to true, the scanner is paused. To disable, set to false.
*/
paused?: pulumi.Input<boolean>;
/**
* Time interval in milliseconds of scans for new data. The default is 300000 and the minimum value is 1000 milliseconds.
*/
scanInterval?: pulumi.Input<number>;
timezone?: pulumi.Input<string>;
useAutolineMatching?: pulumi.Input<boolean>;
}