Skip to content

DescribeClassificationJobResponse

Source code in docs_src/capo_macie2/types/describe_classification_job_response.py
class DescribeClassificationJobResponse(TypedDict, closed=True):
    allow_list_ids: NotRequired["capo_macie2.types.__list_of__string.__listOf__string"]
    """<p>An array of unique identifiers, one for each allow list that the job is configured to use when it analyzes data.</p>"""
    client_token: NotRequired["capo_macie2.types.__string.__string"]
    """<p>The token that was provided to ensure the idempotency of the request to create the job.</p>"""
    created_at: NotRequired["capo_macie2.types.__timestamp_iso8601.__timestampIso8601"]
    """<p>The date and time, in UTC and extended ISO 8601 format, when the job was created.</p>"""
    custom_data_identifier_ids: NotRequired[
        "capo_macie2.types.__list_of__string.__listOf__string"
    ]
    """<p>An array of unique identifiers, one for each custom data identifier that the job is configured to use when it analyzes data. This value is null if the job is configured to use only managed data identifiers to analyze data.</p>"""
    description: NotRequired["capo_macie2.types.__string.__string"]
    """<p>The custom description of the job.</p>"""
    initial_run: NotRequired["capo_macie2.types.__boolean.__boolean"]
    """<p>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.</p>"""
    job_arn: NotRequired["capo_macie2.types.__string.__string"]
    """<p>The Amazon Resource Name (ARN) of the job.</p>"""
    job_id: NotRequired["capo_macie2.types.__string.__string"]
    """<p>The unique identifier for the job.</p>"""
    job_status: NotRequired["capo_macie2.types.job_status.JobStatus"]
    """<p>The current status of the job. Possible values are:</p> <ul><li><p>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.</p></li> <li><p>COMPLETE - For a one-time job, Amazon Macie finished processing the data specified for the job. This value doesn't apply to recurring jobs.</p></li> <li><p>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.</p></li> <li><p>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.</p></li> <li><p>RUNNING - For a one-time job, the job is in progress. For a recurring job, a scheduled run is in progress.</p></li> <li><p>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.</p></li></ul>"""
    job_type: NotRequired["capo_macie2.types.job_type.JobType"]
    """<p>The schedule for running the job. Possible values are:</p> <ul><li><p>ONE_TIME - The job runs only once.</p></li> <li><p>SCHEDULED - The job runs on a daily, weekly, or monthly basis. The scheduleFrequency property indicates the recurrence pattern for the job.</p></li></ul>"""
    last_run_error_status: NotRequired[
        "capo_macie2.types.last_run_error_status.LastRunErrorStatus"
    ]
    """<p>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.</p>"""
    last_run_time: NotRequired[
        "capo_macie2.types.__timestamp_iso8601.__timestampIso8601"
    ]
    """<p>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.</p>"""
    managed_data_identifier_ids: NotRequired[
        "capo_macie2.types.__list_of__string.__listOf__string"
    ]
    """<p>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).</p><p>This value is null if the job's managed data identifier selection type is ALL, NONE, or RECOMMENDED.</p>"""
    managed_data_identifier_selector: NotRequired[
        "capo_macie2.types.managed_data_identifier_selector.ManagedDataIdentifierSelector"
    ]
    """<p>The selection type that determines which managed data identifiers the job uses when it analyzes data. Possible values are:</p> <ul><li><p>ALL - Use all managed data identifiers.</p></li> <li><p>EXCLUDE - Use all managed data identifiers except the ones specified by the managedDataIdentifierIds property.</p></li> <li><p>INCLUDE - Use only the managed data identifiers specified by the managedDataIdentifierIds property.</p></li> <li><p>NONE - Don't use any managed data identifiers. Use only custom data identifiers (customDataIdentifierIds).</p></li> <li><p>RECOMMENDED (default) - Use the recommended set of managed data identifiers.</p></li></ul> <p>If this value is null, the job uses the recommended set of managed data identifiers.</p> <p>If the job is a recurring job and this value is ALL or EXCLUDE, each job run automatically uses new managed data identifiers that are released. If this value is null or RECOMMENDED for a recurring job, each job run uses all the managed data identifiers that are in the recommended set when the run starts.</p> <p>To learn about individual managed data identifiers or determine which ones are in the recommended set, see <a href="https://docs.aws.amazon.com/macie/latest/user/managed-data-identifiers.html">Using managed data identifiers</a> or <a href="https://docs.aws.amazon.com/macie/latest/user/discovery-jobs-mdis-recommended.html">Recommended managed data identifiers</a> in the <i>Amazon Macie User Guide</i>.</p>"""
    name: NotRequired["capo_macie2.types.__string.__string"]
    """<p>The custom name of the job.</p>"""
    s3_job_definition: NotRequired[
        "capo_macie2.types.s3_job_definition.S3JobDefinition"
    ]
    """<p>The S3 buckets that contain the objects to analyze, and the scope of that analysis.</p>"""
    sampling_percentage: NotRequired["capo_macie2.types.__integer.__integer"]
    """<p>The sampling depth, as a percentage, that determines the percentage of eligible objects that the job analyzes.</p>"""
    schedule_frequency: NotRequired[
        "capo_macie2.types.job_schedule_frequency.JobScheduleFrequency"
    ]
    """<p>The recurrence pattern for running the job. This value is null if the job is configured to run only once.</p>"""
    statistics: NotRequired["capo_macie2.types.statistics.Statistics"]
    """<p>The number of times that the job has run and processing statistics for the job's current run.</p>"""
    tags: NotRequired["capo_macie2.types.tag_map.TagMap"]
    """<p>A map of key-value pairs that specifies which tags (keys and values) are associated with the job.</p>"""
    user_paused_details: NotRequired[
        "capo_macie2.types.user_paused_details.UserPausedDetails"
    ]
    """<p>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.</p>"""

allow_list_ids instance-attribute

allow_list_ids: NotRequired[__listOf__string]

An array of unique identifiers, one for each allow list that the job is configured to use when it analyzes data.

client_token instance-attribute

client_token: NotRequired[__string]

The token that was provided to ensure the idempotency of the request to create the job.

created_at instance-attribute

created_at: NotRequired[__timestampIso8601]

The date and time, in UTC and extended ISO 8601 format, when the job was created.

custom_data_identifier_ids instance-attribute

custom_data_identifier_ids: NotRequired[__listOf__string]

An array of unique identifiers, one for each custom data identifier that the job is configured to use when it analyzes data. This value is null if the job is configured to use only managed data identifiers to analyze data.

description instance-attribute

description: NotRequired[__string]

The custom description of the job.

initial_run instance-attribute

initial_run: NotRequired[__boolean]

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.

job_arn instance-attribute

job_arn: NotRequired[__string]

The Amazon Resource Name (ARN) of the job.

job_id instance-attribute

job_id: NotRequired[__string]

The unique identifier for the job.

job_status instance-attribute

job_status: NotRequired[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.

job_type instance-attribute

job_type: NotRequired[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.

last_run_error_status instance-attribute

last_run_error_status: NotRequired[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.

last_run_time instance-attribute

last_run_time: NotRequired[__timestampIso8601]

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.

managed_data_identifier_ids instance-attribute

managed_data_identifier_ids: NotRequired[__listOf__string]

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, NONE, or RECOMMENDED.

managed_data_identifier_selector instance-attribute

managed_data_identifier_selector: NotRequired[ManagedDataIdentifierSelector]

The selection type that determines which managed data identifiers the job uses when it analyzes data. Possible values are:

  • ALL - Use all managed data identifiers.

  • EXCLUDE - Use all managed data identifiers except the ones 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. Use only custom data identifiers (customDataIdentifierIds).

  • RECOMMENDED (default) - Use the recommended set of managed data identifiers.

If this value is null, the job uses the recommended set of managed data identifiers.

If the job is a recurring job and this value is ALL or EXCLUDE, each job run automatically uses new managed data identifiers that are released. If this value is null or RECOMMENDED for a recurring job, each job run uses all the managed data identifiers that are in the recommended set when the run starts.

To learn about individual managed data identifiers or determine which ones are in the recommended set, see Using managed data identifiers or Recommended managed data identifiers in the Amazon Macie User Guide.

name instance-attribute

name: NotRequired[__string]

The custom name of the job.

s3_job_definition instance-attribute

s3_job_definition: NotRequired[S3JobDefinition]

The S3 buckets that contain the objects to analyze, and the scope of that analysis.

sampling_percentage instance-attribute

sampling_percentage: NotRequired[__integer]

The sampling depth, as a percentage, that determines the percentage of eligible objects that the job analyzes.

schedule_frequency instance-attribute

schedule_frequency: NotRequired[JobScheduleFrequency]

The recurrence pattern for running the job. This value is null if the job is configured to run only once.

statistics instance-attribute

statistics: NotRequired[Statistics]

The number of times that the job has run and processing statistics for the job's current run.

tags instance-attribute

tags: NotRequired[TagMap]

A map of key-value pairs that specifies which tags (keys and values) are associated with the job.

user_paused_details instance-attribute

user_paused_details: NotRequired[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.