Discover object storage with the Google Cloud console

Learn how to get started with Cloud Storage usingthe Google Cloud console.

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


To follow step-by-step guidance for this task directly in the Google Cloud console, clickGuide me:

Guide me


Before you begin

  1. 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.
  2. In the Google Cloud console, on the project selector page, select or create 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 role (roles/resourcemanager.projectCreator), which contains theresourcemanager.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.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Make sure that you have the following role or roles on the project: Storage Admin

    Check for the roles

    1. In the Google Cloud console, go to theIAM page.

      Go to IAM
    2. Select the project.
    3. In thePrincipal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check theRole column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to theIAM page.

      Go to IAM
    2. Select the project.
    3. ClickGrant access.
    4. In theNew principals field, enter your user identifier. This is typically the email address for a Google Account.

    5. In theSelect a role list, select a role.
    6. To grant additional roles, clickAdd another role and add each additional role.
    7. ClickSave.
  5. In the Google Cloud console, on the project selector page, select or create 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 role (roles/resourcemanager.projectCreator), which contains theresourcemanager.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.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Make sure that you have the following role or roles on the project: Storage Admin

    Check for the roles

    1. In the Google Cloud console, go to theIAM page.

      Go to IAM
    2. Select the project.
    3. In thePrincipal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check theRole column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to theIAM page.

      Go to IAM
    2. Select the project.
    3. ClickGrant access.
    4. In theNew principals field, enter your user identifier. This is typically the email address for a Google Account.

    5. In theSelect a role list, select a role.
    6. To grant additional roles, clickAdd another role and add each additional role.
    7. ClickSave.

Create a bucket

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

To create a bucket:

  1. In the Google Cloud console, go to the Cloud StorageBuckets page.

    Go to Buckets

  2. ClickCreate toopen the bucket creation form.

  3. Expand each section to enter your bucket information and clickContinue to complete each step:

    1. In theGetting started section, enter a globally unique name for your bucket.

      • Don't include sensitive information in the bucket name, because thebucket namespace is global and publicly visible.

        See bucket naming requirements.
        • Bucket names can only contain lowercase letters, numeric characters, dashes (-), underscores (_), and dots (.). Spaces are not allowed. Names containing dots requireverification.
        • 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".
    2. In theChoose where to store your data section, select theRegionradio button as theLocation type. Selecting the region option reveals adrop-down field. Use the default value in this field.

    3. In theChoose how to store your data section, use the default values.

    4. In theChoose how to control access to objects section, do the following:

      1. Clear the checkbox next toEnforce public access prevention on this bucket; this lets youshare the object later.

      2. ForAccess control, use the default value.

    5. In theChoose how to protect object data section, use the default value.

  4. ClickCreate.

That's it — you've just created a Cloud Storage bucket!

Upload an object into the bucket

To upload a sample object into your new bucket:

  1. Right-click the following image and download it to your computer.

    The image of a kitten to upload into the bucket.

  2. In the Cloud Storage buckets page, click the name of the bucket thatyou created.

  3. In theObjects tab, clickUpload files.

  4. In the file dialog, go to the file that you downloaded and select it.

After the upload completes, you should see the filename and information aboutthe file, such as its size and type.

Download the object

To download the image from your bucket, clickDownload.

Share the object

To allow public access to the bucket and create a publicly accessible URL forthe image:

  1. Click thePermissions tab above the list of files.

  2. Click theGrant Access button to add a newPrincipal.

    TheAdd principals pane appears.

  3. In theNew principals box, enterallUsers.

  4. In theSelect a role drop-down, selectCloud Storage > Storage ObjectViewer.

  5. ClickSave.

  6. In theAre you sure you want to make this resource public? window, clickAllow public access.

To verify, click theObjects tab to return to the list of objects. Yourobject'sPublic access column should readPublic to internet.TheCopy URL button provides a shareable URL similar to the following:https://storage.googleapis.com/YOUR_BUCKET_NAME/kitten.png

To remove public access from the bucket and stop sharing the image publicly:

  1. Click thePermissions tab above the list of objects.

  2. Click the checkbox associated with the entry that hasallUsers listed inthePrincipal column.

  3. Click theRemove Access button.

  4. In the dialog that appears, clickConfirm.

In theObjects tab, you should see that the image no longer has aCopy URL button associated with it.

Note: After you remove public access to the image, you may be able toaccess a cached version of it for a period of time.

Create folders

  1. In theObjects tab, clickCreate folder.

  2. Enterfolder1 forName and clickCreate.

You should see the folder in the bucket with an image of a folder icon todistinguish it from objects.

Create a subfolder and upload a file to it:

  1. Clickfolder1.

  2. ClickCreate folder.

  3. Enterfolder2 forName and clickCreate.

  4. Clickfolder2.

  5. ClickUpload files.

  6. In the file dialog, navigate to the screenshot that you downloaded andselect it.

After the upload completes, you should see the filename and information aboutthe file, such as its size and type.

Delete the objects

  1. Click the arrow next toBucket details to return to the buckets level.

  2. Select the bucket.

  3. Select the checkbox next tofolder1.

  4. Click theDelete button.

  5. In the window that opens, confirm you want to proceed with the deletion.

  6. ClickDelete to delete the folder and all objects and subfolders in it.

Clean up

To avoid incurring charges to your Google Cloud account for the resources used on this page, follow these steps.

  1. Open the Cloud Storage buckets page in the Google Cloud console.
    Open the Buckets page
  2. Select the checkbox next to the bucket that you created.
  3. ClickDelete.
  4. In the window that opens, confirm you want to delete the bucket.
  5. ClickDelete.

What's next

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

Last updated 2025-12-17 UTC.