com.amazonaws.services.glacier.model

Class JobParameters

java.lang.Object

com.amazonaws.services.glacier.model.JobParameters

All Implemented Interfaces:

Serializable

public class JobParameters
extends Object
implements Serializable

Provides options for defining a job.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
JobParameters() Default constructor for a new JobParameters object.
JobParameters(String format, String type, String archiveId, String description) Constructs a new JobParameters object.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object obj)
String	getArchiveId() The ID of the archive that you want to retrieve.
String	getDescription() The optional description for the job.
String	getFormat() When initiating a job to retrieve a vault inventory, you can optionally add this parameter to your request to specify the output format.
InventoryRetrievalJobInput	getInventoryRetrievalParameters() Input parameters used for range inventory retrieval.
String	getRetrievalByteRange() The byte range to retrieve for an archive retrieval.
String	getSNSTopic() 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.
String	getType() The job type.
int	hashCode()
void	setArchiveId(String archiveId) The ID of the archive that you want to retrieve.
void	setDescription(String description) The optional description for the job.
void	setFormat(String format) When initiating a job to retrieve a vault inventory, you can optionally add this parameter to your request to specify the output format.
void	setInventoryRetrievalParameters(InventoryRetrievalJobInput inventoryRetrievalParameters) Input parameters used for range inventory retrieval.
void	setRetrievalByteRange(String retrievalByteRange) The byte range to retrieve for an archive retrieval.
void	setSNSTopic(String sNSTopic) 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.
void	setType(String type) The job type.
String	toString() Returns a string representation of this object; useful for testing and debugging.
JobParameters	withArchiveId(String archiveId) The ID of the archive that you want to retrieve.
JobParameters	withDescription(String description) The optional description for the job.
JobParameters	withFormat(String format) When initiating a job to retrieve a vault inventory, you can optionally add this parameter to your request to specify the output format.
JobParameters	withInventoryRetrievalParameters(InventoryRetrievalJobInput inventoryRetrievalParameters) Input parameters used for range inventory retrieval.
JobParameters	withRetrievalByteRange(String retrievalByteRange) The byte range to retrieve for an archive retrieval.
JobParameters	withSNSTopic(String sNSTopic) 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.
JobParameters	withType(String type) The job type.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

JobParameters

public JobParameters()

Default constructor for a new JobParameters object. Callers should use the setter or fluent setter (with...) methods to initialize this object after creating it.

JobParameters

public JobParameters(String format,
             String type,
             String archiveId,
             String description)

Constructs a new JobParameters object. Callers should use the setter or fluent setter (with...) methods to initialize any additional object members.

Parameters:

format - 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".

type - 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".

archiveId - 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.

description - 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.

Method Detail

getFormat

public String getFormat()

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:

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".

setFormat

public void setFormat(String format)

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".

Parameters:

format - 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".

withFormat

public JobParameters withFormat(String format)

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 a reference to this object so that method calls can be chained together.

Parameters:

format - 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:

A reference to this updated object so that method calls can be chained together.

getType

public String getType()

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:

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".

setType

public void setType(String type)

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".

Parameters:

type - 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".

withType

public JobParameters withType(String type)

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 a reference to this object so that method calls can be chained together.

Parameters:

type - 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:

A reference to this updated object so that method calls can be chained together.

getArchiveId

public String getArchiveId()

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:

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.

setArchiveId

public void setArchiveId(String archiveId)

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.

Parameters:

archiveId - 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.

withArchiveId

public JobParameters withArchiveId(String archiveId)

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 a reference to this object so that method calls can be chained together.

Parameters:

archiveId - 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:

A reference to this updated object so that method calls can be chained together.

getDescription

public String getDescription()

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:

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.

setDescription

public void setDescription(String description)

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.

Parameters:

description - 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.

withDescription

public JobParameters withDescription(String description)

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 a reference to this object so that method calls can be chained together.

Parameters:

description - 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:

A reference to this updated object so that method calls can be chained together.

getSNSTopic

public String getSNSTopic()

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:

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.

setSNSTopic

public void setSNSTopic(String sNSTopic)

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.

Parameters:

sNSTopic - 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.

withSNSTopic

public JobParameters withSNSTopic(String sNSTopic)

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 a reference to this object so that method calls can be chained together.

Parameters:

sNSTopic - 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:

A reference to this updated object so that method calls can be chained together.

getRetrievalByteRange

public String getRetrievalByteRange()

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:

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.

setRetrievalByteRange

public void setRetrievalByteRange(String retrievalByteRange)

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.

Parameters:

retrievalByteRange - 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.

withRetrievalByteRange

public JobParameters withRetrievalByteRange(String retrievalByteRange)

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 a reference to this object so that method calls can be chained together.

Parameters:

retrievalByteRange - 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:

A reference to this updated object so that method calls can be chained together.

getInventoryRetrievalParameters

public InventoryRetrievalJobInput getInventoryRetrievalParameters()

Input parameters used for range inventory retrieval.

Returns:

Input parameters used for range inventory retrieval.

setInventoryRetrievalParameters

public void setInventoryRetrievalParameters(InventoryRetrievalJobInput inventoryRetrievalParameters)

Input parameters used for range inventory retrieval.

Parameters:

inventoryRetrievalParameters - Input parameters used for range inventory retrieval.

withInventoryRetrievalParameters

public JobParameters withInventoryRetrievalParameters(InventoryRetrievalJobInput inventoryRetrievalParameters)

Input parameters used for range inventory retrieval.

Returns a reference to this object so that method calls can be chained together.

Parameters:

inventoryRetrievalParameters - Input parameters used for range inventory retrieval.

Returns:

A reference to this updated object so that method calls can be chained together.

toString

public String toString()

Returns a string representation of this object; useful for testing and debugging.

Overrides:

toString in class Object

Returns:

A string representation of this object.

See Also:

Object.toString()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object