Creating buckets and uploading objects in GCP - Visual Walkthrough

Process Flow - Creating buckets and uploading objects

Start

↓

Create Bucket Request

↓

Bucket Created in Storage

↓

Upload Object Request

↓

Object Stored in Bucket

↓

End

This flow shows creating a storage bucket first, then uploading an object into that bucket step-by-step.

Execution Sample

GCP

from google.cloud import storage
client = storage.Client()
bucket = client.bucket('my-new-bucket')
bucket.location = 'US'
bucket = client.create_bucket(bucket)
blob = bucket.blob('file.txt')
blob.upload_from_string('Hello Cloud!')

This code creates a new bucket and uploads a text file with content 'Hello Cloud!' into it.

Process Table

Step	Action	Input	Result	State Change
1	Initialize Storage Client	None	Client object ready	client created
2	Create Bucket	Bucket name: 'my-new-bucket'	Bucket created in cloud storage	bucket created
3	Create Blob object	Blob name: 'file.txt'	Blob object ready to upload	blob created
4	Upload Object	Content: 'Hello Cloud!'	Object stored in bucket	object uploaded
5	End	None	Process complete	final state stable

💡 All steps completed successfully; bucket and object exist in cloud storage.

Status Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	After Step 4	Final
client	None	Storage Client instance	Storage Client instance	Storage Client instance	Storage Client instance	Storage Client instance
bucket	None	None	Bucket object for 'my-new-bucket'	Bucket object	Bucket object	Bucket object
blob	None	None	None	Blob object for 'file.txt'	Blob object	Blob object
object_content	None	None	None	None	'Hello Cloud!'	'Hello Cloud!'

Key Moments - 3 Insights

Why do we create a blob object before uploading?

The blob object represents the file inside the bucket. Step 3 shows creating this object so we can upload content to it in step 4.

Can we upload an object before creating the bucket?

No, as shown in step 2, the bucket must exist first to hold objects. Uploading happens only after bucket creation.

What happens if the bucket name already exists?

The create_bucket call would fail or raise an error because bucket names must be unique globally. This is why step 2 is critical and must succeed.

Visual Quiz - 3 Questions

Look at the execution table, what is the state of 'blob' after step 3?

A Blob object for 'file.txt' created

B Blob object not created yet

C Blob object uploaded

D Blob object deleted

💡 Hint

Check the 'State Change' column in row for step 3.

At which step is the object content actually stored in the bucket?

A Step 3

B Step 4

C Step 2

D Step 1

💡 Hint

Look for the step where 'object uploaded' appears in the 'State Change' column.

If the bucket creation failed, what would be the state of 'bucket' after step 2?

A Bucket object created

B Blob object created

C Bucket object None or error

D Object uploaded

💡 Hint

Refer to the 'variable_tracker' for 'bucket' variable after step 2.

Concept Snapshot

Create a bucket first using client.create_bucket('bucket-name').
Create a blob object with bucket.blob('object-name').
Upload content with blob.upload_from_string('content').
Bucket must exist before uploading.
Bucket names are globally unique.
Objects are stored inside buckets.

Full Transcript

This lesson shows how to create a storage bucket and upload an object into it on Google Cloud Platform. First, a storage client is initialized. Then, a bucket is created with a unique name. Next, a blob object representing the file is created inside the bucket. Finally, the content is uploaded to the blob, storing the object in the bucket. Each step changes the state of variables: client, bucket, blob, and object content. Beginners often wonder why the blob is created before uploading and why the bucket must exist first. The execution table and variable tracker clarify these points. The quiz tests understanding of when objects are created and stored, and what happens if bucket creation fails.

Practice

1. What is the main purpose of creating a bucket in Google Cloud Storage?

easy

A. To manage user permissions

B. To organize and store files in the cloud

C. To create databases

D. To run virtual machines

Solution

1. Step 1: Understand what a bucket is

   A bucket is a container in cloud storage used to hold files or objects.

2. Step 2: Identify the purpose of buckets

   Buckets help organize and store files safely in the cloud for easy access and management.

3. Final Answer:

   To organize and store files in the cloud -> Option B

4. Quick Check:

   Bucket = Storage container [OK]

Hint: Buckets hold files in cloud storage, not run machines [OK]

