

# Configuring a data access budget
<a name="configure-data-access-budget"></a>

A collaborator can view, add, edit, and delete a *data acccess budget* to set a limit on the number of times a table can be used in a workflow. Use these budgets to manage data and costs.

Each time a table is queried or a job is run using a ML input channel derived from a table, the budget for that table is reduced by one. When the budget reaches zero, the table can't be queried and ML jobs can't be run using ML input channels derived from the table.

You can establish a per period budget that refreshes periodically, a lifetime budget for overall usage, or both. By default, table usage is unlimited.
+ Per period budget – A renewable allocation that limits the amount of times this table can be used within a specified time period. You can set the period to daily, weekly, or monthly. This budget can be set to automatically refresh on a daily, weekly, or monthly basis.
+ Lifetime budget – A running allocation that limits the total amount of times this table can be used.

**Topics**
+ [Viewing a data access budget](view-access-budget.md)
+ [Adding a data access budget to an existing associated table](add-access-budget-to-existing-associated-table.md)
+ [Editing a data access budget](edit-access-budget.md)
+ [Deleting a data access budget](delete-access-budget.md)

# Viewing a data access budget
<a name="view-access-budget"></a>

You can view a data access budget from the **Tables** tab or from the table details page.

**To view a data access budget**

1. Sign in to the AWS Management Console and open the AWS Clean Rooms console at [https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home).

1. In the left navigation pane, choose **Collaborations**.

1. Choose the collaboration.

1. Choose the **Tables** tab.

1. Do one of the following: 
   + Under the **Remaining data access budget** column, select the budget to view the details.
   + Choose a table, and on the table details page, scroll down to view the **Data access budget details** section.

# Adding a data access budget to an existing associated table
<a name="add-access-budget-to-existing-associated-table"></a>

As a collaboration member, you can add a data access budget to an existing associated table.

**To add a data access budget to an existing associated table**

1. Sign in to the AWS Management Console and open the AWS Clean Rooms console at [https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home).

1. In the left navigation pane, choose **Collaborations**.

1. Choose the collaboration.

1. Choose the **Tables** tab.

1. Select the option button next to the table you want to add a data access budget to.

1. From the **Actions** dropdown list, under **Data access budget**, select **Add** (if there isn't already a budget).

1. Choose one of the following budget configurations:    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/clean-rooms/latest/userguide/add-access-budget-to-existing-associated-table.html)

1. Review your selections under **Data access budget summary**.

1.   
**Example**  

   For example, if you've chosen a **Per period budget amount** of 1,000, set the **Period** to **Weekly**, left the **Automatically refresh budget weekly** checkbox selected, and set the **Lifetime budget** to 1,000,000, then the **Access budget summary** will display the following message: Every week, this table can be used up to 1,000 times for running queries or jobs. This budget is set to automatically refresh every Sunday at 00:00 UTC, and will continue to refresh until this table has reached its lifetime budget of 1,000,000 uses.

1. (Optional) If you want to enable **Data access budget tags** for the access budget resource, choose **Add new tag** and enter a Key and Value pair.

1. Choose **Add data access budget**.

# Editing a data access budget
<a name="edit-access-budget"></a>

As a collaboration member, you can edit the data access budget. When you edit a data access budget, it resets the current budget balance.

You can edit a data access budget from the **Tables** tab or from the table details page.

------
#### [ Tables tab ]

**To edit a data access budget from the **Tables** tab**

1. Sign in to the AWS Management Console and open the AWS Clean Rooms console at [https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home).

1. In the left navigation pane, choose **Collaborations**.

1. Choose the collaboration.

1. Choose the **Tables** tab.

1. Select the option button next to the table you want to edit.

1. From the **Actions** dropdown list, under **Data access budget**, select **Edit**.

1. On the **Edit data access budget** page, update the **Per period budget** or **Lifetime budget** information.

1. View the **Data access budget summary** to verify that the edits you've made are correct.

1. Choose **Save changes**.

------
#### [ Table details page ]

**To edit a data access budget from the table details page**

1. Sign in to the AWS Management Console and open the AWS Clean Rooms console at [https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home).

1. In the left navigation pane, choose **Collaborations**.

1. Choose the collaboration.

1. Choose the **Tables** tab.

1. Choose a table.

1. On the table details page, scroll down to the **Data access budget details** section.

1. From the **Actions** dropdown list, choose **Edit**.

1. On the **Edit data access budget** page, update the **Per period budget** or **Lifetime budget** information.

1. Choose **Save changes**.

------

# Deleting a data access budget
<a name="delete-access-budget"></a>

You can delete a data access budget from the **Tables** tab or from the table details page.

------
#### [ Tables tab ]

**To delete a data access budget from the **Tables** tab**

1. Sign in to the AWS Management Console and open the AWS Clean Rooms console at [https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home).

1. In the left navigation pane, choose **Collaborations**.

1. Choose the collaboration.

1. Choose the **Tables** tab.

1. Select the option button next to the table you want to delete.

1. From the **Actions** dropdown list, under **Data access budget**, select **Delete**.
**Important**  
You can't undo this action and your data access budget will be reset to unlimited.

1. If you're certain that you want to delete the data access budget, choose **Delete**.

------
#### [ Table details page ]

**To delete a data access budget from the table details page**

1. Sign in to the AWS Management Console and open the AWS Clean Rooms console at [https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home).

1. In the left navigation pane, choose **Collaborations**.

1. Choose the collaboration.

1. Choose the **Tables** tab.

1. Choose a table.

1. On the table details page, scroll down to the **Data access budget details** section.

1. From the **Actions** dropdown list, choose **Delete**.
**Important**  
You can't undo this action and your data access budget will be reset to unlimited.

1. If you're certain that you want to delete the data access budget, choose **Delete**.

------