public final class DefaultS3Presigner extends DefaultSdkPresigner implements S3Presigner
S3Presigner
interface.Modifier and Type | Class and Description |
---|---|
static class |
DefaultS3Presigner.Builder |
Modifier and Type | Method and Description |
---|---|
static S3Presigner.Builder |
builder()
Create an
S3Presigner.Builder that can be used to configure and create a S3Presigner . |
PresignedAbortMultipartUploadRequest |
presignAbortMultipartUpload(AbortMultipartUploadPresignRequest request)
Presign a
AbortMultipartUploadRequest so that it can be executed at a later time without requiring additional
signing or authentication. |
PresignedCompleteMultipartUploadRequest |
presignCompleteMultipartUpload(CompleteMultipartUploadPresignRequest request)
Presign a
CompleteMultipartUploadRequest so that it can be executed at a later time without requiring additional
signing or authentication. |
PresignedCreateMultipartUploadRequest |
presignCreateMultipartUpload(CreateMultipartUploadPresignRequest request)
Presign a
CreateMultipartUploadRequest so that it can be executed at a later time without requiring additional
signing or authentication. |
PresignedGetObjectRequest |
presignGetObject(GetObjectPresignRequest request)
Presign a
GetObjectRequest so that it can be executed at a later time without requiring additional
signing or authentication. |
PresignedPutObjectRequest |
presignPutObject(PutObjectPresignRequest request)
Presign a
PutObjectRequest so that it can be executed at a later time without requiring additional
signing or authentication. |
PresignedUploadPartRequest |
presignUploadPart(UploadPartPresignRequest request)
Presign a
UploadPartRequest so that it can be executed at a later time without requiring additional
signing or authentication. |
protected S3Configuration |
serviceConfiguration() |
close, credentialsProvider, endpointOverride, region
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
create, presignAbortMultipartUpload, presignCompleteMultipartUpload, presignCreateMultipartUpload, presignGetObject, presignPutObject, presignUploadPart
close
public static S3Presigner.Builder builder()
S3Presigner
S3Presigner.Builder
that can be used to configure and create a S3Presigner
.
This is usually done at application startup, because creating a presigner can be expensive. It is recommended to
SdkPresigner.close()
the S3Presigner
when it is done being used.builder
in interface S3Presigner
public PresignedGetObjectRequest presignGetObject(GetObjectPresignRequest request)
S3Presigner
GetObjectRequest
so that it can be executed at a later time without requiring additional
signing or authentication.
Example Usage
S3Presigner presigner = ...;
// Create a GetObjectRequest to be pre-signed
GetObjectRequest getObjectRequest = ...;
// Create a GetObjectPresignRequest to specify the signature duration
GetObjectPresignRequest getObjectPresignRequest =
GetObjectPresignRequest.builder()
.signatureDuration(Duration.ofMinutes(10))
.getObjectRequest(request)
.build();
// Generate the presigned request
PresignedGetObjectRequest presignedGetObjectRequest =
presigner.presignGetObject(getObjectPresignRequest);
if (presignedGetObjectRequest.isBrowserExecutable())
System.out.println("The pre-signed request can be executed using a web browser by " +
"visiting the following URL: " + presignedGetObjectRequest.url());
else
System.out.println("The pre-signed request has an HTTP method, headers or a payload " +
"that prohibits it from being executed by a web browser. See the S3Presigner " +
"class-level documentation for an example of how to execute this pre-signed " +
"request from Java code.");
presignGetObject
in interface S3Presigner
public PresignedPutObjectRequest presignPutObject(PutObjectPresignRequest request)
S3Presigner
PutObjectRequest
so that it can be executed at a later time without requiring additional
signing or authentication.
Example Usage
S3Presigner presigner = ...;
// Create a PutObjectRequest to be pre-signed
PutObjectRequest putObjectRequest = ...;
// Create a PutObjectPresignRequest to specify the signature duration
PutObjectPresignRequest putObjectPresignRequest =
PutObjectPresignRequest.builder()
.signatureDuration(Duration.ofMinutes(10))
.putObjectRequest(request)
.build();
// Generate the presigned request
PresignedPutObjectRequest presignedPutObjectRequest =
presigner.presignPutObject(putObjectPresignRequest);
presignPutObject
in interface S3Presigner
public PresignedCreateMultipartUploadRequest presignCreateMultipartUpload(CreateMultipartUploadPresignRequest request)
S3Presigner
CreateMultipartUploadRequest
so that it can be executed at a later time without requiring additional
signing or authentication.
Example Usage
S3Presigner presigner = ...;
// Create a CreateMultipartUploadRequest to be pre-signed
CreateMultipartUploadRequest createMultipartUploadRequest = ...;
// Create a CreateMultipartUploadPresignRequest to specify the signature duration
CreateMultipartUploadPresignRequest createMultipartUploadPresignRequest =
CreateMultipartUploadPresignRequest.builder()
.signatureDuration(Duration.ofMinutes(10))
.createMultipartUploadRequest(request)
.build();
// Generate the presigned request
PresignedCreateMultipartUploadRequest presignedCreateMultipartUploadRequest =
presigner.presignCreateMultipartUpload(createMultipartUploadPresignRequest);
presignCreateMultipartUpload
in interface S3Presigner
public PresignedUploadPartRequest presignUploadPart(UploadPartPresignRequest request)
S3Presigner
UploadPartRequest
so that it can be executed at a later time without requiring additional
signing or authentication.
Example Usage
S3Presigner presigner = ...;
// Create a UploadPartRequest to be pre-signed
UploadPartRequest uploadPartRequest = ...;
// Create a UploadPartPresignRequest to specify the signature duration
UploadPartPresignRequest uploadPartPresignRequest =
UploadPartPresignRequest.builder()
.signatureDuration(Duration.ofMinutes(10))
.uploadPartRequest(request)
.build();
// Generate the presigned request
PresignedUploadPartRequest presignedUploadPartRequest =
presigner.presignUploadPart(uploadPartPresignRequest);
presignUploadPart
in interface S3Presigner
public PresignedCompleteMultipartUploadRequest presignCompleteMultipartUpload(CompleteMultipartUploadPresignRequest request)
S3Presigner
CompleteMultipartUploadRequest
so that it can be executed at a later time without requiring additional
signing or authentication.
Example Usage
S3Presigner presigner = ...;
// Complete a CompleteMultipartUploadRequest to be pre-signed
CompleteMultipartUploadRequest completeMultipartUploadRequest = ...;
// Create a CompleteMultipartUploadPresignRequest to specify the signature duration
CompleteMultipartUploadPresignRequest completeMultipartUploadPresignRequest =
CompleteMultipartUploadPresignRequest.builder()
.signatureDuration(Duration.ofMinutes(10))
.completeMultipartUploadRequest(request)
.build();
// Generate the presigned request
PresignedCompleteMultipartUploadRequest presignedCompleteMultipartUploadRequest =
presigner.presignCompleteMultipartUpload(completeMultipartUploadPresignRequest);
presignCompleteMultipartUpload
in interface S3Presigner
public PresignedAbortMultipartUploadRequest presignAbortMultipartUpload(AbortMultipartUploadPresignRequest request)
S3Presigner
AbortMultipartUploadRequest
so that it can be executed at a later time without requiring additional
signing or authentication.
Example Usage
S3Presigner presigner = ...;
// Complete a AbortMultipartUploadRequest to be pre-signed
AbortMultipartUploadRequest abortMultipartUploadRequest = ...;
// Create a AbortMultipartUploadPresignRequest to specify the signature duration
AbortMultipartUploadPresignRequest abortMultipartUploadPresignRequest =
AbortMultipartUploadPresignRequest.builder()
.signatureDuration(Duration.ofMinutes(10))
.abortMultipartUploadRequest(request)
.build();
// Generate the presigned request
PresignedAbortMultipartUploadRequest presignedAbortMultipartUploadRequest =
presigner.presignAbortMultipartUpload(abortMultipartUploadPresignRequest);
presignAbortMultipartUpload
in interface S3Presigner
protected S3Configuration serviceConfiguration()
Copyright © 2020. All rights reserved.