Common Mistakes:

• Confusing buckets with virtual machines
• Thinking buckets create databases
• Mixing buckets with user permission tools

2. Which command correctly creates a new bucket named my-bucket in Google Cloud Storage using the gcloud tool?

easy

A. gcloud storage buckets create my-bucket

B. gcloud create bucket my-bucket

C. gsutil mb gs://my-bucket

D. gcloud storage create-bucket my-bucket

Solution

1. Step 1: Recall the gcloud syntax for bucket creation

   The correct syntax is gcloud storage buckets create [BUCKET_NAME].

2. Step 2: Match the command with the correct syntax

   gcloud storage buckets create my-bucket matches the correct syntax exactly.

3. Final Answer:

   gcloud storage buckets create my-bucket -> Option A

4. Quick Check:

   gcloud storage buckets create = create bucket [OK]

Hint: Use 'gcloud storage buckets create' to make buckets [OK]

Common Mistakes:

• Using 'gcloud create bucket' which is invalid syntax
• Confusing gsutil command with gcloud syntax
• Adding hyphens incorrectly in command

3. What will be the result of running this command?
gsutil cp file.txt gs://example-bucket/

medium

A. Downloads file.txt from example-bucket

B. Deletes file.txt from local storage

C. Creates a new bucket named example-bucket

D. Uploads file.txt to the example-bucket in Google Cloud Storage

Solution

1. Step 1: Understand the gsutil cp command

   The gsutil cp command copies files between local and cloud storage.

2. Step 2: Analyze the command arguments

   It copies file.txt from local to the bucket gs://example-bucket/, uploading the file.

3. Final Answer:

   Uploads file.txt to the example-bucket in Google Cloud Storage -> Option D

4. Quick Check:

   gsutil cp local-to-bucket = upload [OK]

Hint: gsutil cp localfile gs://bucket = upload file [OK]

Common Mistakes:

• Thinking cp deletes local files
• Assuming it creates buckets automatically
• Confusing upload with download direction

4. You tried to upload a file using gsutil cp myfile.txt gs://my-bucket/ but got an error saying the bucket does not exist. What is the most likely fix?

medium

A. Run the command with sudo

B. Rename the file to match the bucket name

C. Create the bucket first using gsutil mb gs://my-bucket

D. Delete the file and try again

Solution

1. Step 1: Understand the error cause

   The error means the bucket my-bucket does not exist in cloud storage.

2. Step 2: Fix by creating the bucket

   You must create the bucket first using gsutil mb gs://my-bucket before uploading files.

3. Final Answer:

   Create the bucket first using gsutil mb gs://my-bucket -> Option C

4. Quick Check:

   Bucket missing? Create it first [OK]

Hint: Create bucket before upload to avoid errors [OK]

Common Mistakes:

• Trying to upload without bucket creation
• Changing file name instead of bucket
• Using sudo unnecessarily

5. You want to create a bucket named data-archive in the us-central1 region with versioning enabled to keep old versions of files. Which sequence of commands achieves this?

hard

A. gsutil mb -l us-central1 gs://data-archive && gsutil versioning set on gs://data-archive

B. gcloud storage buckets create data-archive --location=us-central1 && gcloud storage buckets update data-archive --versioning-enabled

C. gcloud storage buckets create data-archive --region=us-central1 && gcloud storage buckets enable-versioning data-archive

D. gsutil create bucket data-archive us-central1 && gsutil enable versioning gs://data-archive

Solution

1. Step 1: Create bucket with location using gsutil

   The command gsutil mb -l us-central1 gs://data-archive creates the bucket in the correct region.

2. Step 2: Enable versioning on the bucket

   The command gsutil versioning set on gs://data-archive turns on versioning to keep old file versions.

3. Final Answer:

   gsutil mb -l us-central1 gs://data-archive && gsutil versioning set on gs://data-archive -> Option A

4. Quick Check:

   Create bucket + enable versioning with gsutil [OK]

Hint: Use gsutil mb and gsutil versioning set on for versioned buckets [OK]

Common Mistakes:

• Using wrong flags like --region instead of -l
• Trying to enable versioning with wrong commands
• Mixing gcloud and gsutil commands incorrectly