Network.AWS.Glacier.UploadMultipartPart

This operation uploads a part of an archive. You can upload archive parts in any order. You can also upload them in parallel. You can upload up to 10,000 parts for a multipart upload.

Amazon Glacier rejects your upload part request if any of the following conditions is true:

• SHA256 tree hash does not matchTo ensure that part data is not corrupted in transmission, you compute a SHA256 tree hash of the part and include it in your request. Upon receiving the part data, Amazon Glacier also computes a SHA256 tree hash. If these hash values don't match, the operation fails. For information about computing a SHA256 tree hash, see Computing Checksums.

• Part size does not matchThe size of each part except the last must match the size specified in the corresponding InitiateMultipartUpload request. The size of the last part must be the same size as, or smaller than, the specified size.

  If you upload a part whose size is smaller than the part size you specified in your initiate multipart upload request and that part is not the last part, then the upload part request will succeed. However, the subsequent Complete Multipart Upload request will fail.

• Range does not alignThe byte range value in the request does not align with the part size specified in the corresponding initiate request. For example, if you specify a part size of 4194304 bytes (4 MB), then 0 to 4194303 bytes (4 MB - 1) and 4194304 (4 MB) to 8388607 (8 MB - 1) are valid part ranges. However, if you set a range value of 2 MB to 6 MB, the range does not align with the part size and the upload will fail.

This operation is idempotent. If you upload the same part multiple times, the data included in the most recent request overwrites the previously uploaded data.

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 Identity and Access Management (IAM).

For conceptual information and underlying REST API, go to Uploading Large Archives in Parts (Multipart Upload) and Upload Part in the Amazon Glacier Developer Guide.

See: AWS API Reference for UploadMultipartPart.

Creating a Request

uploadMultipartPart

Arguments

:: Text

umpAccountId

-> Text

umpVaultName

-> Text

umpUploadId

-> HashedBody

umpBody

-> UploadMultipartPart

Creates a value of UploadMultipartPart with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• umpChecksum
• umpRange
• umpAccountId
• umpVaultName
• umpUploadId
• umpBody

data UploadMultipartPart

Provides options to upload a part of an archive in a multipart upload operation.

See: uploadMultipartPart smart constructor.

Instances

Show UploadMultipartPart

Methods

showsPrec :: Int -> UploadMultipartPart -> ShowS

show :: UploadMultipartPart -> String

showList :: [UploadMultipartPart] -> ShowS

Generic UploadMultipartPart

Associated Types

type Rep UploadMultipartPart :: * -> *

Methods

from :: UploadMultipartPart -> Rep UploadMultipartPart x

to :: Rep UploadMultipartPart x -> UploadMultipartPart

AWSRequest UploadMultipartPart

Associated Types

type Rs UploadMultipartPart :: *

Methods

request :: UploadMultipartPart -> Request UploadMultipartPart

response :: MonadResource m => Logger -> Service -> Proxy * UploadMultipartPart -> ClientResponse -> m (Response UploadMultipartPart)

ToBody UploadMultipartPart

Methods

toBody :: UploadMultipartPart -> RqBody

ToQuery UploadMultipartPart

Methods

toQuery :: UploadMultipartPart -> QueryString

ToPath UploadMultipartPart

Methods

toPath :: UploadMultipartPart -> ByteString

ToHeaders UploadMultipartPart

Methods

toHeaders :: UploadMultipartPart -> [Header]

type Rep UploadMultipartPart

