1. Packages
  2. Packages
  3. AWS
  4. API Docs
  5. securityhub
  6. ConnectorV2
Viewing docs for AWS v7.30.0
published on Thursday, May 14, 2026 by Pulumi
aws logo
Viewing docs for AWS v7.30.0
published on Thursday, May 14, 2026 by Pulumi

    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

    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", {
        name: "jira-connector",
        connectorProvider: {
            jiraCloud: {
                projectKey: "SEC",
            },
        },
    }, {
        dependsOn: [exampleAggregatorV2],
    });
    export const authUrl = exampleConnectorV2.authUrl;
    
    import pulumi
    import pulumi_aws as aws
    
    example = aws.securityhub.AccountV2("example")
    example_aggregator_v2 = aws.securityhub.AggregatorV2("example", region_linking_mode="ALL_REGIONS",
    opts = pulumi.ResourceOptions(depends_on=[example]))
    example_connector_v2 = aws.securityhub.ConnectorV2("example",
        name="jira-connector",
        connector_provider={
            "jira_cloud": {
                "project_key": "SEC",
            },
        },
        opts = pulumi.ResourceOptions(depends_on=[example_aggregator_v2]))
    pulumi.export("authUrl", example_connector_v2.auth_url)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/securityhub"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		example, err := securityhub.NewAccountV2(ctx, "example", nil)
    		if err != nil {
    			return err
    		}
    		exampleAggregatorV2, err := securityhub.NewAggregatorV2(ctx, "example", &securityhub.AggregatorV2Args{
    			RegionLinkingMode: pulumi.String("ALL_REGIONS"),
    		}, pulumi.DependsOn([]pulumi.Resource{
    			example,
    		}))
    		if err != nil {
    			return err
    		}
    		exampleConnectorV2, err := securityhub.NewConnectorV2(ctx, "example", &securityhub.ConnectorV2Args{
    			Name: pulumi.String("jira-connector"),
    			ConnectorProvider: &securityhub.ConnectorV2ConnectorProviderArgs{
    				JiraCloud: &securityhub.ConnectorV2ConnectorProviderJiraCloudArgs{
    					ProjectKey: pulumi.String("SEC"),
    				},
    			},
    		}, pulumi.DependsOn([]pulumi.Resource{
    			exampleAggregatorV2,
    		}))
    		if err != nil {
    			return err
    		}
    		ctx.Export("authUrl", pulumi.Any(exampleConnectorV2.AuthUrl))
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        var example = new Aws.SecurityHub.AccountV2("example");
    
        var exampleAggregatorV2 = new Aws.SecurityHub.AggregatorV2("example", new()
        {
            RegionLinkingMode = "ALL_REGIONS",
        }, new CustomResourceOptions
        {
            DependsOn =
            {
                example,
            },
        });
    
        var exampleConnectorV2 = new Aws.SecurityHub.ConnectorV2("example", new()
        {
            Name = "jira-connector",
            ConnectorProvider = new Aws.SecurityHub.Inputs.ConnectorV2ConnectorProviderArgs
            {
                JiraCloud = new Aws.SecurityHub.Inputs.ConnectorV2ConnectorProviderJiraCloudArgs
                {
                    ProjectKey = "SEC",
                },
            },
        }, new CustomResourceOptions
        {
            DependsOn =
            {
                exampleAggregatorV2,
            },
        });
    
        return new Dictionary<string, object?>
        {
            ["authUrl"] = exampleConnectorV2.AuthUrl,
        };
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.securityhub.AccountV2;
    import com.pulumi.aws.securityhub.AggregatorV2;
    import com.pulumi.aws.securityhub.AggregatorV2Args;
    import com.pulumi.aws.securityhub.ConnectorV2;
    import com.pulumi.aws.securityhub.ConnectorV2Args;
    import com.pulumi.aws.securityhub.inputs.ConnectorV2ConnectorProviderArgs;
    import com.pulumi.aws.securityhub.inputs.ConnectorV2ConnectorProviderJiraCloudArgs;
    import com.pulumi.resources.CustomResourceOptions;
    import java.util.ArrayList;
    import java.util.Arrays;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            var example = new AccountV2("example");
    
            var exampleAggregatorV2 = new AggregatorV2("exampleAggregatorV2", AggregatorV2Args.builder()
                .regionLinkingMode("ALL_REGIONS")
                .build(), CustomResourceOptions.builder()
                    .dependsOn(example)
                    .build());
    
            var exampleConnectorV2 = new ConnectorV2("exampleConnectorV2", ConnectorV2Args.builder()
                .name("jira-connector")
                .connectorProvider(ConnectorV2ConnectorProviderArgs.builder()
                    .jiraCloud(ConnectorV2ConnectorProviderJiraCloudArgs.builder()
                        .projectKey("SEC")
                        .build())
                    .build())
                .build(), CustomResourceOptions.builder()
                    .dependsOn(exampleAggregatorV2)
                    .build());
    
            ctx.export("authUrl", exampleConnectorV2.authUrl());
        }
    }
    
    resources:
      example:
        type: aws:securityhub:AccountV2
      exampleAggregatorV2:
        type: aws:securityhub:AggregatorV2
        name: example
        properties:
          regionLinkingMode: ALL_REGIONS
        options:
          dependsOn:
            - ${example}
      exampleConnectorV2:
        type: aws:securityhub:ConnectorV2
        name: example
        properties:
          name: jira-connector
          connectorProvider:
            jiraCloud:
              projectKey: SEC
        options:
          dependsOn:
            - ${exampleAggregatorV2}
    outputs:
      authUrl: ${exampleConnectorV2.authUrl}
    
    Example coming soon!
    

    With Description and KMS Key

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const example = new aws.securityhub.ConnectorV2("example", {
        name: "jira-connector",
        description: "Jira Cloud integration for security findings",
        kmsKeyArn: exampleAwsKmsKey.arn,
        connectorProvider: {
            jiraCloud: {
                projectKey: "SEC",
            },
        },
    }, {
        dependsOn: [exampleAwsSecurityhubAggregatorV2],
    });
    
    import pulumi
    import pulumi_aws as aws
    
    example = aws.securityhub.ConnectorV2("example",
        name="jira-connector",
        description="Jira Cloud integration for security findings",
        kms_key_arn=example_aws_kms_key["arn"],
        connector_provider={
            "jira_cloud": {
                "project_key": "SEC",
            },
        },
        opts = pulumi.ResourceOptions(depends_on=[example_aws_securityhub_aggregator_v2]))
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/securityhub"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := securityhub.NewConnectorV2(ctx, "example", &securityhub.ConnectorV2Args{
    			Name:        pulumi.String("jira-connector"),
    			Description: pulumi.String("Jira Cloud integration for security findings"),
    			KmsKeyArn:   pulumi.Any(exampleAwsKmsKey.Arn),
    			ConnectorProvider: &securityhub.ConnectorV2ConnectorProviderArgs{
    				JiraCloud: &securityhub.ConnectorV2ConnectorProviderJiraCloudArgs{
    					ProjectKey: pulumi.String("SEC"),
    				},
    			},
    		}, pulumi.DependsOn([]pulumi.Resource{
    			exampleAwsSecurityhubAggregatorV2,
    		}))
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        var example = new Aws.SecurityHub.ConnectorV2("example", new()
        {
            Name = "jira-connector",
            Description = "Jira Cloud integration for security findings",
            KmsKeyArn = exampleAwsKmsKey.Arn,
            ConnectorProvider = new Aws.SecurityHub.Inputs.ConnectorV2ConnectorProviderArgs
            {
                JiraCloud = new Aws.SecurityHub.Inputs.ConnectorV2ConnectorProviderJiraCloudArgs
                {
                    ProjectKey = "SEC",
                },
            },
        }, new CustomResourceOptions
        {
            DependsOn =
            {
                exampleAwsSecurityhubAggregatorV2,
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.securityhub.ConnectorV2;
    import com.pulumi.aws.securityhub.ConnectorV2Args;
    import com.pulumi.aws.securityhub.inputs.ConnectorV2ConnectorProviderArgs;
    import com.pulumi.aws.securityhub.inputs.ConnectorV2ConnectorProviderJiraCloudArgs;
    import com.pulumi.resources.CustomResourceOptions;
    import java.util.ArrayList;
    import java.util.Arrays;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            var example = new ConnectorV2("example", ConnectorV2Args.builder()
                .name("jira-connector")
                .description("Jira Cloud integration for security findings")
                .kmsKeyArn(exampleAwsKmsKey.arn())
                .connectorProvider(ConnectorV2ConnectorProviderArgs.builder()
                    .jiraCloud(ConnectorV2ConnectorProviderJiraCloudArgs.builder()
                        .projectKey("SEC")
                        .build())
                    .build())
                .build(), CustomResourceOptions.builder()
                    .dependsOn(exampleAwsSecurityhubAggregatorV2)
                    .build());
    
        }
    }
    
    resources:
      example:
        type: aws:securityhub:ConnectorV2
        properties:
          name: jira-connector
          description: Jira Cloud integration for security findings
          kmsKeyArn: ${exampleAwsKmsKey.arn}
          connectorProvider:
            jiraCloud:
              projectKey: SEC
        options:
          dependsOn:
            - ${exampleAwsSecurityhubAggregatorV2}
    
    Example coming soon!
    

    Create ConnectorV2 Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new ConnectorV2(name: string, args: ConnectorV2Args, opts?: CustomResourceOptions);
    @overload
    def ConnectorV2(resource_name: str,
                    args: ConnectorV2Args,
                    opts: Optional[ResourceOptions] = None)
    
    @overload
    def ConnectorV2(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    connector_provider: Optional[ConnectorV2ConnectorProviderArgs] = None,
                    description: Optional[str] = None,
                    kms_key_arn: Optional[str] = None,
                    name: Optional[str] = None,
                    region: Optional[str] = None,
                    tags: Optional[Mapping[str, str]] = None)
    func NewConnectorV2(ctx *Context, name string, args ConnectorV2Args, opts ...ResourceOption) (*ConnectorV2, error)
    public ConnectorV2(string name, ConnectorV2Args args, CustomResourceOptions? opts = null)
    public ConnectorV2(String name, ConnectorV2Args args)
    public ConnectorV2(String name, ConnectorV2Args args, CustomResourceOptions options)
    
    type: aws:securityhub:ConnectorV2
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws_securityhub_connectorv2" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args ConnectorV2Args
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args ConnectorV2Args
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args ConnectorV2Args
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ConnectorV2Args
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ConnectorV2Args
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var connectorV2Resource = new Aws.SecurityHub.ConnectorV2("connectorV2Resource", new()
    {
        ConnectorProvider = new Aws.SecurityHub.Inputs.ConnectorV2ConnectorProviderArgs
        {
            JiraCloud = new Aws.SecurityHub.Inputs.ConnectorV2ConnectorProviderJiraCloudArgs
            {
                ProjectKey = "string",
                AuthStatus = "string",
                AuthUrl = "string",
                CloudId = "string",
                Domain = "string",
            },
            ServiceNow = new Aws.SecurityHub.Inputs.ConnectorV2ConnectorProviderServiceNowArgs
            {
                InstanceName = "string",
                SecretArn = "string",
                AuthStatus = "string",
            },
        },
        Description = "string",
        KmsKeyArn = "string",
        Name = "string",
        Region = "string",
        Tags = 
        {
            { "string", "string" },
        },
    });
    
    example, err := securityhub.NewConnectorV2(ctx, "connectorV2Resource", &securityhub.ConnectorV2Args{
    	ConnectorProvider: &securityhub.ConnectorV2ConnectorProviderArgs{
    		JiraCloud: &securityhub.ConnectorV2ConnectorProviderJiraCloudArgs{
    			ProjectKey: pulumi.String("string"),
    			AuthStatus: pulumi.String("string"),
    			AuthUrl:    pulumi.String("string"),
    			CloudId:    pulumi.String("string"),
    			Domain:     pulumi.String("string"),
    		},
    		ServiceNow: &securityhub.ConnectorV2ConnectorProviderServiceNowArgs{
    			InstanceName: pulumi.String("string"),
    			SecretArn:    pulumi.String("string"),
    			AuthStatus:   pulumi.String("string"),
    		},
    	},
    	Description: pulumi.String("string"),
    	KmsKeyArn:   pulumi.String("string"),
    	Name:        pulumi.String("string"),
    	Region:      pulumi.String("string"),
    	Tags: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    })
    
    resource "aws_securityhub_connectorv2" "connectorV2Resource" {
      connector_provider = {
        jira_cloud = {
          project_key = "string"
          auth_status = "string"
          auth_url    = "string"
          cloud_id    = "string"
          domain      = "string"
        }
        service_now = {
          instance_name = "string"
          secret_arn    = "string"
          auth_status   = "string"
        }
      }
      description = "string"
      kms_key_arn = "string"
      name        = "string"
      region      = "string"
      tags = {
        "string" = "string"
      }
    }
    
    var connectorV2Resource = new ConnectorV2("connectorV2Resource", ConnectorV2Args.builder()
        .connectorProvider(ConnectorV2ConnectorProviderArgs.builder()
            .jiraCloud(ConnectorV2ConnectorProviderJiraCloudArgs.builder()
                .projectKey("string")
                .authStatus("string")
                .authUrl("string")
                .cloudId("string")
                .domain("string")
                .build())
            .serviceNow(ConnectorV2ConnectorProviderServiceNowArgs.builder()
                .instanceName("string")
                .secretArn("string")
                .authStatus("string")
                .build())
            .build())
        .description("string")
        .kmsKeyArn("string")
        .name("string")
        .region("string")
        .tags(Map.of("string", "string"))
        .build());
    
    connector_v2_resource = aws.securityhub.ConnectorV2("connectorV2Resource",
        connector_provider={
            "jira_cloud": {
                "project_key": "string",
                "auth_status": "string",
                "auth_url": "string",
                "cloud_id": "string",
                "domain": "string",
            },
            "service_now": {
                "instance_name": "string",
                "secret_arn": "string",
                "auth_status": "string",
            },
        },
        description="string",
        kms_key_arn="string",
        name="string",
        region="string",
        tags={
            "string": "string",
        })
    
    const connectorV2Resource = new aws.securityhub.ConnectorV2("connectorV2Resource", {
        connectorProvider: {
            jiraCloud: {
                projectKey: "string",
                authStatus: "string",
                authUrl: "string",
                cloudId: "string",
                domain: "string",
            },
            serviceNow: {
                instanceName: "string",
                secretArn: "string",
                authStatus: "string",
            },
        },
        description: "string",
        kmsKeyArn: "string",
        name: "string",
        region: "string",
        tags: {
            string: "string",
        },
    });
    
    type: aws:securityhub:ConnectorV2
    properties:
        connectorProvider:
            jiraCloud:
                authStatus: string
                authUrl: string
                cloudId: string
                domain: string
                projectKey: string
            serviceNow:
                authStatus: string
                instanceName: string
                secretArn: string
        description: string
        kmsKeyArn: string
        name: string
        region: string
        tags:
            string: string
    

    ConnectorV2 Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The ConnectorV2 resource accepts the following input properties:

    ConnectorProvider ConnectorV2ConnectorProvider
    Third-party provider details. See connectorProvider below.
    Description string
    A description of the connector.
    KmsKeyArn string
    ARN of KMS key for connector encryption.
    Name string
    The name of the connector.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Tags Dictionary<string, string>
    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.
    ConnectorProvider ConnectorV2ConnectorProviderArgs
    Third-party provider details. See connectorProvider below.
    Description string
    A description of the connector.
    KmsKeyArn string
    ARN of KMS key for connector encryption.
    Name string
    The name of the connector.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Tags map[string]string
    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.
    connector_provider object
    Third-party provider details. See connectorProvider below.
    description string
    A description of the connector.
    kms_key_arn string
    ARN of KMS key for connector encryption.
    name string
    The name of the connector.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags map(string)
    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.
    connectorProvider ConnectorV2ConnectorProvider
    Third-party provider details. See connectorProvider below.
    description String
    A description of the connector.
    kmsKeyArn String
    ARN of KMS key for connector encryption.
    name String
    The name of the connector.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Map<String,String>
    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.
    connectorProvider ConnectorV2ConnectorProvider
    Third-party provider details. See connectorProvider below.
    description string
    A description of the connector.
    kmsKeyArn string
    ARN of KMS key for connector encryption.
    name string
    The name of the connector.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags {[key: string]: string}
    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.
    connector_provider ConnectorV2ConnectorProviderArgs
    Third-party provider details. See connectorProvider below.
    description str
    A description of the connector.
    kms_key_arn str
    ARN of KMS key for connector encryption.
    name str
    The name of the connector.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Mapping[str, str]
    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.
    connectorProvider Property Map
    Third-party provider details. See connectorProvider below.
    description String
    A description of the connector.
    kmsKeyArn String
    ARN of KMS key for connector encryption.
    name String
    The name of the connector.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Map<String>
    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.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the ConnectorV2 resource produces the following output properties:

    Arn string
    ARN of the connector.
    ConnectorId string
    ID of the connector.
    Healths List<ConnectorV2Health>
    Current health status. See health below.
    Id string
    The provider-assigned unique ID for this managed resource.
    TagsAll Dictionary<string, string>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    Arn string
    ARN of the connector.
    ConnectorId string
    ID of the connector.
    Healths []ConnectorV2Health
    Current health status. See health below.
    Id string
    The provider-assigned unique ID for this managed resource.
    TagsAll map[string]string
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    arn string
    ARN of the connector.
    connector_id string
    ID of the connector.
    healths list(object)
    Current health status. See health below.
    id string
    The provider-assigned unique ID for this managed resource.
    tags_all map(string)
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    arn String
    ARN of the connector.
    connectorId String
    ID of the connector.
    healths List<ConnectorV2Health>
    Current health status. See health below.
    id String
    The provider-assigned unique ID for this managed resource.
    tagsAll Map<String,String>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    arn string
    ARN of the connector.
    connectorId string
    ID of the connector.
    healths ConnectorV2Health[]
    Current health status. See health below.
    id string
    The provider-assigned unique ID for this managed resource.
    tagsAll {[key: string]: string}
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    arn str
    ARN of the connector.
    connector_id str
    ID of the connector.
    healths Sequence[ConnectorV2Health]
    Current health status. See health below.
    id str
    The provider-assigned unique ID for this managed resource.
    tags_all Mapping[str, str]
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    arn String
    ARN of the connector.
    connectorId String
    ID of the connector.
    healths List<Property Map>
    Current health status. See health below.
    id String
    The provider-assigned unique ID for this managed resource.
    tagsAll Map<String>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.

    Look up Existing ConnectorV2 Resource

    Get an existing ConnectorV2 resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: ConnectorV2State, opts?: CustomResourceOptions): ConnectorV2
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            arn: Optional[str] = None,
            connector_id: Optional[str] = None,
            connector_provider: Optional[ConnectorV2ConnectorProviderArgs] = None,
            description: Optional[str] = None,
            healths: Optional[Sequence[ConnectorV2HealthArgs]] = None,
            kms_key_arn: Optional[str] = None,
            name: Optional[str] = None,
            region: Optional[str] = None,
            tags: Optional[Mapping[str, str]] = None,
            tags_all: Optional[Mapping[str, str]] = None) -> ConnectorV2
    func GetConnectorV2(ctx *Context, name string, id IDInput, state *ConnectorV2State, opts ...ResourceOption) (*ConnectorV2, error)
    public static ConnectorV2 Get(string name, Input<string> id, ConnectorV2State? state, CustomResourceOptions? opts = null)
    public static ConnectorV2 get(String name, Output<String> id, ConnectorV2State state, CustomResourceOptions options)
    resources:  _:    type: aws:securityhub:ConnectorV2    get:      id: ${id}
    import {
      to = aws_securityhub_connectorv2.example
      id = "${id}"
    }
    
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Arn string
    ARN of the connector.
    ConnectorId string
    ID of the connector.
    ConnectorProvider ConnectorV2ConnectorProvider
    Third-party provider details. See connectorProvider below.
    Description string
    A description of the connector.
    Healths List<ConnectorV2Health>
    Current health status. See health below.
    KmsKeyArn string
    ARN of KMS key for connector encryption.
    Name string
    The name of the connector.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Tags Dictionary<string, string>
    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.
    TagsAll Dictionary<string, string>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    Arn string
    ARN of the connector.
    ConnectorId string
    ID of the connector.
    ConnectorProvider ConnectorV2ConnectorProviderArgs
    Third-party provider details. See connectorProvider below.
    Description string
    A description of the connector.
    Healths []ConnectorV2HealthArgs
    Current health status. See health below.
    KmsKeyArn string
    ARN of KMS key for connector encryption.
    Name string
    The name of the connector.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Tags map[string]string
    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.
    TagsAll map[string]string
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    arn string
    ARN of the connector.
    connector_id string
    ID of the connector.
    connector_provider object
    Third-party provider details. See connectorProvider below.
    description string
    A description of the connector.
    healths list(object)
    Current health status. See health below.
    kms_key_arn string
    ARN of KMS key for connector encryption.
    name string
    The name of the connector.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags map(string)
    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_all map(string)
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    arn String
    ARN of the connector.
    connectorId String
    ID of the connector.
    connectorProvider ConnectorV2ConnectorProvider
    Third-party provider details. See connectorProvider below.
    description String
    A description of the connector.
    healths List<ConnectorV2Health>
    Current health status. See health below.
    kmsKeyArn String
    ARN of KMS key for connector encryption.
    name String
    The name of the connector.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Map<String,String>
    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.
    tagsAll Map<String,String>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    arn string
    ARN of the connector.
    connectorId string
    ID of the connector.
    connectorProvider ConnectorV2ConnectorProvider
    Third-party provider details. See connectorProvider below.
    description string
    A description of the connector.
    healths ConnectorV2Health[]
    Current health status. See health below.
    kmsKeyArn string
    ARN of KMS key for connector encryption.
    name string
    The name of the connector.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags {[key: string]: string}
    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.
    tagsAll {[key: string]: string}
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    arn str
    ARN of the connector.
    connector_id str
    ID of the connector.
    connector_provider ConnectorV2ConnectorProviderArgs
    Third-party provider details. See connectorProvider below.
    description str
    A description of the connector.
    healths Sequence[ConnectorV2HealthArgs]
    Current health status. See health below.
    kms_key_arn str
    ARN of KMS key for connector encryption.
    name str
    The name of the connector.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Mapping[str, str]
    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_all Mapping[str, str]
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    arn String
    ARN of the connector.
    connectorId String
    ID of the connector.
    connectorProvider Property Map
    Third-party provider details. See connectorProvider below.
    description String
    A description of the connector.
    healths List<Property Map>
    Current health status. See health below.
    kmsKeyArn String
    ARN of KMS key for connector encryption.
    name String
    The name of the connector.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Map<String>
    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.
    tagsAll Map<String>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.

    Supporting Types

    ConnectorV2ConnectorProvider, ConnectorV2ConnectorProviderArgs

    JiraCloud ConnectorV2ConnectorProviderJiraCloud
    Details about a Jira Cloud integration. See jiraCloud below.
    ServiceNow ConnectorV2ConnectorProviderServiceNow
    Details about a ServiceNow ITSM integration. See serviceNow below.
    JiraCloud ConnectorV2ConnectorProviderJiraCloud
    Details about a Jira Cloud integration. See jiraCloud below.
    ServiceNow ConnectorV2ConnectorProviderServiceNow
    Details about a ServiceNow ITSM integration. See serviceNow below.
    jira_cloud object
    Details about a Jira Cloud integration. See jiraCloud below.
    service_now object
    Details about a ServiceNow ITSM integration. See serviceNow below.
    jiraCloud ConnectorV2ConnectorProviderJiraCloud
    Details about a Jira Cloud integration. See jiraCloud below.
    serviceNow ConnectorV2ConnectorProviderServiceNow
    Details about a ServiceNow ITSM integration. See serviceNow below.
    jiraCloud ConnectorV2ConnectorProviderJiraCloud
    Details about a Jira Cloud integration. See jiraCloud below.
    serviceNow ConnectorV2ConnectorProviderServiceNow
    Details about a ServiceNow ITSM integration. See serviceNow below.
    jira_cloud ConnectorV2ConnectorProviderJiraCloud
    Details about a Jira Cloud integration. See jiraCloud below.
    service_now ConnectorV2ConnectorProviderServiceNow
    Details about a ServiceNow ITSM integration. See serviceNow below.
    jiraCloud Property Map
    Details about a Jira Cloud integration. See jiraCloud below.
    serviceNow Property Map
    Details about a ServiceNow ITSM integration. See serviceNow below.

    ConnectorV2ConnectorProviderJiraCloud, ConnectorV2ConnectorProviderJiraCloudArgs

    ProjectKey string
    Jira Cloud project key.
    AuthStatus string
    Status of the authorization between Jira Cloud and the service.
    AuthUrl string
    URL to provide to customers for OAuth auth code flow.
    CloudId string
    Cloud ID of the Jira Cloud.
    Domain string
    URL domain of the Jira Cloud instance.
    ProjectKey string
    Jira Cloud project key.
    AuthStatus string
    Status of the authorization between Jira Cloud and the service.
    AuthUrl string
    URL to provide to customers for OAuth auth code flow.
    CloudId string
    Cloud ID of the Jira Cloud.
    Domain string
    URL domain of the Jira Cloud instance.
    project_key string
    Jira Cloud project key.
    auth_status string
    Status of the authorization between Jira Cloud and the service.
    auth_url string
    URL to provide to customers for OAuth auth code flow.
    cloud_id string
    Cloud ID of the Jira Cloud.
    domain string
    URL domain of the Jira Cloud instance.
    projectKey String
    Jira Cloud project key.
    authStatus String
    Status of the authorization between Jira Cloud and the service.
    authUrl String
    URL to provide to customers for OAuth auth code flow.
    cloudId String
    Cloud ID of the Jira Cloud.
    domain String
    URL domain of the Jira Cloud instance.
    projectKey string
    Jira Cloud project key.
    authStatus string
    Status of the authorization between Jira Cloud and the service.
    authUrl string
    URL to provide to customers for OAuth auth code flow.
    cloudId string
    Cloud ID of the Jira Cloud.
    domain string
    URL domain of the Jira Cloud instance.
    project_key str
    Jira Cloud project key.
    auth_status str
    Status of the authorization between Jira Cloud and the service.
    auth_url str
    URL to provide to customers for OAuth auth code flow.
    cloud_id str
    Cloud ID of the Jira Cloud.
    domain str
    URL domain of the Jira Cloud instance.
    projectKey String
    Jira Cloud project key.
    authStatus String
    Status of the authorization between Jira Cloud and the service.
    authUrl String
    URL to provide to customers for OAuth auth code flow.
    cloudId String
    Cloud ID of the Jira Cloud.
    domain String
    URL domain of the Jira Cloud instance.

    ConnectorV2ConnectorProviderServiceNow, ConnectorV2ConnectorProviderServiceNowArgs

    InstanceName string
    Instance name of ServiceNow ITSM.
    SecretArn string
    Amazon Resource Name (ARN) of the AWS Secrets Manager secret that contains the ServiceNow credentials.
    AuthStatus string
    Status of the authorization between ServiceNow and the service.
    InstanceName string
    Instance name of ServiceNow ITSM.
    SecretArn string
    Amazon Resource Name (ARN) of the AWS Secrets Manager secret that contains the ServiceNow credentials.
    AuthStatus string
    Status of the authorization between ServiceNow and the service.
    instance_name string
    Instance name of ServiceNow ITSM.
    secret_arn string
    Amazon Resource Name (ARN) of the AWS Secrets Manager secret that contains the ServiceNow credentials.
    auth_status string
    Status of the authorization between ServiceNow and the service.
    instanceName String
    Instance name of ServiceNow ITSM.
    secretArn String
    Amazon Resource Name (ARN) of the AWS Secrets Manager secret that contains the ServiceNow credentials.
    authStatus String
    Status of the authorization between ServiceNow and the service.
    instanceName string
    Instance name of ServiceNow ITSM.
    secretArn string
    Amazon Resource Name (ARN) of the AWS Secrets Manager secret that contains the ServiceNow credentials.
    authStatus string
    Status of the authorization between ServiceNow and the service.
    instance_name str
    Instance name of ServiceNow ITSM.
    secret_arn str
    Amazon Resource Name (ARN) of the AWS Secrets Manager secret that contains the ServiceNow credentials.
    auth_status str
    Status of the authorization between ServiceNow and the service.
    instanceName String
    Instance name of ServiceNow ITSM.
    secretArn String
    Amazon Resource Name (ARN) of the AWS Secrets Manager secret that contains the ServiceNow credentials.
    authStatus String
    Status of the authorization between ServiceNow and the service.

    ConnectorV2Health, ConnectorV2HealthArgs

    ConnectorStatus string
    Status of the connector.
    LastCheckedAt string
    Timestamp for the time the health status was checked.
    Message string
    Message for the reason of connectorStatus change.
    ConnectorStatus string
    Status of the connector.
    LastCheckedAt string
    Timestamp for the time the health status was checked.
    Message string
    Message for the reason of connectorStatus change.
    connector_status string
    Status of the connector.
    last_checked_at string
    Timestamp for the time the health status was checked.
    message string
    Message for the reason of connectorStatus change.
    connectorStatus String
    Status of the connector.
    lastCheckedAt String
    Timestamp for the time the health status was checked.
    message String
    Message for the reason of connectorStatus change.
    connectorStatus string
    Status of the connector.
    lastCheckedAt string
    Timestamp for the time the health status was checked.
    message string
    Message for the reason of connectorStatus change.
    connector_status str
    Status of the connector.
    last_checked_at str
    Timestamp for the time the health status was checked.
    message str
    Message for the reason of connectorStatus change.
    connectorStatus String
    Status of the connector.
    lastCheckedAt String
    Timestamp for the time the health status was checked.
    message String
    Message for the reason of connectorStatus change.

    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:

    $ pulumi import aws:securityhub/connectorV2:ConnectorV2 example 8ecf045f-5a95-c24d-6769-5d52f6929563
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo
    Viewing docs for AWS v7.30.0
    published on Thursday, May 14, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial