Amazon Simple Storage Service

{'RestoreRequest': {'GlacierJobParameters': {'Tier': 'Standard | Bulk | '
                                                     'Expedited'}}}

Restores an archived copy of an object back into Amazon S3

Request Syntax

client.restore_object(
    Bucket='string',
    Key='string',
    VersionId='string',
    RestoreRequest={
        'Days': 123,
        'GlacierJobParameters': {
            'Tier': 'Standard'|'Bulk'|'Expedited'
        }
    },
    RequestPayer='requester'
)

type Bucket

string

param Bucket

[REQUIRED]

type Key

string

param Key

[REQUIRED]

type VersionId

string

param VersionId

type RestoreRequest

dict

param RestoreRequest

• Days (integer) -- [REQUIRED] Lifetime of the active copy in days

• GlacierJobParameters (dict) -- Glacier related prameters pertaining to this job.

  • Tier (string) -- [REQUIRED] Glacier retrieval tier at which the restore will be processed.

type RequestPayer

string

param RequestPayer

Confirms that the requester knows that she or he will be charged for the request. Bucket owners need not specify this parameter in their requests. Documentation on downloading objects from requester pays buckets can be found at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html

rtype

dict

returns

Response Syntax

{
    'RequestCharged': 'requester'
}

Response Structure

• (dict) --

  • RequestCharged (string) -- If present, indicates that the requester was successfully charged for the request.