Edit an Archiving Rule¶
You can modify the number of days to keep data on the Atlas cluster (the Age Limit) or the custom JSON query used to select documents for archiving from the Atlas UI and API.
Edit an Archiving Rule Through the UI¶
To edit an online archive, in your Atlas UI:
Navigate to the Clusters page for your project.¶
- If it is not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
- If it is not already displayed, select your desired project from the Projects menu in the navigation bar.
- If the Clusters page is not already displayed, click Clusters in the sidebar.
Navigate to the Online Archive tab for your cluster.¶
- Click the name of the cluster.
- Click the Online Archive tab to view the list of online archives, if any, for the cluster.
Click the ellipsis (...
) in the Actions column for the online archive to display the list of allowed actions.¶
You can:
- Pause Archive (only if state is Active)
- Edit Archiving Rule
- Delete Archive
- Resume Archive (only if state is Paused)
Click and make changes to your archiving rule.¶
If you are modifying a criteria based on a combination of a date and number of days to store the data on the Atlas cluster:
- Select Edit Age Limit.
- Modify the number of days Atlas must store data on the active Atlas cluster in the Enter a new age limit field.
- Click Save for the changes to take effect.
If you are modifying a custom query for selecting documents to archive:
- Select Edit Custom Query.
- Enter the JSON query to run to select documents for archiving.
Atlas uses the specified query with the
db.collection.find(query) command. The empty
document
{}
to return all documents is not supported. - Click Save for the changes to take effect.
Edit the Partition on the Cloud Object Store¶
You cannot modify the partition fields or structure from the Atlas
UI or API. However, you can manually migrate the data from the cloud
object storage using mongodump
, delete
the online archive, use mongorestore
to restore the data on the
Atlas cluster, and then create a new online archive for the
collection with the desired partition fields and/or structure.
Edit an Archiving Rule Through the API¶
To edit an online archive through the API, send a PATCH
request
to the onlineArchives endpoint with the
unique ID of the online archive to update. To learn more about the
API syntax and options, see Update an Online Archive.