Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. AWS Cloud Control
  3. API Docs
  4. iot
  5. getMitigationAction

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

AWS Cloud Control v1.27.0 published on Monday, Apr 14, 2025 by Pulumi
pulumi/pulumi-aws-native

aws-native.iot.getMitigationAction

Explore with Pulumi AI

aws-native logo

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

AWS Cloud Control v1.27.0 published on Monday, Apr 14, 2025 by Pulumi
pulumi/pulumi-aws-native

    Mitigation actions can be used to take actions to mitigate issues that were found in an Audit finding or Detect violation.

    Using getMitigationAction

    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 getMitigationAction(args: GetMitigationActionArgs, opts?: InvokeOptions): Promise<GetMitigationActionResult>
function getMitigationActionOutput(args: GetMitigationActionOutputArgs, opts?: InvokeOptions): Output<GetMitigationActionResult>
    def get_mitigation_action(action_name: Optional[str] = None,
                          opts: Optional[InvokeOptions] = None) -> GetMitigationActionResult
def get_mitigation_action_output(action_name: Optional[pulumi.Input[str]] = None,
                          opts: Optional[InvokeOptions] = None) -> Output[GetMitigationActionResult]
    func LookupMitigationAction(ctx *Context, args *LookupMitigationActionArgs, opts ...InvokeOption) (*LookupMitigationActionResult, error)
