Beta
This library is covered by the Pre-GA Offerings Terms
of the Terms of Service. Pre-GA libraries might have limited support,
and changes to pre-GA libraries might not be compatible with other pre-GA versions.
For more information, see the
launch stage descriptions .
public static final class GrpcStorageOptions.Builder extends StorageOptions.Builder
Inherited Members
com.google.cloud.ServiceOptions.Builder.getAllowedClientLibTokens()
com.google.cloud.ServiceOptions.Builder.self()
com.google.cloud.ServiceOptions.Builder.setApiTracerFactory(com.google.api.gax.tracing.ApiTracerFactory)
com.google.cloud.ServiceOptions.Builder.setClientLibToken(java.lang.String)
com.google.cloud.ServiceOptions.Builder.setClock(com.google.api.core.ApiClock)
com.google.cloud.ServiceOptions.Builder.setCredentials(com.google.auth.Credentials)
com.google.cloud.ServiceOptions.Builder.setHeaderProvider(com.google.api.gax.rpc.HeaderProvider)
com.google.cloud.ServiceOptions.Builder.setHost(java.lang.String)
com.google.cloud.ServiceOptions.Builder.setProjectId(java.lang.String)
com.google.cloud.ServiceOptions.Builder.setQuotaProjectId(java.lang.String)
com.google.cloud.ServiceOptions.Builder.setRetrySettings(com.google.api.gax.retrying.RetrySettings)
com.google.cloud.ServiceOptions.Builder.setServiceFactory(com.google.cloud.ServiceFactory<ServiceT,OptionsT>)
com.google.cloud.ServiceOptions.Builder.setServiceRpcFactory(com.google.cloud.spi.ServiceRpcFactory<OptionsT>)
com.google.cloud.ServiceOptions.Builder.setTransportOptions(com.google.cloud.TransportOptions)
com.google.cloud.ServiceOptions.Builder.setUniverseDomain(java.lang.String)
Methods
build()
public GrpcStorageOptions build()
Beta
This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.
Overrides
self()
protected GrpcStorageOptions.Builder self()
Overrides
com.google.cloud.ServiceOptions.Builder.self()
setAttemptDirectPath(boolean attemptDirectPath)
public GrpcStorageOptions.Builder setAttemptDirectPath(boolean attemptDirectPath)
Beta
This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.
Option which signifies the client should attempt to connect to gcs via Direct Google Access.
NOTE There is no need to specify a new endpoint via #setHost(String) as the
underlying code will translate the normal https://storage.googleapis.com:443
into the
proper Direct Google Access URI for you.
Parameter
Name
Description
attemptDirectPath
boolean
setBlobWriteSessionConfig(@NonNull BlobWriteSessionConfig blobWriteSessionConfig)
public GrpcStorageOptions.Builder setBlobWriteSessionConfig(@NonNull BlobWriteSessionConfig blobWriteSessionConfig)
Parameter
Name
Description
blobWriteSessionConfig
@org.checkerframework.checker.nullness.qual.NonNull com.google.cloud.storage.BlobWriteSessionConfig
Overrides
setClientLibToken(String clientLibToken)
public GrpcStorageOptions.Builder setClientLibToken(String clientLibToken)
Beta
This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.
Parameter
Name
Description
clientLibToken
String
Overrides
com.google.cloud.ServiceOptions.Builder.setClientLibToken(java.lang.String)
setClock(ApiClock clock)
public GrpcStorageOptions.Builder setClock(ApiClock clock)
Beta
This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.
Parameter
Name
Description
clock
ApiClock
Overrides
com.google.cloud.ServiceOptions.Builder.setClock(com.google.api.core.ApiClock)
setCredentials(Credentials credentials)
public GrpcStorageOptions.Builder setCredentials(Credentials credentials)
Beta
This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.
Parameter
Name
Description
credentials
com.google.auth.Credentials
Overrides
com.google.cloud.ServiceOptions.Builder.setCredentials(com.google.auth.Credentials)
setEnableGrpcClientMetrics(boolean enableGrpcClientMetrics)
public GrpcStorageOptions.Builder setEnableGrpcClientMetrics(boolean enableGrpcClientMetrics)
Beta
This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.
Option for whether this client should emit internal gRPC client internal metrics to Cloud
Monitoring. To disable metric reporting, set this to false. True by default. Emitting metrics
is free and requires minimal CPU and memory.
Parameter
Name
Description
enableGrpcClientMetrics
boolean
setGrpcInterceptorProvider(@NonNull GrpcInterceptorProvider grpcInterceptorProvider)
public GrpcStorageOptions.Builder setGrpcInterceptorProvider(@NonNull GrpcInterceptorProvider grpcInterceptorProvider)
Beta
This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.
Parameter
Name
Description
grpcInterceptorProvider
@org.checkerframework.checker.nullness.qual.NonNull com.google.api.gax.grpc.GrpcInterceptorProvider
public GrpcStorageOptions.Builder setHeaderProvider(HeaderProvider headerProvider)
Beta
This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.
Overrides
com.google.cloud.ServiceOptions.Builder.setHeaderProvider(com.google.api.gax.rpc.HeaderProvider)
setHost(String host)
public GrpcStorageOptions.Builder setHost(String host)
Beta
This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.
Parameter
Name
Description
host
String
Overrides
com.google.cloud.ServiceOptions.Builder.setHost(java.lang.String)
setProjectId(String projectId)
public GrpcStorageOptions.Builder setProjectId(String projectId)
Beta
This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.
Parameter
Name
Description
projectId
String
Overrides
com.google.cloud.ServiceOptions.Builder.setProjectId(java.lang.String)
setQuotaProjectId(String quotaProjectId)
public GrpcStorageOptions.Builder setQuotaProjectId(String quotaProjectId)
Beta
This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.
Parameter
Name
Description
quotaProjectId
String
Overrides
com.google.cloud.ServiceOptions.Builder.setQuotaProjectId(java.lang.String)
setRetrySettings(RetrySettings retrySettings)
public GrpcStorageOptions.Builder setRetrySettings(RetrySettings retrySettings)
Beta
This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.
Overrides
com.google.cloud.ServiceOptions.Builder.setRetrySettings(com.google.api.gax.retrying.RetrySettings)
setServiceFactory(ServiceFactory<Storage,StorageOptions> serviceFactory)
public GrpcStorageOptions.Builder setServiceFactory(ServiceFactory<Storage,StorageOptions> serviceFactory)
Beta
This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.
Overrides
com.google.cloud.ServiceOptions.Builder.setServiceFactory(com.google.cloud.ServiceFactory<ServiceT,OptionsT>)
setServiceRpcFactory(ServiceRpcFactory<StorageOptions> serviceRpcFactory)
public GrpcStorageOptions.Builder setServiceRpcFactory(ServiceRpcFactory<StorageOptions> serviceRpcFactory)
Beta
This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.
Parameter
Name
Description
serviceRpcFactory
com.google.cloud.spi.ServiceRpcFactory <StorageOptions >
Overrides
com.google.cloud.ServiceOptions.Builder.setServiceRpcFactory(com.google.cloud.spi.ServiceRpcFactory<OptionsT>)
setStorageRetryStrategy(StorageRetryStrategy storageRetryStrategy)
public GrpcStorageOptions.Builder setStorageRetryStrategy(StorageRetryStrategy storageRetryStrategy)
Beta
This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.
Override the default retry handling behavior with an alternate strategy.
See Also: StorageRetryStrategy#getDefaultStorageRetryStrategy()
Parameter
Name
Description
storageRetryStrategy
StorageRetryStrategy
a non-null storageRetryStrategy to use
Overrides
setTerminationAwaitDuration(Duration terminationAwaitDuration)
public GrpcStorageOptions.Builder setTerminationAwaitDuration(Duration terminationAwaitDuration)
Beta
This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.
Set the maximum duration in which to await termination of any outstanding requests when
calling Storage#close()
Parameter
Name
Description
terminationAwaitDuration
org.threeten.bp.Duration
a non-null Duration to use
setTransportOptions(TransportOptions transportOptions)
public GrpcStorageOptions.Builder setTransportOptions(TransportOptions transportOptions)
Beta
This feature is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.
Parameter
Name
Description
transportOptions
com.google.cloud.TransportOptions
Overrides
com.google.cloud.ServiceOptions.Builder.setTransportOptions(com.google.cloud.TransportOptions)