1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. guardduty
  6. getCustomDetectionRuleAssociation

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

Viewing docs for AWS Cloud Control v1.78.0
published on Monday, Sep 7, 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.78.0
published on Monday, Sep 7, 2026 by Pulumi

    Resource Type definition for AWS::GuardDuty::CustomDetectionRuleAssociation. Associates a GuardDuty custom detection rule with the caller’s account, enabling the rule in either LIVE or DRY_RUN mode.

    Using getCustomDetectionRuleAssociation

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getCustomDetectionRuleAssociation(args: GetCustomDetectionRuleAssociationArgs, opts?: InvokeOptions): Promise<GetCustomDetectionRuleAssociationResult>
    function getCustomDetectionRuleAssociationOutput(args: GetCustomDetectionRuleAssociationOutputArgs, opts?: InvokeOutputOptions): Output<GetCustomDetectionRuleAssociationResult>
    def get_custom_detection_rule_association(association_id: Optional[str] = None,
                                              rule_id: Optional[str] = None,
                                              opts: Optional[InvokeOptions] = None) -> GetCustomDetectionRuleAssociationResult
    def get_custom_detection_rule_association_output(association_id: pulumi.Input[Optional[str]] = None,
                                              rule_id: pulumi.Input[Optional[str]] = None,
                                              opts: Optional[InvokeOutputOptions] = None) -> Output[GetCustomDetectionRuleAssociationResult]
    func LookupCustomDetectionRuleAssociation(ctx *Context, args *LookupCustomDetectionRuleAssociationArgs, opts ...InvokeOption) (*LookupCustomDetectionRuleAssociationResult, error)
    func LookupCustomDetectionRuleAssociationOutput(ctx *Context, args *LookupCustomDetectionRuleAssociationOutputArgs, opts ...InvokeOption) LookupCustomDetectionRuleAssociationResultOutput

    > Note: This function is named LookupCustomDetectionRuleAssociation in the Go SDK.

    public static class GetCustomDetectionRuleAssociation 
    {
        public static Task<GetCustomDetectionRuleAssociationResult> InvokeAsync(GetCustomDetectionRuleAssociationArgs args, InvokeOptions? opts = null)
        public static Output<GetCustomDetectionRuleAssociationResult> Invoke(GetCustomDetectionRuleAssociationInvokeArgs args, InvokeOptions? opts = null)
        public static Output<GetCustomDetectionRuleAssociationResult> Invoke(GetCustomDetectionRuleAssociationInvokeArgs args, InvokeOutputOptions opts)
    }
    public static CompletableFuture<GetCustomDetectionRuleAssociationResult> getCustomDetectionRuleAssociation(GetCustomDetectionRuleAssociationArgs args, InvokeOptions options)
    public static Output<GetCustomDetectionRuleAssociationResult> getCustomDetectionRuleAssociation(GetCustomDetectionRuleAssociationArgs args, InvokeOptions options)
    public static Output<GetCustomDetectionRuleAssociationResult> getCustomDetectionRuleAssociation(GetCustomDetectionRuleAssociationArgs args, InvokeOutputOptions options)
    
    fn::invoke:
      function: aws-native:guardduty:getCustomDetectionRuleAssociation
      arguments:
        # arguments dictionary
    data "aws-native_guardduty_get_custom_detection_rule_association" "name" {
        # arguments
    }

    The following arguments are supported:

    AssociationId string
    The service-generated unique identifier of the association.
    RuleId string
    The catalog identifier of the custom detection rule to associate.
    AssociationId string
    The service-generated unique identifier of the association.
    RuleId string
    The catalog identifier of the custom detection rule to associate.
    association_id string
    The service-generated unique identifier of the association.
    rule_id string
    The catalog identifier of the custom detection rule to associate.
    associationId String
    The service-generated unique identifier of the association.
    ruleId String
    The catalog identifier of the custom detection rule to associate.
    associationId string
    The service-generated unique identifier of the association.
    ruleId string
    The catalog identifier of the custom detection rule to associate.
    association_id str
    The service-generated unique identifier of the association.
    rule_id str
    The catalog identifier of the custom detection rule to associate.
    associationId String
    The service-generated unique identifier of the association.
    ruleId String
    The catalog identifier of the custom detection rule to associate.

    getCustomDetectionRuleAssociation Result

    The following output properties are available:

    AccountId string
    The AWS account ID the association applies to.
    Arn string
    The Amazon Resource Name (ARN) of the association.
    AssociationId string
    The service-generated unique identifier of the association.
    CreatedAt string
    The time the association was created.
    Mode Pulumi.AwsNative.GuardDuty.CustomDetectionRuleAssociationMode
    Whether the rule runs in LIVE mode (generates findings) or DRY_RUN mode (evaluates without generating findings).
    Tags List<Pulumi.AwsNative.Outputs.Tag>
    The tags applied to the association.
    UpdatedAt string
    The time the association was last updated.
    AccountId string
    The AWS account ID the association applies to.
    Arn string
    The Amazon Resource Name (ARN) of the association.
    AssociationId string
    The service-generated unique identifier of the association.
    CreatedAt string
    The time the association was created.
    Mode CustomDetectionRuleAssociationMode
    Whether the rule runs in LIVE mode (generates findings) or DRY_RUN mode (evaluates without generating findings).
    Tags Tag
    The tags applied to the association.
    UpdatedAt string
    The time the association was last updated.
    account_id string
    The AWS account ID the association applies to.
    arn string
    The Amazon Resource Name (ARN) of the association.
    association_id string
    The service-generated unique identifier of the association.
    created_at string
    The time the association was created.
    mode "LIVE" | "DRY_RUN"
    Whether the rule runs in LIVE mode (generates findings) or DRY_RUN mode (evaluates without generating findings).
    tags list(object)
    The tags applied to the association.
    updated_at string
    The time the association was last updated.
    accountId String
    The AWS account ID the association applies to.
    arn String
    The Amazon Resource Name (ARN) of the association.
    associationId String
    The service-generated unique identifier of the association.
    createdAt String
    The time the association was created.
    mode CustomDetectionRuleAssociationMode
    Whether the rule runs in LIVE mode (generates findings) or DRY_RUN mode (evaluates without generating findings).
    tags List<Tag>
    The tags applied to the association.
    updatedAt String
    The time the association was last updated.
    accountId string
    The AWS account ID the association applies to.
    arn string
    The Amazon Resource Name (ARN) of the association.
    associationId string
    The service-generated unique identifier of the association.
    createdAt string
    The time the association was created.
    mode CustomDetectionRuleAssociationMode
    Whether the rule runs in LIVE mode (generates findings) or DRY_RUN mode (evaluates without generating findings).
    tags Tag[]
    The tags applied to the association.
    updatedAt string
    The time the association was last updated.
    account_id str
    The AWS account ID the association applies to.
    arn str
    The Amazon Resource Name (ARN) of the association.
    association_id str
    The service-generated unique identifier of the association.
    created_at str
    The time the association was created.
    mode CustomDetectionRuleAssociationMode
    Whether the rule runs in LIVE mode (generates findings) or DRY_RUN mode (evaluates without generating findings).
    tags Sequence[root_Tag]
    The tags applied to the association.
    updated_at str
    The time the association was last updated.
    accountId String
    The AWS account ID the association applies to.
    arn String
    The Amazon Resource Name (ARN) of the association.
    associationId String
    The service-generated unique identifier of the association.
    createdAt String
    The time the association was created.
    mode "LIVE" | "DRY_RUN"
    Whether the rule runs in LIVE mode (generates findings) or DRY_RUN mode (evaluates without generating findings).
    tags List<Property Map>
    The tags applied to the association.
    updatedAt String
    The time the association was last updated.

    Supporting Types

    CustomDetectionRuleAssociationMode

    Tag

    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    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.78.0
    published on Monday, Sep 7, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial