Package com.google.cloud.storage
package com.google.cloud.storage
A client for Cloud Storage - Unified object storage.
Here's a simple usage example the Java Storage client. This example shows how to create a Storage object.
Storage storage = StorageOptions.getDefaultInstance().getService();
BlobId blobId = BlobId.of("bucket", "blob_name");
BlobInfo blobInfo = BlobInfo.newBuilder(blobId).setContentType("text/plain").build();
Blob blob = storage.create(blobInfo, "Hello, Cloud Storage!".getBytes(UTF_8));
This second example shows how to update an object's content if the object exists.
Storage storage = StorageOptions.getDefaultInstance().getService();
BlobId blobId = BlobId.of("bucket", "blob_name");
Blob blob = storage.get(blobId);
if (blob != null) {
byte[] prevContent = blob.getContent();
System.out.println(new String(prevContent, UTF_8));
WritableByteChannel channel = blob.writer();
channel.write(ByteBuffer.wrap("Updated content".getBytes(UTF_8)));
channel.close();
}
For more detailed code examples, see the sample library.
When using google-cloud from outside of App/Compute Engine, you have to specify a project ID and provide credentials.
Operations in this library are generally thread safe, except for the use of BlobReadChannel and BlobWriteChannel.
- See Also:
-
ClassDescriptionAccess Control List for buckets or blobs.Builder for
Acl
objects.Class for ACL Domain entities.Base class for Access Control List entities.Class for ACL Group entities.Class for ACL Project entities.Class for ACL User entities.An object in Google Cloud Storage.Class for specifying blob source options whenBlob
methods are used.Builder forBlob
.Google Storage Object identifier.Information about an object in Google Cloud Storage.Builder forBlobInfo
.Objects of this class hold information on the customer-supplied encryption key, if the blob is encrypted using such a key.This class is meant for internal use only.A session to write an object to Google Cloud Storage.A sealed internal implementation only class which provides the means of configuring aBlobWriteSession
.Factory class to select and constructBlobWriteSessionConfig
s.A Google cloud storage bucket.Class for specifying blob target options whenBucket
methods are used.Class for specifying blob write options whenBucket
methods are used.Class for specifying bucket source options whenBucket
methods are used.Builder forBucket
.Google Storage bucket metadata;Deprecated.Builder forBucketInfo
.Deprecated.Use aLifecycleRule
with an actionDeleteLifecycleAction
and a conditionLifecycleCondition.Builder.setCreatedBefore
instead.The bucket's custom placement configuration for Custom Dual Regions.Deprecated.Use aLifecycleRule
with aDeleteLifecycleAction
and aLifecycleCondition
which is equivalent to a subclass of DeleteRule instead.The Bucket's IAM Configuration.Builder forIamConfiguration
Deprecated.Use aLifecycleRule
with aDeleteLifecycleAction
and a conditionLifecycleCondition.Builder.setIsLive
instead.Lifecycle rule for a bucket.Base class for the Action to take when a Lifecycle Condition is met.Condition for a Lifecycle rule, specifies under what criteria an Action should be executed.Builder forLifecycleCondition
.The bucket's logging configuration, which defines the destination bucket and optional name prefix for the current bucket's logs.Deprecated.Use aLifecycleRule
with aDeleteLifecycleAction
and a conditionLifecycleCondition.Builder.setNumberOfNewerVersions
instead.Public Access Prevention enum with expected values.There are scenarios in which disk space is more plentiful than memory space.Canonical extension header serializer.Google Storage blob copy writer.Cross-Origin Resource Sharing (CORS) configuration for a bucket.CORS configuration builder.Class for a CORS origin.Default Configuration to represent uploading to Google Cloud Storage in a chunked manner.Internal implementation detail, only public to allow forSerializable
compatibility inServiceOptions
.Deprecated.HMAC key for a service account.Builder forHmacKey
objects.The metadata for a service account HMAC key.Builder forHmacKeyMetadata
objects.Http method supported by Storage service.Internal implementation detail, only public to allow forSerializable
.Internal implementation detail, only public to allow forSerializable
.There are scenarios in which disk space is more plentiful than memory space.The class representing Pub/Sub notifications for the Storage.Builder forNotification
.The class representing Pub/Sub Notification metadata for the Storage.Builder forNotificationInfo
.Builder forNotificationInfo
.Option<O extends com.google.cloud.storage.UnifiedOpts.Opt>Deprecated.Presigned V4 post policy.Class for a specific POST policy document condition.A helper class for specifying conditions in a V4 POST Policy document.A helper class to define fields to be specified in a V4 POST request.Class for a V4 POST Policy document.Enums for the Recovery Point Objective (RPO) of dual-region buckets, which determines how fast data is replicated between regions.A service account, with its specified scopes, authorized for this instance.Signature Info holds payload components of the string that requires signing.An interface for Google Cloud Storage.Class for specifying blob get options.Class for specifying blob list options.Class for specifying blob source options.Class for specifying blob target options.Class for specifying blob write options.Class for specifying bucket get options.Class for specifying bucket list options.Class for specifying bucket source options.Class for specifying bucket target options.A class to contain all information needed for a Google Cloud Storage Compose operation.Class for Compose source blobs.A class to contain all information needed for a Google Cloud Storage Copy operation.Class for specifying createHmacKey optionsClass for specifying deleteHmacKey optionsClass for specifying getHmacKey optionsClass for specifying listHmacKeys optionsClass for specifying Post Policy V4 options.Class for specifying signed URL options.Class for specifying updateHmacKey optionsA batch of operations to be submitted to Google Cloud Storage using a single RPC request.This class holds a single result of a batch call to Cloud Storage.Enums for the storage classes.Storage service exception.An interface for Storage factories.Deprecated.Deprecated.A factory class which is used to provide access toResultRetryAlgorithm
for idempotent and non-idempotent calls made viaStorage
.IAM roles specific to Storage.Annotation which is used to convey which Cloud Storage API a class or method has compatibility with.Enum representing the transportscom.google.cloud.storage
classes have implementations for.
LifecycleRule
with aDeleteLifecycleAction
and useLifecycleCondition.Builder.setAge
instead.