Sandbox::https://github.com/googleapis/python-storage/blob/main/samples/snippets/storage_upload

This repository was archived by the owner on Mar 31, 2026. It is now read-only.

Repository navigation

History

#!/usr/bin/env python

# Licensed under the Apache License, Version 2.0 (the 'License');

# you may not use this file except in compliance with the License.

# You may obtain a copy of the License at

# http://www.apache.org/licenses/LICENSE-2.0

# Unless required by applicable law or agreed to in writing, software

# distributed under the License is distributed on an "AS IS" BASIS,

# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

# See the License for the specific language governing permissions and

# limitations under the License.

import sys

# [START storage_upload_file]

from google.cloud import storage

def upload_blob(bucket_name, source_file_name, destination_blob_name):

"""Uploads a file to the bucket."""

# The ID of your GCS bucket

# bucket_name = "your-bucket-name"

# The path to your file to upload

# source_file_name = "local/path/to/file"

# The ID of your GCS object

# destination_blob_name = "storage-object-name"

storage_client = storage.Client()

bucket = storage_client.bucket(bucket_name)

blob = bucket.blob(destination_blob_name)

# Optional: set a generation-match precondition to avoid potential race conditions

# and data corruptions. The request to upload is aborted if the object's

# generation number does not match your precondition. For a destination

# object that does not yet exist, set the if_generation_match precondition to 0.

# If the destination object already exists in your bucket, set instead a

# generation-match precondition using its generation number.

generation_match_precondition = 0

blob.upload_from_filename(source_file_name, if_generation_match=generation_match_precondition)

print(

f"File {source_file_name} uploaded to {destination_blob_name}."

)

# [END storage_upload_file]

if __name__ == "__main__":

upload_blob(

bucket_name=sys.argv[1],

source_file_name=sys.argv[2],

destination_blob_name=sys.argv[3],

)

Navigation Menu

Repository navigation

storage_upload_file.py

storage_upload_file.py

FilesExpand file tree

storage_upload_file.py

Latest commit

History

storage_upload_file.py

File metadata and controls