Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
Retrieves the status and settings for a classification job.
Synopsis
- data DescribeClassificationJob = DescribeClassificationJob' {}
- newDescribeClassificationJob :: Text -> DescribeClassificationJob
- describeClassificationJob_jobId :: Lens' DescribeClassificationJob Text
- data DescribeClassificationJobResponse = DescribeClassificationJobResponse' {
- allowListIds :: Maybe [Text]
- clientToken :: Maybe Text
- createdAt :: Maybe ISO8601
- customDataIdentifierIds :: Maybe [Text]
- description :: Maybe Text
- initialRun :: Maybe Bool
- jobArn :: Maybe Text
- jobId :: Maybe Text
- jobStatus :: Maybe JobStatus
- jobType :: Maybe JobType
- lastRunErrorStatus :: Maybe LastRunErrorStatus
- lastRunTime :: Maybe ISO8601
- managedDataIdentifierIds :: Maybe [Text]
- managedDataIdentifierSelector :: Maybe ManagedDataIdentifierSelector
- name :: Maybe Text
- s3JobDefinition :: Maybe S3JobDefinition
- samplingPercentage :: Maybe Int
- scheduleFrequency :: Maybe JobScheduleFrequency
- statistics :: Maybe Statistics
- tags :: Maybe (HashMap Text Text)
- userPausedDetails :: Maybe UserPausedDetails
- httpStatus :: Int
- newDescribeClassificationJobResponse :: Int -> DescribeClassificationJobResponse
- describeClassificationJobResponse_allowListIds :: Lens' DescribeClassificationJobResponse (Maybe [Text])
- describeClassificationJobResponse_clientToken :: Lens' DescribeClassificationJobResponse (Maybe Text)
- describeClassificationJobResponse_createdAt :: Lens' DescribeClassificationJobResponse (Maybe UTCTime)
- describeClassificationJobResponse_customDataIdentifierIds :: Lens' DescribeClassificationJobResponse (Maybe [Text])
- describeClassificationJobResponse_description :: Lens' DescribeClassificationJobResponse (Maybe Text)
- describeClassificationJobResponse_initialRun :: Lens' DescribeClassificationJobResponse (Maybe Bool)
- describeClassificationJobResponse_jobArn :: Lens' DescribeClassificationJobResponse (Maybe Text)
- describeClassificationJobResponse_jobId :: Lens' DescribeClassificationJobResponse (Maybe Text)
- describeClassificationJobResponse_jobStatus :: Lens' DescribeClassificationJobResponse (Maybe JobStatus)
- describeClassificationJobResponse_jobType :: Lens' DescribeClassificationJobResponse (Maybe JobType)
- describeClassificationJobResponse_lastRunErrorStatus :: Lens' DescribeClassificationJobResponse (Maybe LastRunErrorStatus)
- describeClassificationJobResponse_lastRunTime :: Lens' DescribeClassificationJobResponse (Maybe UTCTime)
- describeClassificationJobResponse_managedDataIdentifierIds :: Lens' DescribeClassificationJobResponse (Maybe [Text])
- describeClassificationJobResponse_managedDataIdentifierSelector :: Lens' DescribeClassificationJobResponse (Maybe ManagedDataIdentifierSelector)
- describeClassificationJobResponse_name :: Lens' DescribeClassificationJobResponse (Maybe Text)
- describeClassificationJobResponse_s3JobDefinition :: Lens' DescribeClassificationJobResponse (Maybe S3JobDefinition)
- describeClassificationJobResponse_samplingPercentage :: Lens' DescribeClassificationJobResponse (Maybe Int)
- describeClassificationJobResponse_scheduleFrequency :: Lens' DescribeClassificationJobResponse (Maybe JobScheduleFrequency)
- describeClassificationJobResponse_statistics :: Lens' DescribeClassificationJobResponse (Maybe Statistics)
- describeClassificationJobResponse_tags :: Lens' DescribeClassificationJobResponse (Maybe (HashMap Text Text))
- describeClassificationJobResponse_userPausedDetails :: Lens' DescribeClassificationJobResponse (Maybe UserPausedDetails)
- describeClassificationJobResponse_httpStatus :: Lens' DescribeClassificationJobResponse Int
Creating a Request
data DescribeClassificationJob Source #
See: newDescribeClassificationJob
smart constructor.
Instances
newDescribeClassificationJob Source #
Create a value of DescribeClassificationJob
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:
DescribeClassificationJob
, describeClassificationJob_jobId
- The unique identifier for the classification job.
Request Lenses
describeClassificationJob_jobId :: Lens' DescribeClassificationJob Text Source #
The unique identifier for the classification job.
Destructuring the Response
data DescribeClassificationJobResponse Source #
See: newDescribeClassificationJobResponse
smart constructor.
DescribeClassificationJobResponse' | |
|
Instances
newDescribeClassificationJobResponse Source #
Create a value of DescribeClassificationJobResponse
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:
DescribeClassificationJobResponse
, describeClassificationJobResponse_allowListIds
- An array of unique identifiers, one for each allow list that the job
uses when it analyzes data.
$sel:clientToken:DescribeClassificationJobResponse'
, describeClassificationJobResponse_clientToken
- The token that was provided to ensure the idempotency of the request to
create the job.
DescribeClassificationJobResponse
, describeClassificationJobResponse_createdAt
- The date and time, in UTC and extended ISO 8601 format, when the job was
created.
DescribeClassificationJobResponse
, describeClassificationJobResponse_customDataIdentifierIds
- An array of unique identifiers, one for each custom data identifier that
the job uses when it analyzes data. This value is null if the job uses
only managed data identifiers to analyze data.
DescribeClassificationJobResponse
, describeClassificationJobResponse_description
- The custom description of the job.
$sel:initialRun:DescribeClassificationJobResponse'
, describeClassificationJobResponse_initialRun
- For a recurring job, specifies whether you configured the job to analyze
all existing, eligible objects immediately after the job was created
(true). If you configured the job to analyze only those objects that
were created or changed after the job was created and before the job's
first scheduled run, this value is false. This value is also false for a
one-time job.
DescribeClassificationJobResponse
, describeClassificationJobResponse_jobArn
- The Amazon Resource Name (ARN) of the job.
DescribeClassificationJob
, describeClassificationJobResponse_jobId
- The unique identifier for the job.
DescribeClassificationJobResponse
, describeClassificationJobResponse_jobStatus
- The current status of the job. Possible values are:
- CANCELLED - You cancelled the job or, if it's a one-time job, you paused the job and didn't resume it within 30 days.
- COMPLETE - For a one-time job, Amazon Macie finished processing the data specified for the job. This value doesn't apply to recurring jobs.
- IDLE - For a recurring job, the previous scheduled run is complete and the next scheduled run is pending. This value doesn't apply to one-time jobs.
- PAUSED - Macie started running the job but additional processing would exceed the monthly sensitive data discovery quota for your account or one or more member accounts that the job analyzes data for.
- RUNNING - For a one-time job, the job is in progress. For a recurring job, a scheduled run is in progress.
- USER_PAUSED - You paused the job. If you paused the job while it had a status of RUNNING and you don't resume it within 30 days of pausing it, the job or job run will expire and be cancelled, depending on the job's type. To check the expiration date, refer to the UserPausedDetails.jobExpiresAt property.
DescribeClassificationJobResponse
, describeClassificationJobResponse_jobType
- The schedule for running the job. Possible values are:
- ONE_TIME - The job runs only once.
- SCHEDULED - The job runs on a daily, weekly, or monthly basis. The scheduleFrequency property indicates the recurrence pattern for the job.
DescribeClassificationJobResponse
, describeClassificationJobResponse_lastRunErrorStatus
- Specifies whether any account- or bucket-level access errors occurred
when the job ran. For a recurring job, this value indicates the error
status of the job's most recent run.
$sel:lastRunTime:DescribeClassificationJobResponse'
, describeClassificationJobResponse_lastRunTime
- The date and time, in UTC and extended ISO 8601 format, when the job
started. If the job is a recurring job, this value indicates when the
most recent run started or, if the job hasn't run yet, when the job was
created.
DescribeClassificationJobResponse
, describeClassificationJobResponse_managedDataIdentifierIds
- An array of unique identifiers, one for each managed data identifier
that the job is explicitly configured to include (use) or exclude (not
use) when it analyzes data. Inclusion or exclusion depends on the
managed data identifier selection type specified for the job
(managedDataIdentifierSelector). This value is null if the job's
managed data identifier selection type is ALL or the job uses only
custom data identifiers (customDataIdentifierIds) to analyze data.
$sel:managedDataIdentifierSelector:DescribeClassificationJobResponse'
, describeClassificationJobResponse_managedDataIdentifierSelector
- The selection type that determines which managed data identifiers the
job uses to analyze data. Possible values are:
- ALL - Use all the managed data identifiers that Amazon Macie provides.
- EXCLUDE - Use all the managed data identifiers that Macie provides except the managed data identifiers specified by the managedDataIdentifierIds property.
- INCLUDE - Use only the managed data identifiers specified by the managedDataIdentifierIds property.
- NONE - Don't use any managed data identifiers.
If this value is null, the job uses all managed data identifiers. If this value is null, ALL, or EXCLUDE for a recurring job, the job also uses new managed data identifiers as they are released.
DescribeClassificationJobResponse
, describeClassificationJobResponse_name
- The custom name of the job.
$sel:s3JobDefinition:DescribeClassificationJobResponse'
, describeClassificationJobResponse_s3JobDefinition
- The S3 buckets that contain the objects to analyze, and the scope of
that analysis.
$sel:samplingPercentage:DescribeClassificationJobResponse'
, describeClassificationJobResponse_samplingPercentage
- The sampling depth, as a percentage, that determines the percentage of
eligible objects that the job analyzes.
$sel:scheduleFrequency:DescribeClassificationJobResponse'
, describeClassificationJobResponse_scheduleFrequency
- The recurrence pattern for running the job. This value is null if the
job is configured to run only once.
$sel:statistics:DescribeClassificationJobResponse'
, describeClassificationJobResponse_statistics
- The number of times that the job has run and processing statistics for
the job's current run.
DescribeClassificationJobResponse
, describeClassificationJobResponse_tags
- A map of key-value pairs that specifies which tags (keys and values) are
associated with the classification job.
DescribeClassificationJobResponse
, describeClassificationJobResponse_userPausedDetails
- If the current status of the job is USER_PAUSED, specifies when the job
was paused and when the job or job run will expire and be cancelled if
it isn't resumed. This value is present only if the value for jobStatus
is USER_PAUSED.
$sel:httpStatus:DescribeClassificationJobResponse'
, describeClassificationJobResponse_httpStatus
- The response's http status code.
Response Lenses
describeClassificationJobResponse_allowListIds :: Lens' DescribeClassificationJobResponse (Maybe [Text]) Source #
An array of unique identifiers, one for each allow list that the job uses when it analyzes data.
describeClassificationJobResponse_clientToken :: Lens' DescribeClassificationJobResponse (Maybe Text) Source #
The token that was provided to ensure the idempotency of the request to create the job.
describeClassificationJobResponse_createdAt :: Lens' DescribeClassificationJobResponse (Maybe UTCTime) Source #
The date and time, in UTC and extended ISO 8601 format, when the job was created.
describeClassificationJobResponse_customDataIdentifierIds :: Lens' DescribeClassificationJobResponse (Maybe [Text]) Source #
An array of unique identifiers, one for each custom data identifier that the job uses when it analyzes data. This value is null if the job uses only managed data identifiers to analyze data.
describeClassificationJobResponse_description :: Lens' DescribeClassificationJobResponse (Maybe Text) Source #
The custom description of the job.
describeClassificationJobResponse_initialRun :: Lens' DescribeClassificationJobResponse (Maybe Bool) Source #
For a recurring job, specifies whether you configured the job to analyze all existing, eligible objects immediately after the job was created (true). If you configured the job to analyze only those objects that were created or changed after the job was created and before the job's first scheduled run, this value is false. This value is also false for a one-time job.
describeClassificationJobResponse_jobArn :: Lens' DescribeClassificationJobResponse (Maybe Text) Source #
The Amazon Resource Name (ARN) of the job.
describeClassificationJobResponse_jobId :: Lens' DescribeClassificationJobResponse (Maybe Text) Source #
The unique identifier for the job.
describeClassificationJobResponse_jobStatus :: Lens' DescribeClassificationJobResponse (Maybe JobStatus) Source #
The current status of the job. Possible values are:
- CANCELLED - You cancelled the job or, if it's a one-time job, you paused the job and didn't resume it within 30 days.
- COMPLETE - For a one-time job, Amazon Macie finished processing the data specified for the job. This value doesn't apply to recurring jobs.
- IDLE - For a recurring job, the previous scheduled run is complete and the next scheduled run is pending. This value doesn't apply to one-time jobs.
- PAUSED - Macie started running the job but additional processing would exceed the monthly sensitive data discovery quota for your account or one or more member accounts that the job analyzes data for.
- RUNNING - For a one-time job, the job is in progress. For a recurring job, a scheduled run is in progress.
- USER_PAUSED - You paused the job. If you paused the job while it had a status of RUNNING and you don't resume it within 30 days of pausing it, the job or job run will expire and be cancelled, depending on the job's type. To check the expiration date, refer to the UserPausedDetails.jobExpiresAt property.
describeClassificationJobResponse_jobType :: Lens' DescribeClassificationJobResponse (Maybe JobType) Source #
The schedule for running the job. Possible values are:
- ONE_TIME - The job runs only once.
- SCHEDULED - The job runs on a daily, weekly, or monthly basis. The scheduleFrequency property indicates the recurrence pattern for the job.
describeClassificationJobResponse_lastRunErrorStatus :: Lens' DescribeClassificationJobResponse (Maybe LastRunErrorStatus) Source #
Specifies whether any account- or bucket-level access errors occurred when the job ran. For a recurring job, this value indicates the error status of the job's most recent run.
describeClassificationJobResponse_lastRunTime :: Lens' DescribeClassificationJobResponse (Maybe UTCTime) Source #
The date and time, in UTC and extended ISO 8601 format, when the job started. If the job is a recurring job, this value indicates when the most recent run started or, if the job hasn't run yet, when the job was created.
describeClassificationJobResponse_managedDataIdentifierIds :: Lens' DescribeClassificationJobResponse (Maybe [Text]) Source #
An array of unique identifiers, one for each managed data identifier that the job is explicitly configured to include (use) or exclude (not use) when it analyzes data. Inclusion or exclusion depends on the managed data identifier selection type specified for the job (managedDataIdentifierSelector). This value is null if the job's managed data identifier selection type is ALL or the job uses only custom data identifiers (customDataIdentifierIds) to analyze data.
describeClassificationJobResponse_managedDataIdentifierSelector :: Lens' DescribeClassificationJobResponse (Maybe ManagedDataIdentifierSelector) Source #
The selection type that determines which managed data identifiers the job uses to analyze data. Possible values are:
- ALL - Use all the managed data identifiers that Amazon Macie provides.
- EXCLUDE - Use all the managed data identifiers that Macie provides except the managed data identifiers specified by the managedDataIdentifierIds property.
- INCLUDE - Use only the managed data identifiers specified by the managedDataIdentifierIds property.
- NONE - Don't use any managed data identifiers.
If this value is null, the job uses all managed data identifiers. If this value is null, ALL, or EXCLUDE for a recurring job, the job also uses new managed data identifiers as they are released.
describeClassificationJobResponse_name :: Lens' DescribeClassificationJobResponse (Maybe Text) Source #
The custom name of the job.
describeClassificationJobResponse_s3JobDefinition :: Lens' DescribeClassificationJobResponse (Maybe S3JobDefinition) Source #
The S3 buckets that contain the objects to analyze, and the scope of that analysis.
describeClassificationJobResponse_samplingPercentage :: Lens' DescribeClassificationJobResponse (Maybe Int) Source #
The sampling depth, as a percentage, that determines the percentage of eligible objects that the job analyzes.
describeClassificationJobResponse_scheduleFrequency :: Lens' DescribeClassificationJobResponse (Maybe JobScheduleFrequency) Source #
The recurrence pattern for running the job. This value is null if the job is configured to run only once.
describeClassificationJobResponse_statistics :: Lens' DescribeClassificationJobResponse (Maybe Statistics) Source #
The number of times that the job has run and processing statistics for the job's current run.
describeClassificationJobResponse_tags :: Lens' DescribeClassificationJobResponse (Maybe (HashMap Text Text)) Source #
A map of key-value pairs that specifies which tags (keys and values) are associated with the classification job.
describeClassificationJobResponse_userPausedDetails :: Lens' DescribeClassificationJobResponse (Maybe UserPausedDetails) Source #
If the current status of the job is USER_PAUSED, specifies when the job was paused and when the job or job run will expire and be cancelled if it isn't resumed. This value is present only if the value for jobStatus is USER_PAUSED.
describeClassificationJobResponse_httpStatus :: Lens' DescribeClassificationJobResponse Int Source #
The response's http status code.