org.jclouds.googlecloudstorage.features

Interface ResumableUploadApi

@Consumes(value="application/json")
public interface ResumableUploadApi

Provides Resumable Upload support via Rest API

See Also:

,

Method Summary

Modifier and Type	Method and Description
ResumableUpload	checkStatus(String bucketName, String uploadId, String contentRange) Check the status of a resumable upload
ResumableUpload	chunkUpload(String bucketName, String uploadId, String contentType, Long contentLength, String contentRange, Payload payload) Facilitate to use resumable upload operation to upload files in chunks
ResumableUpload	initResumableUpload(String bucketName, String contentType, Long contentLength, ObjectTemplate metadata) initiate a Resumable Upload Session
ResumableUpload	initResumableUpload(String bucketName, String objectName, String contentType, String contentLength) initiate a Resumable Upload Session
ResumableUpload	upload(String bucketName, String uploadId, String contentType, String contentLength, Payload payload) Stores a new object

Method Detail

initResumableUpload

@Named(value="Object:initResumableUpload")
 @POST
 @Path(value="/upload/storage/v1/b/{bucket}/o")
ResumableUpload initResumableUpload(@PathParam(value="bucket")
                                                                                                                                      String bucketName,
                                                                                                                                      @QueryParam(value="name")
                                                                                                                                      String objectName,
                                                                                                                                      @HeaderParam(value="X-Upload-Content-Type")
                                                                                                                                      String contentType,
                                                                                                                                      @HeaderParam(value="X-Upload-Content-Length")
                                                                                                                                      String contentLength)

initiate a Resumable Upload Session

Parameters:

bucketName - Name of the bucket in which the object to be stored

objectName - Name of the object to upload

contentType - Content type of the uploaded data

contentLength - ContentLength of the uploaded object (Media part)

Returns:

a ResumableUpload

See Also:

https://developers.google.com/storage/docs/json_api/v1/how-tos/upload#resumable

initResumableUpload

@Named(value="Object:resumableUpload")
 @POST
 @Path(value="/upload/storage/v1/b/{bucket}/o")
ResumableUpload initResumableUpload(@PathParam(value="bucket")
                                                                                                                                  String bucketName,
                                                                                                                                  @HeaderParam(value="X-Upload-Content-Type")
                                                                                                                                  String contentType,
                                                                                                                                  @HeaderParam(value="X-Upload-Content-Length")
                                                                                                                                  Long contentLength,
                                                                                                                                  ObjectTemplate metadata)

initiate a Resumable Upload Session

Parameters:

bucketName - Name of the bucket in which the object to be stored

contentType - Content type of the uploaded data (Media part)

contentLength - Content length of the uploaded data (Media part)

metada - Supply an ObjectTemplate

Returns:

a ResumableUpload

See Also:

https://developers.google.com/storage/docs/json_api/v1/how-tos/upload#simple

upload

@Named(value="Object:resumableUpload")
 @PUT
 @Path(value="/upload/storage/v1/b/{bucket}/o")
ResumableUpload upload(@PathParam(value="bucket")
                                                                                                                    String bucketName,
                                                                                                                    @QueryParam(value="upload_id")
                                                                                                                    String uploadId,
                                                                                                                    @HeaderParam(value="Content-Type")
                                                                                                                    String contentType,
                                                                                                                    @HeaderParam(value="Content-Length")
                                                                                                                    String contentLength,
                                                                                                                    Payload payload)

Stores a new object

Parameters:

bucketName - Name of the bucket in which the object to be stored

options - Supply InsertObjectOptions with optional query parameters. 'name' is mandatory.

Returns:

If successful, this method returns a GoogleCloudStorageObject resource.

See Also:

https://developers.google.com/storage/docs/json_api/v1/how-tos/upload#resumable

chunkUpload

@Named(value="Object:Upload")
 @PUT
 @Path(value="/upload/storage/v1/b/{bucket}/o")
ResumableUpload chunkUpload(@PathParam(value="bucket")
                                                                                                                String bucketName,
                                                                                                                @QueryParam(value="upload_id")
                                                                                                                String uploadId,
                                                                                                                @HeaderParam(value="Content-Type")
                                                                                                                String contentType,
                                                                                                                @HeaderParam(value="Content-Length")
                                                                                                                Long contentLength,
                                                                                                                @HeaderParam(value="Content-Range")
                                                                                                                String contentRange,
                                                                                                                Payload payload)

Facilitate to use resumable upload operation to upload files in chunks

Parameters:

bucketName - Name of the bucket in which the object to be stored

uploadId - uploadId returned from initResumableUpload operation

contentType - Content type of the uploaded data

contentLength - Content length of the uploaded data

contentRange - Range in {bytes StartingByte - Endingbyte/Totalsize } format ex: bytes 0 - 1213/2000

payload - a Payload with actual data to upload

Returns:

a ResumableUpload

See Also:

https://developers.google.com/storage/docs/json_api/v1/how-tos/upload#resumable

checkStatus

@Named(value="Object:Upload")
 @PUT
 @DefaultValue(value="0")
 @Path(value="/upload/storage/v1/b/{bucket}/o")
ResumableUpload checkStatus(@PathParam(value="bucket")
                                                                                                                                          String bucketName,
                                                                                                                                          @QueryParam(value="upload_id")
                                                                                                                                          String uploadId,
                                                                                                                                          @HeaderParam(value="Content-Range")
                                                                                                                                          String contentRange)

Check the status of a resumable upload

Parameters:

bucketName - Name of the bucket in which the object to be stored

uploadId - uploadId returned from initResumableUpload operation

contentRange - Range in {bytes StartingByte - Endingbyte/Totalsize } format ex: bytes 0 - 1213/2000

Returns:

a ResumableUpload

See Also:

https://developers.google.com/storage/docs/json_api/v1/how-tos/upload#resumable