Struct object_store::gcp::GoogleCloudStorageBuilder

pub struct GoogleCloudStorageBuilder { /* private fields */ }

Configure a connection to Google Cloud Storage using the specified credentials.

Example

let gcs = GoogleCloudStorageBuilder::new()
 .with_service_account_path(SERVICE_ACCOUNT_PATH)
 .with_bucket_name(BUCKET_NAME)
 .build();

Implementations

impl GoogleCloudStorageBuilder

pub fn new() -> Self

Create a new GoogleCloudStorageBuilder with default values.

pub fn from_env() -> Self

Create an instance of GoogleCloudStorageBuilder with values pre-populated from environment variables.

Variables extracted from environment:

• GOOGLE_SERVICE_ACCOUNT: location of service account file
• GOOGLE_SERVICE_ACCOUNT_PATH: (alias) location of service account file
• SERVICE_ACCOUNT: (alias) location of service account file
• GOOGLE_SERVICE_ACCOUNT_KEY: JSON serialized service account key
• GOOGLE_BUCKET: bucket name
• GOOGLE_BUCKET_NAME: (alias) bucket name

Example

use object_store::gcp::GoogleCloudStorageBuilder;

let gcs = GoogleCloudStorageBuilder::from_env()
    .with_bucket_name("foo")
    .build();

pub fn with_url(self, url: impl Into<String>) -> Self

Parse available connection info form a well-known storage URL.

The supported url schemes are:

• gs://<bucket>/<path>

Note: Settings derived from the URL will override any others set on this builder

Example

use object_store::gcp::GoogleCloudStorageBuilder;

let gcs = GoogleCloudStorageBuilder::from_env()
    .with_url("gs://bucket/path")
    .build();

pub fn try_with_option(
self,
key: impl AsRef<str>,
value: impl Into<String>
) -> Result<Self>

Set an option on the builder via a key - value pair.

pub fn try_with_options<I: IntoIterator<Item = (impl AsRef<str>, impl Into<String>)>>(
self,
options: I
) -> Result<Self>

Hydrate builder from key value pairs

pub fn with_bucket_name(self, bucket_name: impl Into<String>) -> Self

Set the bucket name (required)

pub fn with_service_account_path(
self,
service_account_path: impl Into<String>
) -> Self

Set the path to the service account file.

This or GoogleCloudStorageBuilder::with_service_account_key must be set.

Example "/tmp/gcs.json".

Example contents of gcs.json:

{
   "gcs_base_url": "https://localhost:4443",
   "disable_oauth": true,
   "client_email": "",
   "private_key": ""
}

pub fn with_service_account_key(self, service_account: impl Into<String>) -> Self

Set the service account key. The service account must be in the JSON format.

This or GoogleCloudStorageBuilder::with_service_account_path must be set.

pub fn with_application_credentials(
self,
application_credentials_path: impl Into<String>
) -> Self

Set the path to the application credentials file.

https://cloud.google.com/docs/authentication/provide-credentials-adc

pub fn with_retry(self, retry_config: RetryConfig) -> Self

Set the retry configuration

pub fn with_proxy_url(self, proxy_url: impl Into<String>) -> Self

Set the proxy_url to be used by the underlying client

pub fn with_client_options(self, options: ClientOptions) -> Self

Sets the client options, overriding any already set

pub fn build(self) -> Result<GoogleCloudStorage>

Configure a connection to Google Cloud Storage, returning a new GoogleCloudStorage and consuming self

Trait Implementations

impl Clone for GoogleCloudStorageBuilder

fn clone(&self) -> GoogleCloudStorageBuilder

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GoogleCloudStorageBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for GoogleCloudStorageBuilder

fn default() -> Self

Returns the “default value” for a type.