RetroSearch Browse

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://cloud.google.com/storage/docs/discover-object-storage-gcloud below:

Quickstart: Discover object storage with the gcloud tool | Cloud Storage

Discover
Product overview
Storage Intelligence overview
Get started
Terraform support for Cloud Storage
Configure and manage Storage Intelligence
Create buckets
Create a bucket
Domain-named bucket verification
Access and manage buckets
List buckets
Change the default storage class of a bucket
Move and rename buckets
Delete buckets
Upload and download objects
About objects
Overview of uploads and downloads
Access and manage objects
List objects
Copy, rename, and move objects
Change an object's storage class
Tools to access and manage objects using a directory structure
Object transcoding
Delete objects
Get insights on your stored data
Analyze stored data with Gemini Cloud Assist
Cache objects
About caching
Control data lifecycles
Options for controlling data lifecycles
Make requests
Consistency in Cloud Storage operations
Batched requests
Use long-running operations
Paginate results
URI wildcards
Secure data
Monitor data and usage
Use Cloud Audit Logs with Cloud Storage
Usage logs and storage logs
Use Cloud Audit Logs with storage batch operations
Use Cloud Logs with storage batch operations
Use Cloud Audit Logs with Storage Insights
Use gRPC client-side metrics
Use client-side traces
Protection, backup, and recovery
Overview
Mount buckets with Cloud Storage FUSE
Overview
Quickstart
Install Cloud Storage FUSE
Mount buckets
Work across products, Clouds, and platforms
Best practices for media workloads
Interoperability
Use Cloud Storage with Big Data
Integration with Google Cloud Platform services and tools
Troubleshoot
Troubleshooting

Stay organized with collections Save and categorize content based on your preferences.

Discover object storage with the gcloud tool

This page shows you how to perform basic tasks in Cloud Storage using the gcloud command-line tool.

Costs that you incur in Cloud Storage are based on the resources you use. This quickstart typically uses less than $0.01 USD worth of Cloud Storage resources.

Before you begin

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
Install the Google Cloud CLI.
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
To initialize the gcloud CLI, run the following command:
```
gcloud init
```
Create or select a Google Cloud project.

Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
- Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
- Create a Google Cloud project:
```
gcloud projects create PROJECT_ID
```
  Replace PROJECT_ID with a name for the Google Cloud project you are creating.
- Select the Google Cloud project that you created:
```
gcloud config set project PROJECT_ID
```
  Replace PROJECT_ID with your Google Cloud project name.
Verify that billing is enabled for your Google Cloud project.
Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/storage.admin
```
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
```
Replace the following:
- PROJECT_ID: Your project ID.
- USER_IDENTIFIER: The identifier for your user account. For example, myemail@example.com.
- ROLE: The IAM role that you grant to your user account.
Install the Google Cloud CLI.
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
To initialize the gcloud CLI, run the following command:
```
gcloud init
```
Create or select a Google Cloud project.

Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
- Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
- Create a Google Cloud project:
```
gcloud projects create PROJECT_ID
```
  Replace PROJECT_ID with a name for the Google Cloud project you are creating.
- Select the Google Cloud project that you created:
```
gcloud config set project PROJECT_ID
```
  Replace PROJECT_ID with your Google Cloud project name.
Verify that billing is enabled for your Google Cloud project.
Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/storage.admin
```
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
```
Replace the following:
- PROJECT_ID: Your project ID.
- USER_IDENTIFIER: The identifier for your user account. For example, myemail@example.com.
- ROLE: The IAM role that you grant to your user account.

Note: If you are using Cloud Shell or a Compute Engine instance, the Google Cloud SDK is pre-installed and authenticated. If your Compute Engine instance is set up without a service account scope to Cloud Storage, run gcloud init and follow the instructions. Create a bucket

Buckets are the basic containers that hold your data in Cloud Storage.

To create a bucket:

Open a terminal window.
Use the gcloud storage buckets create command and a unique name to create a bucket:
```
gcloud storage buckets create gs://my-awesome-bucket/ --uniform-bucket-level-access
```
This uses a bucket named "my-awesome-bucket." You must choose your own, globally-unique, bucket name.
See bucket naming requirements.
- Bucket names can only contain lowercase letters, numeric characters, dashes (-), underscores (_), and dots (.). Spaces are not allowed. Names containing dots require verification.
- Bucket names must start and end with a number or letter.
- Bucket names must contain 3-63 characters. Names containing dots can contain up to 222 characters, but each dot-separated component can be no longer than 63 characters.
- Bucket names cannot be represented as an IP address in dotted-decimal notation (for example, 192.168.5.4).
- Bucket names cannot begin with the "goog" prefix.
- Bucket names cannot contain "google" or close misspellings, such as "g00gle".
Caution: Do not include sensitive information in the bucket name, since the bucket namespace is global and publicly visible.
If successful, the command returns:
```
Creating gs://my-awesome-bucket/...
```