func LookupMitigationActionOutput(ctx *Context, args *LookupMitigationActionOutputArgs, opts ...InvokeOption) LookupMitigationActionResultOutput

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

    public static class GetMitigationAction 
{
    public static Task<GetMitigationActionResult> InvokeAsync(GetMitigationActionArgs args, InvokeOptions? opts = null)
    public static Output<GetMitigationActionResult> Invoke(GetMitigationActionInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetMitigationActionResult> getMitigationAction(GetMitigationActionArgs args, InvokeOptions options)
public static Output<GetMitigationActionResult> getMitigationAction(GetMitigationActionArgs args, InvokeOptions options)

    fn::invoke:
  function: aws-native:iot:getMitigationAction
  arguments:
    # arguments dictionary

    The following arguments are supported:

    ActionName string
    A unique identifier for the mitigation action.
    ActionName string
    A unique identifier for the mitigation action.
    actionName String
    A unique identifier for the mitigation action.
    actionName string
    A unique identifier for the mitigation action.
    action_name str
    A unique identifier for the mitigation action.
    actionName String
    A unique identifier for the mitigation action.

    getMitigationAction Result

    The following output properties are available:

    ActionParams Pulumi.AwsNative.IoT.Outputs.MitigationActionActionParams
    The set of parameters for this mitigation action. The parameters vary, depending on the kind of action you apply.
    MitigationActionArn string
    The Amazon Resource Name (ARN) of the mitigation action.
    MitigationActionId string
    The ID of the mitigation action.
    RoleArn string
    The IAM role ARN used to apply this mitigation action.
    Tags List<Pulumi.AwsNative.Outputs.Tag>
    An array of key-value pairs to apply to this resource.
    ActionParams MitigationActionActionParams
    The set of parameters for this mitigation action. The parameters vary, depending on the kind of action you apply.
    MitigationActionArn string
    The Amazon Resource Name (ARN) of the mitigation action.
    MitigationActionId string
    The ID of the mitigation action.
    RoleArn string
    The IAM role ARN used to apply this mitigation action.
    Tags Tag
    An array of key-value pairs to apply to this resource.
    actionParams MitigationActionActionParams
    The set of parameters for this mitigation action. The parameters vary, depending on the kind of action you apply.
    mitigationActionArn String
    The Amazon Resource Name (ARN) of the mitigation action.
    mitigationActionId String
    The ID of the mitigation action.
    roleArn String
    The IAM role ARN used to apply this mitigation action.
    tags List<Tag>
    An array of key-value pairs to apply to this resource.
    actionParams MitigationActionActionParams
    The set of parameters for this mitigation action. The parameters vary, depending on the kind of action you apply.
    mitigationActionArn string
    The Amazon Resource Name (ARN) of the mitigation action.
    mitigationActionId string
    The ID of the mitigation action.
    roleArn string
    The IAM role ARN used to apply this mitigation action.
    tags Tag[]
    An array of key-value pairs to apply to this resource.
    action_params MitigationActionActionParams
    The set of parameters for this mitigation action. The parameters vary, depending on the kind of action you apply.
    mitigation_action_arn str
    The Amazon Resource Name (ARN) of the mitigation action.
    mitigation_action_id str
    The ID of the mitigation action.
    role_arn str
    The IAM role ARN used to apply this mitigation action.
    tags Sequence[root_Tag]
    An array of key-value pairs to apply to this resource.
    actionParams Property Map
    The set of parameters for this mitigation action. The parameters vary, depending on the kind of action you apply.
    mitigationActionArn String
    The Amazon Resource Name (ARN) of the mitigation action.
    mitigationActionId String
    The ID of the mitigation action.
    roleArn String
    The IAM role ARN used to apply this mitigation action.
    tags List<Property Map>
    An array of key-value pairs to apply to this resource.

    Supporting Types

    MitigationActionActionParams

    AddThingsToThingGroupParams Pulumi.AwsNative.IoT.Inputs.MitigationActionAddThingsToThingGroupParams
    Specifies the group to which you want to add the devices.
    EnableIoTLoggingParams Pulumi.AwsNative.IoT.Inputs.MitigationActionEnableIoTLoggingParams
    Specifies the logging level and the role with permissions for logging. You cannot specify a logging level of DISABLED .
    PublishFindingToSnsParams Pulumi.AwsNative.IoT.Inputs.MitigationActionPublishFindingToSnsParams
    Specifies the topic to which the finding should be published.
    ReplaceDefaultPolicyVersionParams Pulumi.AwsNative.IoT.Inputs.MitigationActionReplaceDefaultPolicyVersionParams
    Replaces the policy version with a default or blank policy. You specify the template name. Only a value of BLANK_POLICY is currently supported.
    UpdateCaCertificateParams Pulumi.AwsNative.IoT.Inputs.MitigationActionUpdateCaCertificateParams
    Specifies the new state for the CA certificate. Only a value of DEACTIVATE is currently supported.
    UpdateDeviceCertificateParams Pulumi.AwsNative.IoT.Inputs.MitigationActionUpdateDeviceCertificateParams
    Specifies the new state for a device certificate. Only a value of DEACTIVATE is currently supported.
    AddThingsToThingGroupParams MitigationActionAddThingsToThingGroupParams
    Specifies the group to which you want to add the devices.
    EnableIoTLoggingParams MitigationActionEnableIoTLoggingParams
    Specifies the logging level and the role with permissions for logging. You cannot specify a logging level of DISABLED .
    PublishFindingToSnsParams MitigationActionPublishFindingToSnsParams
    Specifies the topic to which the finding should be published.
    ReplaceDefaultPolicyVersionParams MitigationActionReplaceDefaultPolicyVersionParams
    Replaces the policy version with a default or blank policy. You specify the template name. Only a value of BLANK_POLICY is currently supported.
    UpdateCaCertificateParams MitigationActionUpdateCaCertificateParams
    Specifies the new state for the CA certificate. Only a value of DEACTIVATE is currently supported.
    UpdateDeviceCertificateParams MitigationActionUpdateDeviceCertificateParams
    Specifies the new state for a device certificate. Only a value of DEACTIVATE is currently supported.
    addThingsToThingGroupParams MitigationActionAddThingsToThingGroupParams
    Specifies the group to which you want to add the devices.
    enableIoTLoggingParams MitigationActionEnableIoTLoggingParams
    Specifies the logging level and the role with permissions for logging. You cannot specify a logging level of DISABLED .
    publishFindingToSnsParams MitigationActionPublishFindingToSnsParams
    Specifies the topic to which the finding should be published.
    replaceDefaultPolicyVersionParams MitigationActionReplaceDefaultPolicyVersionParams
    Replaces the policy version with a default or blank policy. You specify the template name. Only a value of BLANK_POLICY is currently supported.
    updateCaCertificateParams MitigationActionUpdateCaCertificateParams
    Specifies the new state for the CA certificate. Only a value of DEACTIVATE is currently supported.
    updateDeviceCertificateParams MitigationActionUpdateDeviceCertificateParams
    Specifies the new state for a device certificate. Only a value of DEACTIVATE is currently supported.
    addThingsToThingGroupParams MitigationActionAddThingsToThingGroupParams
    Specifies the group to which you want to add the devices.
    enableIoTLoggingParams MitigationActionEnableIoTLoggingParams
    Specifies the logging level and the role with permissions for logging. You cannot specify a logging level of DISABLED .
    publishFindingToSnsParams MitigationActionPublishFindingToSnsParams
    Specifies the topic to which the finding should be published.
    replaceDefaultPolicyVersionParams MitigationActionReplaceDefaultPolicyVersionParams
    Replaces the policy version with a default or blank policy. You specify the template name. Only a value of BLANK_POLICY is currently supported.
    updateCaCertificateParams MitigationActionUpdateCaCertificateParams
    Specifies the new state for the CA certificate. Only a value of DEACTIVATE is currently supported.
    updateDeviceCertificateParams MitigationActionUpdateDeviceCertificateParams
    Specifies the new state for a device certificate. Only a value of DEACTIVATE is currently supported.
    add_things_to_thing_group_params MitigationActionAddThingsToThingGroupParams
    Specifies the group to which you want to add the devices.
    enable_io_t_logging_params MitigationActionEnableIoTLoggingParams
    Specifies the logging level and the role with permissions for logging. You cannot specify a logging level of DISABLED .
    publish_finding_to_sns_params MitigationActionPublishFindingToSnsParams
    Specifies the topic to which the finding should be published.
    replace_default_policy_version_params MitigationActionReplaceDefaultPolicyVersionParams
    Replaces the policy version with a default or blank policy. You specify the template name. Only a value of BLANK_POLICY is currently supported.
    update_ca_certificate_params MitigationActionUpdateCaCertificateParams
    Specifies the new state for the CA certificate. Only a value of DEACTIVATE is currently supported.
    update_device_certificate_params MitigationActionUpdateDeviceCertificateParams
    Specifies the new state for a device certificate. Only a value of DEACTIVATE is currently supported.
    addThingsToThingGroupParams Property Map
    Specifies the group to which you want to add the devices.
    enableIoTLoggingParams Property Map
    Specifies the logging level and the role with permissions for logging. You cannot specify a logging level of DISABLED .
    publishFindingToSnsParams Property Map
    Specifies the topic to which the finding should be published.
    replaceDefaultPolicyVersionParams Property Map
    Replaces the policy version with a default or blank policy. You specify the template name. Only a value of BLANK_POLICY is currently supported.
    updateCaCertificateParams Property Map
    Specifies the new state for the CA certificate. Only a value of DEACTIVATE is currently supported.
    updateDeviceCertificateParams Property Map
    Specifies the new state for a device certificate. Only a value of DEACTIVATE is currently supported.

    MitigationActionAddThingsToThingGroupParams

    ThingGroupNames List<string>
    The list of groups to which you want to add the things that triggered the mitigation action.
    OverrideDynamicGroups bool
    Specifies if this mitigation action can move the things that triggered the mitigation action out of one or more dynamic thing groups.
    ThingGroupNames []string
    The list of groups to which you want to add the things that triggered the mitigation action.
    OverrideDynamicGroups bool
    Specifies if this mitigation action can move the things that triggered the mitigation action out of one or more dynamic thing groups.
    thingGroupNames List<String>
    The list of groups to which you want to add the things that triggered the mitigation action.
    overrideDynamicGroups Boolean
    Specifies if this mitigation action can move the things that triggered the mitigation action out of one or more dynamic thing groups.
    thingGroupNames string[]
    The list of groups to which you want to add the things that triggered the mitigation action.
    overrideDynamicGroups boolean
    Specifies if this mitigation action can move the things that triggered the mitigation action out of one or more dynamic thing groups.
    thing_group_names Sequence[str]
    The list of groups to which you want to add the things that triggered the mitigation action.
    override_dynamic_groups bool
    Specifies if this mitigation action can move the things that triggered the mitigation action out of one or more dynamic thing groups.
    thingGroupNames List<String>
    The list of groups to which you want to add the things that triggered the mitigation action.
    overrideDynamicGroups Boolean
    Specifies if this mitigation action can move the things that triggered the mitigation action out of one or more dynamic thing groups.

    MitigationActionEnableIoTLoggingParams

    LogLevel Pulumi.AwsNative.IoT.MitigationActionEnableIoTLoggingParamsLogLevel
    Specifies which types of information are logged.
    RoleArnForLogging string
    The ARN of the IAM role used for logging.
    LogLevel MitigationActionEnableIoTLoggingParamsLogLevel
    Specifies which types of information are logged.
    RoleArnForLogging string
    The ARN of the IAM role used for logging.
    logLevel MitigationActionEnableIoTLoggingParamsLogLevel
    Specifies which types of information are logged.
    roleArnForLogging String
    The ARN of the IAM role used for logging.
    logLevel MitigationActionEnableIoTLoggingParamsLogLevel
    Specifies which types of information are logged.
    roleArnForLogging string
    The ARN of the IAM role used for logging.
    log_level MitigationActionEnableIoTLoggingParamsLogLevel
    Specifies which types of information are logged.
    role_arn_for_logging str
    The ARN of the IAM role used for logging.
    logLevel "DEBUG" | "INFO" | "ERROR" | "WARN" | "UNSET_VALUE"
    Specifies which types of information are logged.
    roleArnForLogging String
    The ARN of the IAM role used for logging.

    MitigationActionEnableIoTLoggingParamsLogLevel

    MitigationActionPublishFindingToSnsParams

    TopicArn string
    The ARN of the topic to which you want to publish the findings.
    TopicArn string
    The ARN of the topic to which you want to publish the findings.
    topicArn String
    The ARN of the topic to which you want to publish the findings.
    topicArn string
    The ARN of the topic to which you want to publish the findings.
    topic_arn str
    The ARN of the topic to which you want to publish the findings.
    topicArn String
    The ARN of the topic to which you want to publish the findings.

    MitigationActionReplaceDefaultPolicyVersionParams

    TemplateName Pulumi.AwsNative.IoT.MitigationActionReplaceDefaultPolicyVersionParamsTemplateName
    The name of the template to be applied. The only supported value is BLANK_POLICY .
    TemplateName MitigationActionReplaceDefaultPolicyVersionParamsTemplateName
    The name of the template to be applied. The only supported value is BLANK_POLICY .
    templateName MitigationActionReplaceDefaultPolicyVersionParamsTemplateName
    The name of the template to be applied. The only supported value is BLANK_POLICY .
    templateName MitigationActionReplaceDefaultPolicyVersionParamsTemplateName
    The name of the template to be applied. The only supported value is BLANK_POLICY .
    template_name MitigationActionReplaceDefaultPolicyVersionParamsTemplateName
    The name of the template to be applied. The only supported value is BLANK_POLICY .
    templateName "BLANK_POLICY" | "UNSET_VALUE"
    The name of the template to be applied. The only supported value is BLANK_POLICY .

    MitigationActionReplaceDefaultPolicyVersionParamsTemplateName

    MitigationActionUpdateCaCertificateParams

    Action Pulumi.AwsNative.IoT.MitigationActionUpdateCaCertificateParamsAction
    The action that you want to apply to the CA certificate. The only supported value is DEACTIVATE .
    Action MitigationActionUpdateCaCertificateParamsAction
    The action that you want to apply to the CA certificate. The only supported value is DEACTIVATE .
    action MitigationActionUpdateCaCertificateParamsAction
    The action that you want to apply to the CA certificate. The only supported value is DEACTIVATE .
    action MitigationActionUpdateCaCertificateParamsAction
    The action that you want to apply to the CA certificate. The only supported value is DEACTIVATE .
    action MitigationActionUpdateCaCertificateParamsAction
    The action that you want to apply to the CA certificate. The only supported value is DEACTIVATE .
    action "DEACTIVATE" | "UNSET_VALUE"
    The action that you want to apply to the CA certificate. The only supported value is DEACTIVATE .

    MitigationActionUpdateCaCertificateParamsAction

    MitigationActionUpdateDeviceCertificateParams

    Action Pulumi.AwsNative.IoT.MitigationActionUpdateDeviceCertificateParamsAction
    The action that you want to apply to the device certificate. The only supported value is DEACTIVATE .
    Action MitigationActionUpdateDeviceCertificateParamsAction
    The action that you want to apply to the device certificate. The only supported value is DEACTIVATE .
    action MitigationActionUpdateDeviceCertificateParamsAction
    The action that you want to apply to the device certificate. The only supported value is DEACTIVATE .
    action MitigationActionUpdateDeviceCertificateParamsAction
    The action that you want to apply to the device certificate. The only supported value is DEACTIVATE .
    action MitigationActionUpdateDeviceCertificateParamsAction
    The action that you want to apply to the device certificate. The only supported value is DEACTIVATE .
    action "DEACTIVATE" | "UNSET_VALUE"
    The action that you want to apply to the device certificate. The only supported value is DEACTIVATE .

    MitigationActionUpdateDeviceCertificateParamsAction

    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

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

    AWS Cloud Control v1.27.0 published on Monday, Apr 14, 2025 by Pulumi
    pulumi/pulumi-aws-native