type Rep UploadMultipartPart = D1 (MetaData "UploadMultipartPart" "Network.AWS.Glacier.UploadMultipartPart" "amazonka-glacier-1.3.7-Dh9gbv8nf1fFDUYZRjXX0m" False) (C1 (MetaCons "UploadMultipartPart'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_umpChecksum") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_umpRange") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_umpAccountId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)))) ((:*:) (S1 (MetaSel (Just Symbol "_umpVaultName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)) ((:*:) (S1 (MetaSel (Just Symbol "_umpUploadId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)) (S1 (MetaSel (Just Symbol "_umpBody") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 HashedBody))))))

type Rs UploadMultipartPart

type Rs UploadMultipartPart = UploadMultipartPartResponse

Request Lenses

umpChecksum :: Lens' UploadMultipartPart (Maybe Text)

The SHA256 tree hash of the data being uploaded.

umpRange :: Lens' UploadMultipartPart (Maybe Text)

Identifies the range of bytes in the assembled archive that will be uploaded in this part. Amazon Glacier uses this information to assemble the archive in the proper sequence. The format of this header follows RFC 2616. An example header is Content-Range:bytes 0-4194303/*.

umpAccountId :: Lens' UploadMultipartPart Text

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single apos-apos (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens (apos-apos) in the ID.

umpVaultName :: Lens' UploadMultipartPart Text

The name of the vault.

umpUploadId :: Lens' UploadMultipartPart Text

The upload ID of the multipart upload.

umpBody :: Lens' UploadMultipartPart HashedBody

The data to upload.

Destructuring the Response

uploadMultipartPartResponse

Arguments

:: Int

umprsResponseStatus

-> UploadMultipartPartResponse

Creates a value of UploadMultipartPartResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• umprsChecksum
• umprsResponseStatus

data UploadMultipartPartResponse

Contains the Amazon Glacier response to your request.

See: uploadMultipartPartResponse smart constructor.

Instances

Eq UploadMultipartPartResponse

Methods

(==) :: UploadMultipartPartResponse -> UploadMultipartPartResponse -> Bool

(/=) :: UploadMultipartPartResponse -> UploadMultipartPartResponse -> Bool

Data UploadMultipartPartResponse

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> UploadMultipartPartResponse -> c UploadMultipartPartResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c UploadMultipartPartResponse

toConstr :: UploadMultipartPartResponse -> Constr

dataTypeOf :: UploadMultipartPartResponse -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c UploadMultipartPartResponse)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c UploadMultipartPartResponse)

gmapT :: (forall b. Data b => b -> b) -> UploadMultipartPartResponse -> UploadMultipartPartResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> UploadMultipartPartResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> UploadMultipartPartResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> UploadMultipartPartResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> UploadMultipartPartResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> UploadMultipartPartResponse -> m UploadMultipartPartResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> UploadMultipartPartResponse -> m UploadMultipartPartResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> UploadMultipartPartResponse -> m UploadMultipartPartResponse

Read UploadMultipartPartResponse

Methods

readsPrec :: Int -> ReadS UploadMultipartPartResponse

readList :: ReadS [UploadMultipartPartResponse]

readPrec :: ReadPrec UploadMultipartPartResponse

readListPrec :: ReadPrec [UploadMultipartPartResponse]

Show UploadMultipartPartResponse

Methods

showsPrec :: Int -> UploadMultipartPartResponse -> ShowS

show :: UploadMultipartPartResponse -> String

showList :: [UploadMultipartPartResponse] -> ShowS

Generic UploadMultipartPartResponse

Associated Types

type Rep UploadMultipartPartResponse :: * -> *

Methods

from :: UploadMultipartPartResponse -> Rep UploadMultipartPartResponse x

to :: Rep UploadMultipartPartResponse x -> UploadMultipartPartResponse

type Rep UploadMultipartPartResponse

type Rep UploadMultipartPartResponse = D1 (MetaData "UploadMultipartPartResponse" "Network.AWS.Glacier.UploadMultipartPart" "amazonka-glacier-1.3.7-Dh9gbv8nf1fFDUYZRjXX0m" False) (C1 (MetaCons "UploadMultipartPartResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_umprsChecksum") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_umprsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int))))

Response Lenses

umprsChecksum :: Lens' UploadMultipartPartResponse (Maybe Text)

The SHA256 tree hash that Amazon Glacier computed for the uploaded part.

umprsResponseStatus :: Lens' UploadMultipartPartResponse Int

The response status code.