Requester Pays is a feature that Google provides as an optional setting for data stored on the Google Cloud Platform. For example, owners of a dataset who wish to make the data accessible to the masses, but do not want to pay the charges incurred every time someone reads or copies the data could enable the requester pays option.
This article explains what to expect when interacting with data in a requester pays bucket on Terra. Note that there are no plans to enable the requester pays feature on workspaces or buckets created on Terra in the future. This is solely a guide to help Terra users when they encounter data that is already in a requester pays bucket.
- What is requester pays?
- How to access requester pays data
- With an active billing project
- With free credits
- With a new Billing Project
- Charges for which you are responsible
- What happens when you leave a workspace with requester pays data enabled
What is requester pays?
In general, whenever accessing data in a bucket in Google Cloud, your actions will generate an associated charge. Actions that generate charges include:
- Performing a request
- Reading data
- Retrieving data
- Storing data
In the default setting (without the feature enabled), these costs are all charged to the Google Billing Account that was used to create the bucket (the owner of the data, in other words). However, in some cases, data custodians will want to host data without being on the hook for every costly action taken in the bucket they are publicly hosting.
If the owners of the data wish, they can enable the Requester Pays feature on a particular bucket. When the feature is enabled, the host of the data only pays for the storage, whereas any other costs are charged to the user accessing the data.
How to access requester pays data
If you attempt to access data in a bucket or workspace that has "Requester Pays" enabled, Terra will alert you with one of the three following pop-up windows. The alert you will see depends on which options are available to you.
1. With an active Billing Project
If you have a Billing Project to which you can charge any costs you incur, you will see a pop-up with a drop-down menu allowing you to select the Billing Project that should be charged:
2. With free credits
If you do not have a Billing Project that you can use, but you are still eligible for free credits, the pop-up you see upon trying to access data will prompt you to activate your free credit account:
3. With a new Billing Project
If you have already used up your free credits but have not yet set up your own Billing Project, the pop-up will direct you to the Billing section, where you can set up your account (as described here):
Charges for which you are responsible
The following operations within a Requester Pays workspace generate non-storage-related charges, for which the you, the requester, are responsible:
- Listing files in the “Files” section of the Data tab
- Previewing files in the Data tab (either from the “Files” section or an entity table)
- Downloading files in the Data tab (either from the “Files” section or an entity table)
- Listing notebooks in the “Notebooks” tab
- Getting a read-only preview of a notebook
- Launching a notebook for editing (if you have can-compute permission on the workspace)
- Copying a notebook to another workspace
- Copying notebooks when cloning a workspace
What happens when you leave a requester pays workspace
Please note that when you leave a Requester Pays workspace, the Billing Project selection you made will be cleared, and the next time you enter that workspace, you will be prompted to select a Billing Project again.