import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * Manages a Security Hub V2 connector. * * > **NOTE:** Connectors must be created in the aggregation (home) region. A Security Hub V2 Aggregator (`aws.securityhub.AggregatorV2`) must exist before creating connectors. * * > **NOTE:** After creation, the connector will be in `PENDING_AUTHORIZATION` status. Use the `authUrl` output to complete the OAuth authorization flow. * * ## Example Usage * * ### Jira Cloud * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const example = new aws.securityhub.AccountV2("example", {}); * const exampleAggregatorV2 = new aws.securityhub.AggregatorV2("example", {regionLinkingMode: "ALL_REGIONS"}, { * dependsOn: [example], * }); * const exampleConnectorV2 = new aws.securityhub.ConnectorV2("example", { * connectorProvider: { * jiraCloud: { * projectKey: "SEC", * }, * }, * name: "jira-connector", * }, { * dependsOn: [exampleAggregatorV2], * }); * export const authUrl = exampleConnectorV2.authUrl; * ``` * * ### With Description and KMS Key * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const example = new aws.securityhub.ConnectorV2("example", { * connectorProvider: { * jiraCloud: { * projectKey: "SEC", * }, * }, * name: "jira-connector", * description: "Jira Cloud integration for security findings", * kmsKeyArn: exampleAwsKmsKey.arn, * }, { * dependsOn: [exampleAwsSecurityhubAggregatorV2], * }); * ``` * * ## Import * * ### Identity Schema * * #### Required * * * `connectorId` (String) ID of the Security Hub V2 connector. * * #### Optional * * * `accountId` (String) AWS Account where this resource is managed. * * `region` (String) Region where this resource is managed. * * Using `pulumi import`, import Security Hub V2 connectors using `connectorId`. For example: * * ```sh * $ pulumi import aws:securityhub/connectorV2:ConnectorV2 example 8ecf045f-5a95-c24d-6769-5d52f6929563 * ``` */ export declare class ConnectorV2 extends pulumi.CustomResource { /** * Get an existing ConnectorV2 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, state?: ConnectorV2State, opts?: pulumi.CustomResourceOptions): ConnectorV2; /** * Returns true if the given object is an instance of ConnectorV2. 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 ConnectorV2; /** * ARN of the connector. */ readonly arn: pulumi.Output; /** * ID of the connector. */ readonly connectorId: pulumi.Output; /** * Third-party provider details. See `connectorProvider` below. */ readonly connectorProvider: pulumi.Output; /** * A description of the connector. */ readonly description: pulumi.Output; /** * Current health status. See `health` below. */ readonly healths: pulumi.Output; /** * ARN of KMS key for connector encryption. */ readonly kmsKeyArn: pulumi.Output; /** * The name of the connector. */ readonly name: pulumi.Output; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ readonly region: pulumi.Output; /** * Map of tags to assign to the resource. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. */ readonly tags: pulumi.Output<{ [key: string]: string; } | undefined>; /** * Map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block. */ readonly tagsAll: pulumi.Output<{ [key: string]: string; }>; /** * Create a ConnectorV2 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: ConnectorV2Args, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering ConnectorV2 resources. */ export interface ConnectorV2State { /** * ARN of the connector. */ arn?: pulumi.Input; /** * ID of the connector. */ connectorId?: pulumi.Input; /** * Third-party provider details. See `connectorProvider` below. */ connectorProvider?: pulumi.Input; /** * A description of the connector. */ description?: pulumi.Input; /** * Current health status. See `health` below. */ healths?: pulumi.Input[] | undefined>; /** * ARN of KMS key for connector encryption. */ kmsKeyArn?: pulumi.Input; /** * The name of the connector. */ name?: pulumi.Input; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ region?: pulumi.Input; /** * Map of tags to assign to the resource. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * Map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block. */ tagsAll?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; } /** * The set of arguments for constructing a ConnectorV2 resource. */ export interface ConnectorV2Args { /** * Third-party provider details. See `connectorProvider` below. */ connectorProvider: pulumi.Input; /** * A description of the connector. */ description?: pulumi.Input; /** * ARN of KMS key for connector encryption. */ kmsKeyArn?: pulumi.Input; /** * The name of the connector. */ name?: pulumi.Input; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ region?: pulumi.Input; /** * Map of tags to assign to the resource. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; } //# sourceMappingURL=connectorV2.d.ts.map