amazonka-iot-2.0: Amazon IoT SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.IoT.StartAuditMitigationActionsTask

Description

Starts a task that applies a set of mitigation actions to the specified target.

Requires permission to access the StartAuditMitigationActionsTask action.

Synopsis

Creating a Request

data StartAuditMitigationActionsTask Source #

See: newStartAuditMitigationActionsTask smart constructor.

Constructors

StartAuditMitigationActionsTask' 

Fields

  • taskId :: Text

    A unique identifier for the task. You can use this identifier to check the status of the task or to cancel it.

  • target :: AuditMitigationActionsTaskTarget

    Specifies the audit findings to which the mitigation actions are applied. You can apply them to a type of audit check, to all findings from an audit, or to a specific set of findings.

  • auditCheckToActionsMapping :: HashMap Text (NonEmpty Text)

    For an audit check, specifies which mitigation actions to apply. Those actions must be defined in your Amazon Web Services accounts.

  • clientRequestToken :: Text

    Each audit mitigation task must have a unique client request token. If you try to start a new task with the same token as a task that already exists, an exception occurs. If you omit this value, a unique client request token is generated automatically.

Instances

Instances details
ToJSON StartAuditMitigationActionsTask Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

ToHeaders StartAuditMitigationActionsTask Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

ToPath StartAuditMitigationActionsTask Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

ToQuery StartAuditMitigationActionsTask Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

AWSRequest StartAuditMitigationActionsTask Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

Generic StartAuditMitigationActionsTask Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

Associated Types

type Rep StartAuditMitigationActionsTask :: Type -> Type #

Read StartAuditMitigationActionsTask Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

Show StartAuditMitigationActionsTask Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

NFData StartAuditMitigationActionsTask Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

Eq StartAuditMitigationActionsTask Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

Hashable StartAuditMitigationActionsTask Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

type AWSResponse StartAuditMitigationActionsTask Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

type Rep StartAuditMitigationActionsTask Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

type Rep StartAuditMitigationActionsTask = D1 ('MetaData "StartAuditMitigationActionsTask" "Amazonka.IoT.StartAuditMitigationActionsTask" "amazonka-iot-2.0-6w03vgAfmrM1SG22OsNJXL" 'False) (C1 ('MetaCons "StartAuditMitigationActionsTask'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "taskId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "target") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 AuditMitigationActionsTaskTarget)) :*: (S1 ('MetaSel ('Just "auditCheckToActionsMapping") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (HashMap Text (NonEmpty Text))) :*: S1 ('MetaSel ('Just "clientRequestToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))))

newStartAuditMitigationActionsTask Source #

Create a value of StartAuditMitigationActionsTask with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

StartAuditMitigationActionsTask, startAuditMitigationActionsTask_taskId - A unique identifier for the task. You can use this identifier to check the status of the task or to cancel it.

StartAuditMitigationActionsTask, startAuditMitigationActionsTask_target - Specifies the audit findings to which the mitigation actions are applied. You can apply them to a type of audit check, to all findings from an audit, or to a specific set of findings.

$sel:auditCheckToActionsMapping:StartAuditMitigationActionsTask', startAuditMitigationActionsTask_auditCheckToActionsMapping - For an audit check, specifies which mitigation actions to apply. Those actions must be defined in your Amazon Web Services accounts.

$sel:clientRequestToken:StartAuditMitigationActionsTask', startAuditMitigationActionsTask_clientRequestToken - Each audit mitigation task must have a unique client request token. If you try to start a new task with the same token as a task that already exists, an exception occurs. If you omit this value, a unique client request token is generated automatically.

Request Lenses

startAuditMitigationActionsTask_taskId :: Lens' StartAuditMitigationActionsTask Text Source #

A unique identifier for the task. You can use this identifier to check the status of the task or to cancel it.

startAuditMitigationActionsTask_target :: Lens' StartAuditMitigationActionsTask AuditMitigationActionsTaskTarget Source #

Specifies the audit findings to which the mitigation actions are applied. You can apply them to a type of audit check, to all findings from an audit, or to a specific set of findings.

startAuditMitigationActionsTask_auditCheckToActionsMapping :: Lens' StartAuditMitigationActionsTask (HashMap Text (NonEmpty Text)) Source #

For an audit check, specifies which mitigation actions to apply. Those actions must be defined in your Amazon Web Services accounts.

startAuditMitigationActionsTask_clientRequestToken :: Lens' StartAuditMitigationActionsTask Text Source #

Each audit mitigation task must have a unique client request token. If you try to start a new task with the same token as a task that already exists, an exception occurs. If you omit this value, a unique client request token is generated automatically.

Destructuring the Response

data StartAuditMitigationActionsTaskResponse Source #

Constructors

StartAuditMitigationActionsTaskResponse' 

Fields

  • taskId :: Maybe Text

    The unique identifier for the audit mitigation task. This matches the taskId that you specified in the request.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Generic StartAuditMitigationActionsTaskResponse Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

Read StartAuditMitigationActionsTaskResponse Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

Show StartAuditMitigationActionsTaskResponse Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

NFData StartAuditMitigationActionsTaskResponse Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

Eq StartAuditMitigationActionsTaskResponse Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

type Rep StartAuditMitigationActionsTaskResponse Source # 
Instance details

Defined in Amazonka.IoT.StartAuditMitigationActionsTask

type Rep StartAuditMitigationActionsTaskResponse = D1 ('MetaData "StartAuditMitigationActionsTaskResponse" "Amazonka.IoT.StartAuditMitigationActionsTask" "amazonka-iot-2.0-6w03vgAfmrM1SG22OsNJXL" 'False) (C1 ('MetaCons "StartAuditMitigationActionsTaskResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "taskId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newStartAuditMitigationActionsTaskResponse Source #

Create a value of StartAuditMitigationActionsTaskResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

StartAuditMitigationActionsTask, startAuditMitigationActionsTaskResponse_taskId - The unique identifier for the audit mitigation task. This matches the taskId that you specified in the request.

$sel:httpStatus:StartAuditMitigationActionsTaskResponse', startAuditMitigationActionsTaskResponse_httpStatus - The response's http status code.

Response Lenses

startAuditMitigationActionsTaskResponse_taskId :: Lens' StartAuditMitigationActionsTaskResponse (Maybe Text) Source #

The unique identifier for the audit mitigation task. This matches the taskId that you specified in the request.