Safe Haskell | None |
---|---|
Language | Haskell2010 |
This operation returns information about a job you previously initiated,
including the job initiation date, the user who initiated the job, the job
status code/message and the Amazon SNS topic to notify after Amazon Glacier
completes the job. For more information about initiating a job, see InitiateJob
.
This operation enables you to check the status of your job. However, it is strongly recommended that you set up an Amazon SNS topic and specify it in your initiate job request so that Amazon Glacier can notify the topic after it completes the job.
A job ID will not expire for at least 24 hours after Amazon Glacier completes the job.
An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identityand Access Management (IAM).
For information about the underlying REST API, go to Working with Archivesin Amazon Glacier in the Amazon Glacier Developer Guide.
http://docs.aws.amazon.com/amazonglacier/latest/dev/api-DescribeJob.html
- data DescribeJob
- describeJob :: Text -> Text -> Text -> DescribeJob
- djAccountId :: Lens' DescribeJob Text
- djJobId :: Lens' DescribeJob Text
- djVaultName :: Lens' DescribeJob Text
- data DescribeJobResponse
- describeJobResponse :: DescribeJobResponse
- djrAction :: Lens' DescribeJobResponse (Maybe ActionCode)
- djrArchiveId :: Lens' DescribeJobResponse (Maybe Text)
- djrArchiveSHA256TreeHash :: Lens' DescribeJobResponse (Maybe Text)
- djrArchiveSizeInBytes :: Lens' DescribeJobResponse (Maybe Integer)
- djrCompleted :: Lens' DescribeJobResponse (Maybe Bool)
- djrCompletionDate :: Lens' DescribeJobResponse (Maybe Text)
- djrCreationDate :: Lens' DescribeJobResponse (Maybe Text)
- djrInventoryRetrievalParameters :: Lens' DescribeJobResponse (Maybe InventoryRetrievalJobDescription)
- djrInventorySizeInBytes :: Lens' DescribeJobResponse (Maybe Integer)
- djrJobDescription :: Lens' DescribeJobResponse (Maybe Text)
- djrJobId :: Lens' DescribeJobResponse (Maybe Text)
- djrRetrievalByteRange :: Lens' DescribeJobResponse (Maybe Text)
- djrSHA256TreeHash :: Lens' DescribeJobResponse (Maybe Text)
- djrSNSTopic :: Lens' DescribeJobResponse (Maybe Text)
- djrStatusCode :: Lens' DescribeJobResponse (Maybe StatusCode)
- djrStatusMessage :: Lens' DescribeJobResponse (Maybe Text)
- djrVaultARN :: Lens' DescribeJobResponse (Maybe Text)
Request
data DescribeJob Source
Eq DescribeJob | |
Ord DescribeJob | |
Read DescribeJob | |
Show DescribeJob | |
ToJSON DescribeJob | |
AWSRequest DescribeJob | |
ToQuery DescribeJob | |
ToPath DescribeJob | |
ToHeaders DescribeJob | |
type Sv DescribeJob = Glacier | |
type Rs DescribeJob = DescribeJobResponse |
Request constructor
DescribeJob
constructor.
The fields accessible through corresponding lenses are:
djAccountId
::
Text
djJobId
::
Text
djVaultName
::
Text
Request lenses
djAccountId :: Lens' DescribeJob Text Source
The AccountId
is the AWS Account ID. You can specify either the AWS Account
ID or optionally a -
, in which case Amazon Glacier uses the AWS Account ID
associated with the credentials used to sign the request. If you specify your
Account ID, do not include hyphens in it.
djJobId :: Lens' DescribeJob Text Source
The ID of the job to describe.
djVaultName :: Lens' DescribeJob Text Source
The name of the vault.
Response
Response constructor
describeJobResponse :: DescribeJobResponse Source
DescribeJobResponse
constructor.
The fields accessible through corresponding lenses are:
djrAction
::
Maybe
ActionCode
djrArchiveId
::
Maybe
Text
djrArchiveSHA256TreeHash
::
Maybe
Text
djrArchiveSizeInBytes
::
Maybe
Integer
djrCompleted
::
Maybe
Bool
djrCompletionDate
::
Maybe
Text
djrCreationDate
::
Maybe
Text
djrInventoryRetrievalParameters
::
Maybe
InventoryRetrievalJobDescription
djrInventorySizeInBytes
::
Maybe
Integer
djrJobDescription
::
Maybe
Text
djrJobId
::
Maybe
Text
djrRetrievalByteRange
::
Maybe
Text
djrSHA256TreeHash
::
Maybe
Text
djrSNSTopic
::
Maybe
Text
djrStatusCode
::
Maybe
StatusCode
djrStatusMessage
::
Maybe
Text
djrVaultARN
::
Maybe
Text
Response lenses
djrAction :: Lens' DescribeJobResponse (Maybe ActionCode) Source
The job type. It is either ArchiveRetrieval or InventoryRetrieval.
djrArchiveId :: Lens' DescribeJobResponse (Maybe Text) Source
For an ArchiveRetrieval job, this is the archive ID requested for download. Otherwise, this field is null.
djrArchiveSHA256TreeHash :: Lens' DescribeJobResponse (Maybe Text) Source
The SHA256 tree hash of the entire archive for an archive retrieval. For inventory retrieval jobs, this field is null.
djrArchiveSizeInBytes :: Lens' DescribeJobResponse (Maybe Integer) Source
For an ArchiveRetrieval job, this is the size in bytes of the archive being requested for download. For the InventoryRetrieval job, the value is null.
djrCompleted :: Lens' DescribeJobResponse (Maybe Bool) Source
The job status. When a job is completed, you get the job's output.
djrCompletionDate :: Lens' DescribeJobResponse (Maybe Text) Source
The UTC time that the archive retrieval request completed. While the job is in progress, the value will be null.
djrCreationDate :: Lens' DescribeJobResponse (Maybe Text) Source
The UTC date when the job was created. A string representation of ISO 8601 date format, for example, "2012-03-20T17:03:43.221Z".
djrInventoryRetrievalParameters :: Lens' DescribeJobResponse (Maybe InventoryRetrievalJobDescription) Source
Parameters used for range inventory retrieval.
djrInventorySizeInBytes :: Lens' DescribeJobResponse (Maybe Integer) Source
For an InventoryRetrieval job, this is the size in bytes of the inventory requested for download. For the ArchiveRetrieval job, the value is null.
djrJobDescription :: Lens' DescribeJobResponse (Maybe Text) Source
The job description you provided when you initiated the job.
djrJobId :: Lens' DescribeJobResponse (Maybe Text) Source
An opaque string that identifies an Amazon Glacier job.
djrRetrievalByteRange :: Lens' DescribeJobResponse (Maybe Text) Source
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 and StartByteValue equals 0 and EndByteValue equals the size of the archive minus 1. For inventory retrieval jobs this field is null.
djrSHA256TreeHash :: Lens' DescribeJobResponse (Maybe Text) Source
For an ArchiveRetrieval job, it is the checksum of the archive. Otherwise, the value is null.
The SHA256 tree hash value for the requested range of an archive. If the Initiate a Job request for an archive specified a tree-hash aligned range, then this field returns a value.
For the specific case when the whole archive is retrieved, this value is the same as the ArchiveSHA256TreeHash value.
This field is null in the following situations: 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 and the job status is InProgress.
Inventory jobs.
djrSNSTopic :: Lens' DescribeJobResponse (Maybe Text) Source
An Amazon Simple Notification Service (Amazon SNS) topic that receives notification.
djrStatusCode :: Lens' DescribeJobResponse (Maybe StatusCode) Source
The status code can be InProgress, Succeeded, or Failed, and indicates the status of the job.
djrStatusMessage :: Lens' DescribeJobResponse (Maybe Text) Source
A friendly message that describes the job status.
djrVaultARN :: Lens' DescribeJobResponse (Maybe Text) Source
The Amazon Resource Name (ARN) of the vault from which the archive retrieval was requested.