Cloud Storage Client - Class StorageClient (1.43.1)

Configuration options.

The hostname with optional port to use in place of the default service endpoint. Example: foobar.com or foobar.com:1234.

The project ID from the Google Developer's Console.

A cache used storing access tokens. Defaults to a simple in memory implementation.

Cache configuration options.

A handler used to deliver Psr7 requests specifically for authentication.

A credentials fetcher instance.

A handler used to deliver Psr7 requests. Only valid for requests sent over REST.

The contents of the service account credentials .json file retrieved from the Google Developer's Console. Ex: json_decode(file_get_contents($path), true).

The full path to your service account credentials .json file retrieved from the Google Developers Console.

Seconds to wait before timing out the request. Defaults to 0 with REST and 60 with gRPC.

Number of retries for a failed request. Defaults to 3.

Scopes to be used for the request.

Specifies a user project to bill for access charges associated with the request.

The name of the bucket to request.

If true, the current Project ID will be used. If a string, that string will be used as the userProject argument, and that project will be billed for the request. Defaults to false.

Configuration options.

Maximum number of results to return per requested page.

Limit the number of results returned in total. Defaults to 0 (return all results).

A previously-returned page token used to resume the loading of results from a specific point.

Filter results with this prefix.

Determines which properties to return. May be either 'full' or 'noAcl'.

Selector which will cause the response to only return the specified fields.

If set, this is the ID of the project which will be billed for the request.

If true, each returned instance will have $userProject set to the value of $options.userProject. If false, $options.userProject will be used ONLY for the listBuckets operation. If $options.userProject is not set, this option has no effect. Defaults to true.

Name of the bucket to be created.

Configuration options.

Predefined ACL to apply to the bucket. Acceptable values include, "authenticatedRead", "bucketOwnerFullControl", "bucketOwnerRead", "private", "projectPrivate", and "publicRead".

Apply a predefined set of default object access controls to this bucket.

Whether object retention should be enabled on this bucket. For more information, refer to the Object Retention Lock documentation.

Determines which properties to return. May be either "full" or "noAcl". Defaults to "noAcl", unless the bucket resource specifies acl or defaultObjectAcl properties, when it defaults to "full".

Selector which will cause the response to only return the specified fields.

Access controls on the bucket.

The bucket's Cross-Origin Resource Sharing (CORS) configuration.

Default access controls to apply to new objects when no ACL is provided.

The bucket's lifecycle configuration.

The location of the bucket. If specifying a dual-region, the customPlacementConfig property should be set in conjunction. For more information, see Bucket Locations. Defaults to "US".

The hierarchical namespace configuration on this bucket.

The bucket's dual regions. For more information, see Bucket Locations.

The bucket's logging configuration, which defines the destination bucket and optional name prefix for the current bucket's logs.

The bucket's storage class. This defines how objects in the bucket are stored and determines the SLA and the cost of storage. Acceptable values include the following strings: "STANDARD", "NEARLINE", "COLDLINE" and "ARCHIVE". Legacy values including "MULTI_REGIONAL", "REGIONAL" and "DURABLE_REDUCED_AVAILABILITY" are also available, but should be avoided for new implementations. For more information, refer to the Storage Classes documentation. Defaults to "STANDARD".

The bucket's autoclass configuration. Buckets can have either StorageClass OLM rules or Autoclass, but not both. When Autoclass is enabled on a bucket, adding StorageClass OLM rules will result in failure. For more information, refer to Storage Autoclass

The bucket's versioning configuration.

The bucket's website configuration.

The bucket's billing configuration.

.requesterPays When true, requests to this bucket and objects within it must provide a project ID to which the request will be billed.

The Bucket labels. Labels are represented as an array of keys and values. To remove an existing label, set its value to null.

If set, this is the ID of the project which will be billed for the request.

If true, the returned instance will have $userProject set to the value of $options.userProject. If false, $options.userProject will be used ONLY for the createBucket operation. If $options.userProject is not set, this option has no effect. Defaults to true.

Encryption configuration used by default for newly inserted objects.

.defaultKmsKeyName A Cloud KMS Key used to encrypt objects uploaded into this bucket. Should be in the format projects/my-project/locations/kr-location/keyRings/my-kr/cryptoKeys/my-key. Please note the KMS key ring must use the same location as the bucket.

When true, newly created objects in this bucket will be retained indefinitely until an event occurs, signified by the hold's release.

Defines the retention policy for a bucket. In order to lock a retention policy, please see Google\Cloud\Storage\Bucket::lockRetentionPolicy().

.retentionPeriod Specifies the retention period for objects in seconds. During the retention period an object cannot be overwritten or deleted. Retention period must be greater than zero and less than 100 years.

The bucket's IAM configuration.

.bucketPolicyOnly.enabled this is an alias for $iamConfiguration.uniformBucketLevelAccess.

.uniformBucketLevelAccess.enabled If set and true, access checks only use bucket-level IAM policies or above. When enabled, requests attempting to view or manipulate ACLs will fail with error code 400. NOTE: Before using Uniform bucket-level access, please review the feature documentation, as well as Should You Use uniform bucket-level access

Specifies the Turbo Replication setting for a dual-region bucket. The possible values are DEFAULT and ASYNC_TURBO. Trying to set the rpo for a non dual-region bucket will throw an exception. Non existence of this parameter is equivalent to it being DEFAULT.

The name of the protocol to use. Defaults to gs.

The name of the protocol to unregister. Defaults to gs.

The URI to accept an upload request.

The data to be uploaded

[optional] Configuration Options. Refer to Google\Cloud\Core\Upload\AbstractUploader::__construct().

The timestamp value.

[optional] The number of nanoseconds in the timestamp.

Configuration options.

If set, this is the ID of the project which will be billed for the request.

Configuration Options

If present, only keys for the given service account are returned.

Whether or not to show keys in the DELETED state.

If set, this is the ID of the project which will be billed for the request.

The project ID to use, if different from that with which the client was created.

The ID of the HMAC Key.

[optional] The project ID to use, if different from that with which the client was created.

[optional] HMAC key metadata.

Email address of the service account.

Configuration Options

If set, this is the ID of the project which will be billed for the request. NOTE: This option is currently ignored by Cloud Storage.

The project ID to use, if different from that with which the client was created.