You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.

Class: Aws::Glacier::Types::JobParameters

Inherits:
Struct
  • Object
show all
Defined in:
(unknown)

Overview

Note:

When passing JobParameters as input to an Aws::Client method, you can use a vanilla Hash:

{
  format: "string",
  type: "string",
  archive_id: "string",
  description: "string",
  sns_topic: "string",
  retrieval_byte_range: "string",
  tier: "string",
  inventory_retrieval_parameters: {
    start_date: Time.now,
    end_date: Time.now,
    limit: "string",
    marker: "string",
  },
}

Provides options for defining a job.

Returned by:

Instance Attribute Summary collapse

Instance Attribute Details

#archive_idString

The ID of the archive that you want to retrieve. This field is required only if Type is set to archive-retrieval. An error occurs if you specify this request parameter for an inventory retrieval job request.

Returns:

  • (String)

    The ID of the archive that you want to retrieve.

#descriptionString

The optional description for the job. The description must be less than or equal to 1,024 bytes. The allowable characters are 7-bit ASCII without control codes-specifically, ASCII values 32-126 decimal or 0x20-0x7E hexadecimal.

Returns:

  • (String)

    The optional description for the job.

#formatString

When initiating a job to retrieve a vault inventory, you can optionally add this parameter to your request to specify the output format. If you are initiating an inventory job and do not specify a Format field, JSON is the default format. Valid values are \"CSV\" and \"JSON\".

Returns:

  • (String)

    When initiating a job to retrieve a vault inventory, you can optionally add this parameter to your request to specify the output format.

#inventory_retrieval_parametersTypes::InventoryRetrievalJobInput

Input parameters used for range inventory retrieval.

Returns:

#retrieval_byte_rangeString

The byte range to retrieve for an archive retrieval. in the form \"StartByteValue-EndByteValue\" If not specified, the whole archive is retrieved. If specified, the byte range must be megabyte (1024*1024) aligned which means that StartByteValue must be divisible by 1 MB and EndByteValue plus 1 must be divisible by 1 MB or be the end of the archive specified as the archive byte size value minus 1. If RetrievalByteRange is not megabyte aligned, this operation returns a 400 response.

An error occurs if you specify this field for an inventory retrieval job request.

Returns:

  • (String)

    The byte range to retrieve for an archive retrieval.

#sns_topicString

The Amazon SNS topic ARN to which Amazon Glacier sends a notification when the job is completed and the output is ready for you to download. The specified topic publishes the notification to its subscribers. The SNS topic must exist.

Returns:

  • (String)

    The Amazon SNS topic ARN to which Amazon Glacier sends a notification when the job is completed and the output is ready for you to download.

#tierString

The retrieval option to use for the archive retrieval. Valid values are Expedited, Standard, or Bulk. Standard is the default.

Returns:

  • (String)

    The retrieval option to use for the archive retrieval.

#typeString

The job type. You can initiate a job to retrieve an archive or get an inventory of a vault. Valid values are \"archive-retrieval\" and \"inventory-retrieval\".

Returns:

  • (String)

    The job type.