ToolUp.Storage.GoogleCloud 0.20.0

Prefix Reserved
.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package ToolUp.Storage.GoogleCloud --version 0.20.0
                    


                    

                
NuGet\Install-Package ToolUp.Storage.GoogleCloud -Version 0.20.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="ToolUp.Storage.GoogleCloud" Version="0.20.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="ToolUp.Storage.GoogleCloud" Version="0.20.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="ToolUp.Storage.GoogleCloud" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add ToolUp.Storage.GoogleCloud --version 0.20.0
                    


                    

                
#r "nuget: ToolUp.Storage.GoogleCloud, 0.20.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package ToolUp.Storage.GoogleCloud@0.20.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=ToolUp.Storage.GoogleCloud&version=0.20.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=ToolUp.Storage.GoogleCloud&version=0.20.0
                    


                            Install as a Cake Tool

ToolUp.Storage.GoogleCloud

Google Cloud Storage IBlobStorage companion for ToolUp.Platform. Wraps the GCP SDK to back the platform's storage interface with GCS buckets; supports object versioning, customer-managed encryption keys, and bucket-level retention policies.

Configuration via Application Default Credentials, or an inline service-account JSON string. Production deployments typically pair with GcsEncryptionAtRestValidator to confirm encryption-at-rest is enabled.

Credential rotation

Depends on the credential model. With Application Default Credentials (CredentialsJson = None — the GOOGLE_APPLICATION_CREDENTIALS path, gcloud auth, GCE metadata server, or GKE workload identity), rotation is transparent: the ADC chain refreshes tokens itself, no application change needed.

With an inline service-account JSON (CredentialsJson = Some …), the credential is static — the StorageClient pins it for the process lifetime, so a rolled key fails every call with 403 until restart. To survive rotation without a restart, construct via create with CredentialsJsonProvider = Some f (Phase 2c). f () is read on each operation and the client is rebuilt only when the resolved JSON changes (a change-detection cache, not a per-call reconstruction); the closure typically closes over an ISecretStore.GetSecret read. fromEnv wires the static None path. Prefer workload identity / ADC over inline JSON where the platform allows it. See docs/operations/credential-rotation.md.

The blob_storage:gcs health probe performs a live authenticated list (Phase 2c) against the _platform health prefix, so a rolled-out key surfaces as Unhealthy with the GCS 403 message within one probe cycle — the earlier Exists-based probe swallowed the 403 and read Healthy.

Licensed under Apache-2.0.

Part of the ToolUp Platform SDK — see github.com/ToolUp-Forge/toolup-forge for full documentation.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on ToolUp.Storage.GoogleCloud:

Package Downloads
ToolUp.Cloud.Gcp

GCP cloud umbrella for ToolUp.Platform — transitively pulls ToolUp.Storage.GoogleCloud, ToolUp.Secrets.GcpSecretManager, ToolUp.AuditSinks.GcsArchive, ToolUp.Metrics.OpenTelemetry, plus the OTLP exporter for sending metrics to a Cloud Operations collector. One PackageReference replaces five per-cloud entries.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.22.0 89 8/27/2026
0.21.0 102 8/26/2026
0.20.1 101 8/20/2026
0.20.0 106 8/19/2026