Class Storage (5.8.5)

Inheritance

Service >Storage

Package

@google-cloud/storage!

Constructors

(constructor)(options)

constructor(options?:StorageOptions);

Constructs the Storage client.

Parameter
NameDescription
optionsStorageOptions

Configuration options.

Properties

acl

acl:typeofStorage.acl;

Reference to .

Storage#acl Storage.acl

Property Value
TypeDescription
typeofStorage.acl

acl

staticacl:{OWNER_ROLE:string;READER_ROLE:string;WRITER_ROLE:string;};
Property Value
TypeDescription
{ OWNER_ROLE: string; READER_ROLE: string; WRITER_ROLE: string; }

Bucket

staticBucket:typeofBucket;

Bucket class.

Storage.Bucket Bucket {Constructor}

Property Value
TypeDescription
typeofBucket

Channel

staticChannel:typeofChannel;

Channel class.

Storage.Channel Channel {Constructor}

Property Value
TypeDescription
typeofChannel

File

staticFile:typeofFile;

File class.

Storage.File File {Constructor}

Property Value
TypeDescription
typeofFile

getBucketsStream

getBucketsStream:()=>Readable;
Property Value
TypeDescription
() =>internal.Readable

getHmacKeysStream

getHmacKeysStream:()=>Readable;
Property Value
TypeDescription
() =>internal.Readable

HmacKey

staticHmacKey:typeofHmacKey;

HmacKey class.

Storage.HmacKey HmacKey {Constructor}

Property Value
TypeDescription
typeofHmacKey

Methods

bucket(name, options)

bucket(name:string,options?:BucketOptions):Bucket;

Get a reference to a Cloud Storage bucket.

Parameters
NameDescription
namestring

Name of the bucket.

optionsBucketOptions

Configuration object.

Returns
TypeDescription
Bucket

{Bucket} Bucket

channel(id, resourceId)

channel(id:string,resourceId:string):Channel;

Reference a channel to receive notifications about changes to your bucket.

Parameters
NameDescription
idstring

The ID of the channel.

resourceIdstring

The resource ID of the channel.

Returns
TypeDescription
Channel

{Channel} Channel

createBucket(name, metadata)

createBucket(name:string,metadata?:CreateBucketRequest):Promise<CreateBucketResponse>;
Parameters
NameDescription
namestring
metadataCreateBucketRequest
Returns
TypeDescription
Promise<CreateBucketResponse>

createBucket(name, callback)

createBucket(name:string,callback:BucketCallback):void;
Parameters
NameDescription
namestring
callbackBucketCallback
Returns
TypeDescription
void

createBucket(name, metadata, callback)

createBucket(name:string,metadata:CreateBucketRequest,callback:BucketCallback):void;
Parameters
NameDescription
namestring
metadataCreateBucketRequest
callbackBucketCallback
Returns
TypeDescription
void

createBucket(name, metadata, callback)

createBucket(name:string,metadata:CreateBucketRequest,callback:BucketCallback):void;
Parameters
NameDescription
namestring
metadataCreateBucketRequest
callbackBucketCallback
Returns
TypeDescription
void

createHmacKey(serviceAccountEmail, options)

createHmacKey(serviceAccountEmail:string,options?:CreateHmacKeyOptions):Promise<CreateHmacKeyResponse>;
Parameters
NameDescription
serviceAccountEmailstring
optionsCreateHmacKeyOptions
Returns
TypeDescription
Promise<CreateHmacKeyResponse>

createHmacKey(serviceAccountEmail, callback)

createHmacKey(serviceAccountEmail:string,callback:CreateHmacKeyCallback):void;
Parameters
NameDescription
serviceAccountEmailstring
callbackCreateHmacKeyCallback
Returns
TypeDescription
void

createHmacKey(serviceAccountEmail, options, callback)

createHmacKey(serviceAccountEmail:string,options:CreateHmacKeyOptions,callback:CreateHmacKeyCallback):void;
Parameters
NameDescription
serviceAccountEmailstring
optionsCreateHmacKeyOptions
callbackCreateHmacKeyCallback
Returns
TypeDescription
void

getBuckets(options)

getBuckets(options?:GetBucketsRequest):Promise<GetBucketsResponse>;
Parameter
NameDescription
optionsGetBucketsRequest
Returns
TypeDescription
Promise<GetBucketsResponse>

getBuckets(options, callback)

getBuckets(options:GetBucketsRequest,callback:GetBucketsCallback):void;
Parameters
NameDescription
optionsGetBucketsRequest
callbackGetBucketsCallback
Returns
TypeDescription
void

getBuckets(callback)

getBuckets(callback:GetBucketsCallback):void;
Parameter
NameDescription
callbackGetBucketsCallback
Returns
TypeDescription
void

getHmacKeys(options)

getHmacKeys(options?:GetHmacKeysOptions):Promise<GetHmacKeysResponse>;

Retrieves a list of HMAC keys matching the criteria.

The authenticated user must have storage.hmacKeys.list permission for the project in which the key exists.

Parameter
NameDescription
optionsGetHmacKeysOptions

Configuration options.

Returns
TypeDescription
Promise<GetHmacKeysResponse>

getHmacKeys(callback)

getHmacKeys(callback:GetHmacKeysCallback):void;
Parameter
NameDescription
callbackGetHmacKeysCallback
Returns
TypeDescription
void

getHmacKeys(options, callback)

getHmacKeys(options:GetHmacKeysOptions,callback:GetHmacKeysCallback):void;
Parameters
NameDescription
optionsGetHmacKeysOptions
callbackGetHmacKeysCallback
Returns
TypeDescription
void

getServiceAccount(options)

getServiceAccount(options?:GetServiceAccountOptions):Promise<GetServiceAccountResponse>;
Parameter
NameDescription
optionsGetServiceAccountOptions
Returns
TypeDescription
Promise<GetServiceAccountResponse>

getServiceAccount(options)

getServiceAccount(options?:GetServiceAccountOptions):Promise<GetServiceAccountResponse>;
Parameter
NameDescription
optionsGetServiceAccountOptions
Returns
TypeDescription
Promise<GetServiceAccountResponse>

getServiceAccount(options, callback)

getServiceAccount(options:GetServiceAccountOptions,callback:GetServiceAccountCallback):void;
Parameters
NameDescription
optionsGetServiceAccountOptions
callbackGetServiceAccountCallback
Returns
TypeDescription
void

getServiceAccount(callback)

getServiceAccount(callback:GetServiceAccountCallback):void;
Parameter
NameDescription
callbackGetServiceAccountCallback
Returns
TypeDescription
void

hmacKey(accessId, options)

hmacKey(accessId:string,options?:HmacKeyOptions):HmacKey;

Get a reference to an HmacKey object. Note: this does not fetch the HMAC key's metadata. Use HmacKey#get() to retrieve and populate the metadata.

To get a reference to an HMAC key that's not created for a service account in the same project used to instantiate the Storage client, supply the project's ID asprojectId in theoptions argument.

Parameters
NameDescription
accessIdstring

The HMAC key's access ID.

optionsHmacKeyOptions

HmacKey constructor owptions.

Returns
TypeDescription
HmacKey

{HmacKey} HmacKey

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-10-30 UTC.