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.