1. Packages
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. securityhub
  6. Connector

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.74.1
published on Monday, Aug 3, 2026 by Pulumi
aws-native logo aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.74.1
published on Monday, Aug 3, 2026 by Pulumi

    Creates a connector to a third-party cloud provider in Security Hub CSPM. A connector establishes a connection between Security Hub CSPM and a third-party cloud provider, enabling Security Hub CSPM to ingest security findings and resource data from the connected environment.

    Create Connector Resource

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

    Constructor syntax

    new Connector(name: string, args: ConnectorArgs, opts?: CustomResourceOptions);
    @overload
    def Connector(resource_name: str,
                  args: ConnectorArgs,
                  opts: Optional[ResourceOptions] = None)
    
    @overload
    def Connector(resource_name: str,
                  opts: Optional[ResourceOptions] = None,
                  provider: Optional[ConnectorProviderArgs] = None,
                  description: Optional[str] = None,
                  name: Optional[str] = None,
                  tags: Optional[Mapping[str, str]] = None)
    func NewConnector(ctx *Context, name string, args ConnectorArgs, opts ...ResourceOption) (*Connector, error)
    public Connector(string name, ConnectorArgs args, CustomResourceOptions? opts = null)
    public Connector(String name, ConnectorArgs args)
    public Connector(String name, ConnectorArgs args, CustomResourceOptions options)
    
    type: aws-native:securityhub:Connector
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws-native_securityhub_connector" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args ConnectorArgs
    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 ConnectorArgs
    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 ConnectorArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ConnectorArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ConnectorArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Connector 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 Connector resource accepts the following input properties:

    Provider Pulumi.AwsNative.SecurityHub.Inputs.ConnectorProvider
    Description string
    The description of the connector.
    Name string
    The name of the connector.
    Tags Dictionary<string, string>
    Provider ConnectorProviderArgs
    Description string
    The description of the connector.
    Name string
    The name of the connector.
    Tags map[string]string
    provider object
    description string
    The description of the connector.
    name string
    The name of the connector.
    tags map(string)
    provider ConnectorProvider
    description String
    The description of the connector.
    name String
    The name of the connector.
    tags Map<String,String>
    provider ConnectorProvider
    description string
    The description of the connector.
    name string
    The name of the connector.
    tags {[key: string]: string}
    provider ConnectorProviderArgs
    description str
    The description of the connector.
    name str
    The name of the connector.
    tags Mapping[str, str]
    provider Property Map
    description String
    The description of the connector.
    name String
    The name of the connector.
    tags Map<String>

    Outputs

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

    ConnectorArn string
    ConnectorId string
    ConnectorStatus string
    CreatedAt string
    CreatedBy string
    EnablementStatus string
    Id string
    The provider-assigned unique ID for this managed resource.
    Issues List<Pulumi.AwsNative.SecurityHub.Outputs.ConnectorHealthIssue>
    LastCheckedAt string
    LastUpdatedAt string
    Message string
    ConnectorArn string
    ConnectorId string
    ConnectorStatus string
    CreatedAt string
    CreatedBy string
    EnablementStatus string
    Id string
    The provider-assigned unique ID for this managed resource.
    Issues []ConnectorHealthIssue
    LastCheckedAt string
    LastUpdatedAt string
    Message string
    connector_arn string
    connector_id string
    connector_status string
    created_at string
    created_by string
    enablement_status string
    id string
    The provider-assigned unique ID for this managed resource.
    issues list(object)
    last_checked_at string
    last_updated_at string
    message string
    connectorArn String
    connectorId String
    connectorStatus String
    createdAt String
    createdBy String
    enablementStatus String
    id String
    The provider-assigned unique ID for this managed resource.
    issues List<ConnectorHealthIssue>
    lastCheckedAt String
    lastUpdatedAt String
    message String
    connectorArn string
    connectorId string
    connectorStatus string
    createdAt string
    createdBy string
    enablementStatus string
    id string
    The provider-assigned unique ID for this managed resource.
    issues ConnectorHealthIssue[]
    lastCheckedAt string
    lastUpdatedAt string
    message string
    connectorArn String
    connectorId String
    connectorStatus String
    createdAt String
    createdBy String
    enablementStatus String
    id String
    The provider-assigned unique ID for this managed resource.
    issues List<Property Map>
    lastCheckedAt String
    lastUpdatedAt String
    message String

    Supporting Types

    ConnectorAzureProviderConfiguration, ConnectorAzureProviderConfigurationArgs

    The configuration for connecting to an Azure environment.
    AwsConfigConnectorArn string
    The ARN of the multi-cloud configuration connector used to establish the connection to Azure.
    AzureRegions List<string>
    The list of Azure regions to monitor.
    ScopeConfiguration Pulumi.AwsNative.SecurityHub.Inputs.ConnectorAzureScopeConfiguration
    The scope configuration that defines which Azure resources are monitored.
    AwsConfigConnectorArn string
    The ARN of the multi-cloud configuration connector used to establish the connection to Azure.
    AzureRegions []string
    The list of Azure regions to monitor.
    ScopeConfiguration ConnectorAzureScopeConfiguration
    The scope configuration that defines which Azure resources are monitored.
    aws_config_connector_arn string
    The ARN of the multi-cloud configuration connector used to establish the connection to Azure.
    azure_regions list(string)
    The list of Azure regions to monitor.
    scope_configuration object
    The scope configuration that defines which Azure resources are monitored.
    awsConfigConnectorArn String
    The ARN of the multi-cloud configuration connector used to establish the connection to Azure.
    azureRegions List<String>
    The list of Azure regions to monitor.
    scopeConfiguration ConnectorAzureScopeConfiguration
    The scope configuration that defines which Azure resources are monitored.
    awsConfigConnectorArn string
    The ARN of the multi-cloud configuration connector used to establish the connection to Azure.
    azureRegions string[]
    The list of Azure regions to monitor.
    scopeConfiguration ConnectorAzureScopeConfiguration
    The scope configuration that defines which Azure resources are monitored.
    aws_config_connector_arn str
    The ARN of the multi-cloud configuration connector used to establish the connection to Azure.
    azure_regions Sequence[str]
    The list of Azure regions to monitor.
    scope_configuration ConnectorAzureScopeConfiguration
    The scope configuration that defines which Azure resources are monitored.
    awsConfigConnectorArn String
    The ARN of the multi-cloud configuration connector used to establish the connection to Azure.
    azureRegions List<String>
    The list of Azure regions to monitor.
    scopeConfiguration Property Map
    The scope configuration that defines which Azure resources are monitored.

    ConnectorAzureScopeConfiguration, ConnectorAzureScopeConfigurationArgs

    The scope configuration for an Azure connector, defining the tenant or subscription scope.
    ScopeType Pulumi.AwsNative.SecurityHub.ConnectorAzureScopeConfigurationScopeType
    The type of scope. Valid values are tenant and subscription.
    ScopeValues List<string>
    The list of scope values, such as subscription IDs, when the scope type is subscription.
    ScopeType ConnectorAzureScopeConfigurationScopeType
    The type of scope. Valid values are tenant and subscription.
    ScopeValues []string
    The list of scope values, such as subscription IDs, when the scope type is subscription.
    scope_type "TENANT" | "SUBSCRIPTION"
    The type of scope. Valid values are tenant and subscription.
    scope_values list(string)
    The list of scope values, such as subscription IDs, when the scope type is subscription.
    scopeType ConnectorAzureScopeConfigurationScopeType
    The type of scope. Valid values are tenant and subscription.
    scopeValues List<String>
    The list of scope values, such as subscription IDs, when the scope type is subscription.
    scopeType ConnectorAzureScopeConfigurationScopeType
    The type of scope. Valid values are tenant and subscription.
    scopeValues string[]
    The list of scope values, such as subscription IDs, when the scope type is subscription.
    scope_type ConnectorAzureScopeConfigurationScopeType
    The type of scope. Valid values are tenant and subscription.
    scope_values Sequence[str]
    The list of scope values, such as subscription IDs, when the scope type is subscription.
    scopeType "TENANT" | "SUBSCRIPTION"
    The type of scope. Valid values are tenant and subscription.
    scopeValues List<String>
    The list of scope values, such as subscription IDs, when the scope type is subscription.

    ConnectorAzureScopeConfigurationScopeType, ConnectorAzureScopeConfigurationScopeTypeArgs

    Tenant
    TENANT
    Subscription
    SUBSCRIPTION
    ConnectorAzureScopeConfigurationScopeTypeTenant
    TENANT
    ConnectorAzureScopeConfigurationScopeTypeSubscription
    SUBSCRIPTION
    "TENANT"
    TENANT
    "SUBSCRIPTION"
    SUBSCRIPTION
    Tenant
    TENANT
    Subscription
    SUBSCRIPTION
    Tenant
    TENANT
    Subscription
    SUBSCRIPTION
    TENANT
    TENANT
    SUBSCRIPTION
    SUBSCRIPTION
    "TENANT"
    TENANT
    "SUBSCRIPTION"
    SUBSCRIPTION

    ConnectorHealthIssue, ConnectorHealthIssueArgs

    Represents a specific health issue detected for a connector.
    Code string
    The error code that identifies the type of health issue.
    Message string
    A human-readable message that describes the health issue.
    Code string
    The error code that identifies the type of health issue.
    Message string
    A human-readable message that describes the health issue.
    code string
    The error code that identifies the type of health issue.
    message string
    A human-readable message that describes the health issue.
    code String
    The error code that identifies the type of health issue.
    message String
    A human-readable message that describes the health issue.
    code string
    The error code that identifies the type of health issue.
    message string
    A human-readable message that describes the health issue.
    code str
    The error code that identifies the type of health issue.
    message str
    A human-readable message that describes the health issue.
    code String
    The error code that identifies the type of health issue.
    message String
    A human-readable message that describes the health issue.

    ConnectorProvider, ConnectorProviderArgs

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.74.1
    published on Monday, Aug 3, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial