Skip to content

GlacierJobDescription

Source code in docs_src/capo_glacier/types/glacier_job_description.py
class GlacierJobDescription(TypedDict, closed=True):
    job_id: NotRequired["capo_glacier.types.string.string"]
    """<p>An opaque string that identifies an Amazon S3 Glacier job.</p>"""
    job_description: NotRequired["capo_glacier.types.string.string"]
    """<p>The job description provided when initiating the job.</p>"""
    action: NotRequired["capo_glacier.types.action_code.ActionCode"]
    """<p>The job type. This value is either <code>ArchiveRetrieval</code>, <code>InventoryRetrieval</code>, or <code>Select</code>. </p>"""
    archive_id: NotRequired["capo_glacier.types.string.string"]
    """<p>The archive ID requested for a select job or archive retrieval. Otherwise, this field is null.</p>"""
    vault_arn: NotRequired["capo_glacier.types.string.string"]
    """<p>The Amazon Resource Name (ARN) of the vault from which an archive retrieval was requested.</p>"""
    creation_date: NotRequired["capo_glacier.types.string.string"]
    """<p>The UTC date when the job was created. This value is a string representation of ISO 8601 date format, for example <code>"2012-03-20T17:03:43.221Z"</code>.</p>"""
    completed: "capo_glacier.types.boolean.boolean"
    """<p>The job status. When a job is completed, you get the job's output using Get Job Output (GET output).</p>"""
    status_code: NotRequired["capo_glacier.types.status_code.StatusCode"]
    """<p>The status code can be <code>InProgress</code>, <code>Succeeded</code>, or <code>Failed</code>, and indicates the status of the job.</p>"""
    status_message: NotRequired["capo_glacier.types.string.string"]
    """<p>A friendly message that describes the job status.</p>"""
    archive_size_in_bytes: NotRequired["capo_glacier.types.size.Size"]
    """<p>For an archive retrieval job, this value is the size in bytes of the archive being requested for download. For an inventory retrieval or select job, this value is null.</p>"""
    inventory_size_in_bytes: NotRequired["capo_glacier.types.size.Size"]
    """<p>For an inventory retrieval job, this value is the size in bytes of the inventory requested for download. For an archive retrieval or select job, this value is null.</p>"""
    sns_topic: NotRequired["capo_glacier.types.string.string"]
    """<p>An Amazon SNS topic that receives notification.</p>"""
    completion_date: NotRequired["capo_glacier.types.string.string"]
    """<p>The UTC time that the job request completed. While the job is in progress, the value is null.</p>"""
    sha256_tree_hash: NotRequired["capo_glacier.types.string.string"]
    """<p>For an archive retrieval job, this value is the checksum of the archive. Otherwise, this value is null.</p> <p>The SHA256 tree hash value for the requested range of an archive. If the <b>InitiateJob</b> request for an archive specified a tree-hash aligned range, then this field returns a value.</p> <p>If the whole archive is retrieved, this value is the same as the ArchiveSHA256TreeHash value.</p> <p>This field is null for the following:</p> <ul> <li> <p>Archive retrieval jobs that specify a range that is not tree-hash aligned</p> </li> </ul> <ul> <li> <p>Archival jobs that specify a range that is equal to the whole archive, when the job status is <code>InProgress</code> </p> </li> </ul> <ul> <li> <p>Inventory jobs</p> </li> <li> <p>Select jobs</p> </li> </ul>"""
    archive_sha256_tree_hash: NotRequired["capo_glacier.types.string.string"]
    """<p>The SHA256 tree hash of the entire archive for an archive retrieval. For inventory retrieval or select jobs, this field is null.</p>"""
    retrieval_byte_range: NotRequired["capo_glacier.types.string.string"]
    """<p>The retrieved byte range for archive retrieval jobs in the form <i>StartByteValue</i>-<i>EndByteValue</i>. If no range was specified in the archive retrieval, then the whole archive is retrieved. In this case, <i>StartByteValue</i> equals 0 and <i>EndByteValue</i> equals the size of the archive minus 1. For inventory retrieval or select jobs, this field is null. </p>"""
    tier: NotRequired["capo_glacier.types.string.string"]
    """<p>The tier to use for a select or an archive retrieval. Valid values are <code>Expedited</code>, <code>Standard</code>, or <code>Bulk</code>. <code>Standard</code> is the default.</p>"""
    inventory_retrieval_parameters: NotRequired[
        "capo_glacier.types.inventory_retrieval_job_description.InventoryRetrievalJobDescription"
    ]
    """<p>Parameters used for range inventory retrieval.</p>"""
    job_output_path: NotRequired["capo_glacier.types.string.string"]
    """<p>Contains the job output location.</p>"""
    select_parameters: NotRequired[
        "capo_glacier.types.select_parameters.SelectParameters"
    ]
    """<p>Contains the parameters used for a select.</p>"""
    output_location: NotRequired["capo_glacier.types.output_location.OutputLocation"]
    """<p>Contains the location where the data from the select job is stored.</p>"""

action instance-attribute

action: NotRequired[ActionCode]

The job type. This value is either ArchiveRetrieval, InventoryRetrieval, or Select.

archive_id instance-attribute

archive_id: NotRequired[string]

The archive ID requested for a select job or archive retrieval. Otherwise, this field is null.

archive_sha256_tree_hash instance-attribute

archive_sha256_tree_hash: NotRequired[string]

The SHA256 tree hash of the entire archive for an archive retrieval. For inventory retrieval or select jobs, this field is null.

archive_size_in_bytes instance-attribute

archive_size_in_bytes: NotRequired[Size]

For an archive retrieval job, this value is the size in bytes of the archive being requested for download. For an inventory retrieval or select job, this value is null.

completed instance-attribute

completed: boolean

The job status. When a job is completed, you get the job's output using Get Job Output (GET output).

completion_date instance-attribute

completion_date: NotRequired[string]

The UTC time that the job request completed. While the job is in progress, the value is null.

creation_date instance-attribute

creation_date: NotRequired[string]

The UTC date when the job was created. This value is a string representation of ISO 8601 date format, for example "2012-03-20T17:03:43.221Z".

inventory_retrieval_parameters instance-attribute

inventory_retrieval_parameters: NotRequired[InventoryRetrievalJobDescription]

Parameters used for range inventory retrieval.

inventory_size_in_bytes instance-attribute

inventory_size_in_bytes: NotRequired[Size]

For an inventory retrieval job, this value is the size in bytes of the inventory requested for download. For an archive retrieval or select job, this value is null.

job_description instance-attribute

job_description: NotRequired[string]

The job description provided when initiating the job.

job_id instance-attribute

job_id: NotRequired[string]

An opaque string that identifies an Amazon S3 Glacier job.

job_output_path instance-attribute

job_output_path: NotRequired[string]

Contains the job output location.

output_location instance-attribute

output_location: NotRequired[OutputLocation]

Contains the location where the data from the select job is stored.

retrieval_byte_range instance-attribute

retrieval_byte_range: NotRequired[string]

The retrieved byte range for archive retrieval jobs in the form StartByteValue-EndByteValue. If no range was specified in the archive retrieval, then the whole archive is retrieved. In this case, StartByteValue equals 0 and EndByteValue equals the size of the archive minus 1. For inventory retrieval or select jobs, this field is null.

select_parameters instance-attribute

select_parameters: NotRequired[SelectParameters]

Contains the parameters used for a select.

sha256_tree_hash instance-attribute

sha256_tree_hash: NotRequired[string]

For an archive retrieval job, this value is the checksum of the archive. Otherwise, this value is null.

The SHA256 tree hash value for the requested range of an archive. If the InitiateJob request for an archive specified a tree-hash aligned range, then this field returns a value.

If the whole archive is retrieved, this value is the same as the ArchiveSHA256TreeHash value.

This field is null for the following:

  • Archive retrieval jobs that specify a range that is not tree-hash aligned

  • Archival jobs that specify a range that is equal to the whole archive, when the job status is InProgress

  • Inventory jobs

  • Select jobs

sns_topic instance-attribute

sns_topic: NotRequired[string]

An Amazon SNS topic that receives notification.

status_code instance-attribute

status_code: NotRequired[StatusCode]

The status code can be InProgress, Succeeded, or Failed, and indicates the status of the job.

status_message instance-attribute

status_message: NotRequired[string]

A friendly message that describes the job status.

tier instance-attribute

tier: NotRequired[string]

The tier to use for a select or an archive retrieval. Valid values are Expedited, Standard, or Bulk. Standard is the default.

vault_arn instance-attribute

vault_arn: NotRequired[string]

The Amazon Resource Name (ARN) of the vault from which an archive retrieval was requested.