You've just created a bucket where you can store your data!

Note: If the bucket name you chose is already in use, either by you or someone else, the command returns:

Creating gs://my-awesome-bucket/...
ServiceException: 409 Bucket my-awesome-bucket already exists.

Try again with a different bucket name.

Upload an object into your bucket

Right-click the image above and save it somewhere on your computer, such as on the desktop.
Note: If you are using Cloud Shell or a Compute Engine instance, download the image using the following command: wget https://cloud.google.com/storage/images/kitten.png

Use the gcloud storage cp command to copy the image from the location where you saved it to the bucket you created:

gcloud storage cp Desktop/kitten.png gs://my-awesome-bucket

If successful, the command returns:

Copying file://Desktop/kitten.png [Content-Type=image/png]...
Uploading   gs://my-awesome-bucket/kitten.png:       0 B/164.3 KiB
Uploading   gs://my-awesome-bucket/kitten.png:       164.3 KiB/164.3 KiB

You've just stored an object in your bucket.

Note: When typing your bucket name, you can use the tab key to autocomplete it. Download the object from your bucket

Use the gcloud storage cp command to download the image you stored in your bucket to somewhere on your computer, such as the desktop:

gcloud storage cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png

If successful, the command returns:

Copying gs://my-awesome-bucket/kitten.png...
Downloading file://Desktop/kitten2.png:               0 B/164.3 KiB
Downloading file://Desktop/kitten2.png:               164.3 KiB/164.3 KiB

You've just downloaded something from your bucket.

Copy the object to a folder in the bucket

Use the gcloud storage cp command to create a folder and copy the image into it:
```
gcloud storage cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png
```
Note: Folders in Cloud Storage have limitations compared to local filesystems, but many of the same operations are supported.
If successful, the command returns:
```
Copying gs://my-awesome-bucket/kitten.png [Content-Type=image/png]...
Copying     ...my-awesome-bucket/just-a-folder/kitten3.png: 164.3 KiB/164.3 KiB
```
You've just copied your image into a new folder in your bucket.

List contents of a bucket or folder

Use the gcloud storage ls command to list the contents at the top level of your bucket:
```
gcloud storage ls gs://my-awesome-bucket
```
If successful, the command returns a message similar to:
```
gs://my-awesome-bucket/kitten.png
gs://my-awesome-bucket/just-a-folder/
```
You've just seen the contents at the top level of your bucket.

List details for an object

Use the gcloud storage ls command, with the --long flag to get some details about a one of your images:
```
gcloud storage ls gs://my-awesome-bucket/kitten.png --long
```
If successful, the command returns a message similar to:
```
2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/kitten.png
TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)
```
You've just obtained information about the image's size and date of creation.

Make the objects publicly accessible

Use the gcloud storage buckets add-iam-policy-binding command to grant all users permission to read the images stored in your bucket:
```
gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer
```
The command is successful if your response contains the following:
```
bindings:
  - members:
    - allUsers
    role: roles/storage.objectViewer
```
Now anyone can get your images.
To remove this access, use the command:
```
gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer
```
The command is successful if no error is returned.

You have removed public access to the images in your bucket.

Note: After you remove public access, you may still be able to access a cached version of one of your images for a period of time. Give someone access to your bucket

Use the gcloud storage buckets add-iam-policy-binding command to give a specific email address permission to add objects to your bucket:

gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=user:jeffersonloveshiking@gmail.com --role=roles/storage.objectCreator

The command is successful if your response contains the following:

bindings:
  - members:
    - user:jeffersonloveshiking@gmail.com
    role: roles/storage.objectCreator

Now someone else can add items to your bucket.

To remove this permission, use the command:

gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=user:jeffersonloveshiking@gmail.com --role=roles/storage.objectCreator

The command is successful if no error is returned.

You have removed the user's access to this bucket.

Delete an object

Use the gcloud storage rm command to delete one of your images:
```
gcloud storage rm gs://my-awesome-bucket/kitten.png
```
If successful, the command returns:
```
Removing gs://my-awesome-bucket/kitten.png...
```
This copy of the image is no longer stored on Cloud Storage (though the copy you made in the folder just-a-folder/ still exists).

Clean up

To avoid incurring charges to your Google Cloud account for the resources used on this page, delete the Google Cloud project with the resources.

Open a terminal window (if not already open).
Use the gcloud storage rm command with the --recursive flag to delete the bucket and anything inside of it:
```
gcloud storage rm gs://my-awesome-bucket --recursive
```
If successful, the command returns a message similar to:
```
Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
Removing gs://my-awesome-bucket/...
```
Your bucket and its contents are deleted.

What's next

Learn about Cloud Storage pricing.

See the reference pages for Google Cloud CLI commands, such as make bucket (buckets create), copy (cp), list (ls), add access (buckets add-iam-policy-binding), and remove (rm).

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-10-02 UTC.

[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-10-02 UTC."],[],[]]

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.5