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.26.0 published on Wednesday, Mar 12, 2025 by Pulumi

aws-native.iot.getMitigationAction

Explore with Pulumi AI

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

AWS Cloud Control v1.26.0 published on Wednesday, Mar 12, 2025 by Pulumi

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>
Copy
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]
Copy
func LookupMitigationAction(ctx *Context, args *LookupMitigationActionArgs, opts ...InvokeOption) (*LookupMitigationActionResult, error)
func LookupMitigationActionOutput(ctx *Context, args *LookupMitigationActionOutputArgs, opts ...InvokeOption) LookupMitigationActionResultOutput
Copy

> 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)
}
Copy
public static CompletableFuture<GetMitigationActionResult> getMitigationAction(GetMitigationActionArgs args, InvokeOptions options)
public static Output<GetMitigationActionResult> getMitigationAction(GetMitigationActionArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: aws-native:iot:getMitigationAction
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

ActionName This property is required. string
A unique identifier for the mitigation action.
ActionName This property is required. string
A unique identifier for the mitigation action.
actionName This property is required. String
A unique identifier for the mitigation action.
actionName This property is required. string
A unique identifier for the mitigation action.
action_name This property is required. str
A unique identifier for the mitigation action.
actionName This property is required. 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 This property is required. 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 This property is required. []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 This property is required. 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 This property is required. 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 This property is required. 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 This property is required. 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 This property is required. Pulumi.AwsNative.IoT.MitigationActionEnableIoTLoggingParamsLogLevel
Specifies which types of information are logged.
RoleArnForLogging This property is required. string
The ARN of the IAM role used for logging.
LogLevel This property is required. MitigationActionEnableIoTLoggingParamsLogLevel
Specifies which types of information are logged.
RoleArnForLogging This property is required. string
The ARN of the IAM role used for logging.
logLevel This property is required. MitigationActionEnableIoTLoggingParamsLogLevel
Specifies which types of information are logged.
roleArnForLogging This property is required. String
The ARN of the IAM role used for logging.
logLevel This property is required. MitigationActionEnableIoTLoggingParamsLogLevel
Specifies which types of information are logged.
roleArnForLogging This property is required. string
The ARN of the IAM role used for logging.
log_level This property is required. MitigationActionEnableIoTLoggingParamsLogLevel
Specifies which types of information are logged.
role_arn_for_logging This property is required. str
The ARN of the IAM role used for logging.
logLevel This property is required. "DEBUG" | "INFO" | "ERROR" | "WARN" | "UNSET_VALUE"
Specifies which types of information are logged.
roleArnForLogging This property is required. String
The ARN of the IAM role used for logging.

MitigationActionEnableIoTLoggingParamsLogLevel

MitigationActionPublishFindingToSnsParams

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

MitigationActionReplaceDefaultPolicyVersionParams

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

MitigationActionReplaceDefaultPolicyVersionParamsTemplateName

MitigationActionUpdateCaCertificateParams

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

MitigationActionUpdateCaCertificateParamsAction

MitigationActionUpdateDeviceCertificateParams

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

MitigationActionUpdateDeviceCertificateParamsAction

Tag

Key This property is required. string
The key name of the tag
Value This property is required. string
The value of the tag
Key This property is required. string
The key name of the tag
Value This property is required. string
The value of the tag
key This property is required. String
The key name of the tag
value This property is required. String
The value of the tag
key This property is required. string
The key name of the tag
value This property is required. string
The value of the tag
key This property is required. str
The key name of the tag
value This property is required. str
The value of the tag
key This property is required. String
The key name of the tag
value This property is required. String
The value of the tag

Package Details

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

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

AWS Cloud Control v1.26.0 published on Wednesday, Mar 12, 2025 by Pulumi