Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
  /*
   * Copyright 2010-2015 Amazon.com, Inc. or its affiliates. All Rights Reserved.
   * 
   * Licensed under the Apache License, Version 2.0 (the "License").
   * You may not use this file except in compliance with the License.
   * A copy of the License is located at
   * 
   *  http://aws.amazon.com/apache2.0
   * 
  * or in the "license" file accompanying this file. This file is distributed
  * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
  * express or implied. See the License for the specific language governing
  * permissions and limitations under the License.
  */
 package com.amazonaws.services.glacier.model;
 
 
Container for the parameters to the UploadMultipartPart operation.

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 match To 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 match The 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.

    NOTE: 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 align The 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 .

 
 public class UploadMultipartPartRequest extends AmazonWebServiceRequest implements SerializableCloneable {

    
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.
 
     private String accountId;

    
The name of the vault.
    private String vaultName;

    
The upload ID of the multipart upload.
    private String uploadId;

    
The SHA256 tree hash of the data being uploaded.
    private String checksum;

    
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/*.
    private String range;

    
The data to upload. This stream must implement mark/reset in order for signature calculation to be performed before this data is read for the request payload.
    private java.io.InputStream body;

    
Default constructor for a new UploadMultipartPartRequest object. Callers should use the setter or fluent setter (with...) methods to initialize this object after creating it.
    public UploadMultipartPartRequest() {}
    
    
Constructs a new UploadMultipartPartRequest object. Callers should use the setter or fluent setter (with...) methods to initialize any additional object members.

Parameters:
vaultName The name of the vault.
uploadId 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 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.
    public UploadMultipartPartRequest(String vaultNameString uploadIdString checksumString rangejava.io.InputStream body) {
        setVaultName(vaultName);
        setUploadId(uploadId);
        setChecksum(checksum);
        setRange(range);
        setBody(body);
    }

    
Constructs a new UploadMultipartPartRequest object. Callers should use the setter or fluent setter (with...) methods to initialize any additional object members.

Parameters:
accountId 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.
vaultName The name of the vault.
uploadId 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 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.
    public UploadMultipartPartRequest(String accountIdString vaultNameString uploadIdString checksumString rangejava.io.InputStream body) {
        setAccountId(accountId);
        setVaultName(vaultName);
        setUploadId(uploadId);
        setChecksum(checksum);
        setRange(range);
        setBody(body);
    }

    
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.

Returns:
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.
    public String getAccountId() {
        return ;
    }
    
    
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.

Parameters:
accountId 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.
    public void setAccountId(String accountId) {
        this. = accountId;
    }
    
    
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.

Returns a reference to this object so that method calls can be chained together.

Parameters:
accountId 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.
Returns:
A reference to this updated object so that method calls can be chained together.
    public UploadMultipartPartRequest withAccountId(String accountId) {
        this. = accountId;
        return this;
    }

    
The name of the vault.

Returns:
The name of the vault.
    public String getVaultName() {
        return ;
    }
    
    
The name of the vault.

Parameters:
vaultName The name of the vault.
    public void setVaultName(String vaultName) {
        this. = vaultName;
    }
    
    
The name of the vault.

Returns a reference to this object so that method calls can be chained together.

Parameters:
vaultName The name of the vault.
Returns:
A reference to this updated object so that method calls can be chained together.
    public UploadMultipartPartRequest withVaultName(String vaultName) {
        this. = vaultName;
        return this;
    }

    
The upload ID of the multipart upload.

Returns:
The upload ID of the multipart upload.
    public String getUploadId() {
        return ;
    }
    
    
The upload ID of the multipart upload.

Parameters:
uploadId The upload ID of the multipart upload.
    public void setUploadId(String uploadId) {
        this. = uploadId;
    }
    
    
The upload ID of the multipart upload.

Returns a reference to this object so that method calls can be chained together.

Parameters:
uploadId The upload ID of the multipart upload.
Returns:
A reference to this updated object so that method calls can be chained together.
    public UploadMultipartPartRequest withUploadId(String uploadId) {
        this. = uploadId;
        return this;
    }

    
The SHA256 tree hash of the data being uploaded.

Returns:
The SHA256 tree hash of the data being uploaded.
    public String getChecksum() {
        return ;
    }
    
    
The SHA256 tree hash of the data being uploaded.

Parameters:
checksum The SHA256 tree hash of the data being uploaded.
    public void setChecksum(String checksum) {
        this. = checksum;
    }
    
    
The SHA256 tree hash of the data being uploaded.

Returns a reference to this object so that method calls can be chained together.

Parameters:
checksum The SHA256 tree hash of the data being uploaded.
Returns:
A reference to this updated object so that method calls can be chained together.
    public UploadMultipartPartRequest withChecksum(String checksum) {
        this. = checksum;
        return this;
    }

    
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/*.

Returns:
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/*.
    public String getRange() {
        return ;
    }
    
    
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/*.

Parameters:
range 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/*.
    public void setRange(String range) {
        this. = range;
    }
    
    
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/*.

Returns a reference to this object so that method calls can be chained together.

Parameters:
range 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/*.
Returns:
A reference to this updated object so that method calls can be chained together.
    public UploadMultipartPartRequest withRange(String range) {
        this. = range;
        return this;
    }

    
The data to upload. This stream must implement mark/reset in order for signature calculation to be performed before this data is read for the request payload.

Returns:
The data to upload.
    public java.io.InputStream getBody() {
        return ;
    }
    
    
The data to upload. This stream must implement mark/reset in order for signature calculation to be performed before this data is read for the request payload.

Parameters:
body The data to upload.
    public void setBody(java.io.InputStream body) {
        this. = body;
    }
    
    
The data to upload. This stream must implement mark/reset in order for signature calculation to be performed before this data is read for the request payload.

Returns a reference to this object so that method calls can be chained together.

Parameters:
body The data to upload.
Returns:
A reference to this updated object so that method calls can be chained together.
        this. = body;
        return this;
    }

    
Returns a string representation of this object; useful for testing and debugging.

Returns:
A string representation of this object.
See also:
java.lang.Object.toString()
    @Override
    public String toString() {
        StringBuilder sb = new StringBuilder();
        sb.append("{");
        if (getAccountId() != nullsb.append("AccountId: " + getAccountId() + ",");
        if (getVaultName() != nullsb.append("VaultName: " + getVaultName() + ",");
        if (getUploadId() != nullsb.append("UploadId: " + getUploadId() + ",");
        if (getChecksum() != nullsb.append("Checksum: " + getChecksum() + ",");
        if (getRange() != nullsb.append("Range: " + getRange() + ",");
        if (getBody() != nullsb.append("Body: " + getBody() );
        sb.append("}");
        return sb.toString();
    }
    
    @Override
    public int hashCode() {
        final int prime = 31;
        int hashCode = 1;
        
        hashCode = prime * hashCode + ((getAccountId() == null) ? 0 : getAccountId().hashCode()); 
        hashCode = prime * hashCode + ((getVaultName() == null) ? 0 : getVaultName().hashCode()); 
        hashCode = prime * hashCode + ((getUploadId() == null) ? 0 : getUploadId().hashCode()); 
        hashCode = prime * hashCode + ((getChecksum() == null) ? 0 : getChecksum().hashCode()); 
        hashCode = prime * hashCode + ((getRange() == null) ? 0 : getRange().hashCode()); 
        hashCode = prime * hashCode + ((getBody() == null) ? 0 : getBody().hashCode()); 
        return hashCode;
    }
    
    @Override
    public boolean equals(Object obj) {
        if (this == objreturn true;
        if (obj == nullreturn false;
        if (obj instanceof UploadMultipartPartRequest == falsereturn false;
        
        if (other.getAccountId() == null ^ this.getAccountId() == nullreturn false;
        if (other.getAccountId() != null && other.getAccountId().equals(this.getAccountId()) == falsereturn false
        if (other.getVaultName() == null ^ this.getVaultName() == nullreturn false;
        if (other.getVaultName() != null && other.getVaultName().equals(this.getVaultName()) == falsereturn false
        if (other.getUploadId() == null ^ this.getUploadId() == nullreturn false;
        if (other.getUploadId() != null && other.getUploadId().equals(this.getUploadId()) == falsereturn false
        if (other.getChecksum() == null ^ this.getChecksum() == nullreturn false;
        if (other.getChecksum() != null && other.getChecksum().equals(this.getChecksum()) == falsereturn false
        if (other.getRange() == null ^ this.getRange() == nullreturn false;
        if (other.getRange() != null && other.getRange().equals(this.getRange()) == falsereturn false
        if (other.getBody() == null ^ this.getBody() == nullreturn false;
        if (other.getBody() != null && other.getBody().equals(this.getBody()) == falsereturn false
        return true;
    }
    
    @Override
    public UploadMultipartPartRequest clone() {
        
            return (UploadMultipartPartRequestsuper.clone();
    }
}
    
New to GrepCode? Check out our FAQ X