glacier_upload_multipart_part: This operation uploads a part of an archive

Description Usage Arguments Value Request syntax Examples

View source: R/glacier_operations.R

Description

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:

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, see Uploading Large Archives in Parts (Multipart Upload) and Upload Part in the Amazon Glacier Developer Guide.

Usage

1
2
glacier_upload_multipart_part(accountId, vaultName, uploadId, checksum,
  range, body)

Arguments

accountId

[required] 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 '-' (hyphen), in which case Amazon S3 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 ('-') in the ID.

vaultName

[required] The name of the vault.

uploadId

[required] The upload ID of the multipart upload.

checksum

The SHA256 tree hash of the data being uploaded.

range

Identifies the range of bytes in the assembled archive that will be uploaded in this part. Amazon S3 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/*.

body

The data to upload.

Value

A list with the following syntax:

1
2
3
list(
  checksum = "string"
)

Request syntax

1
2
3
4
5
6
7
8
svc$upload_multipart_part(
  accountId = "string",
  vaultName = "string",
  uploadId = "string",
  checksum = "string",
  range = "string",
  body = raw
)

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
## Not run: 
# The example uploads the first 1 MiB (1024 x 1024 bytes) part of an
# archive.
svc$upload_multipart_part(
  accountId = "-",
  body = "part1",
  checksum = "c06f7cd4baacb087002a99a5f48bf953",
  range = "bytes 0-1048575/*",
  uploadId = "19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLq...",
  vaultName = "examplevault"
)

## End(Not run)

paws.storage documentation built on Aug. 23, 2021, 1:06 a.m.