API Changelog

New: Action approval methods

Methods protected by an action approval rule no longer carry out the action right away. Instead, Eon intercepts the call, responds with 201, and returns an action request in the CREATED status in the actionApprovalRequest object. Three new methods let you complete the flow:

• [Submit My Action Request]: Submits an action request for approval, or discards it.

• [Get My Action Request]: Retrieves an action request created with the current caller’s credentials.

• [Cancel My Action Request]: Cancels an action request that’s approved or pending approval.

New: Source account deletion

[Delete Source Account] is a new method that permanently removes a source account from a project. The method is available only for source accounts whose status is DISCONNECTED or INSUFFICIENT_PERMISSIONS. Accounts in CONNECTED status must be disconnected before they can be deleted.

New: MongoDB Atlas backup and restore

MongoDB Atlas is now a supported cloud provider across the API. New values are available in requests and responses where applicable:

• MONGO_ATLAS cloud provider in source accounts, restore accounts, vaults, resources, backup policies, backup jobs, restore jobs, roles, and cost data.

• ATLAS_MONGODB_CLUSTER resource type in resources, snapshots, backup jobs, restore jobs, backup policies, and roles.

• ATLAS_MONGODB_CLUSTER_BACKUP and ATLAS_MONGODB_CLUSTER_BACKUP_FULL backup types in List Backup Jobs and Get Backup Job.

• ATLAS_CLUSTER_RESTORE and ATLAS_CLUSTER_RECORD_RESTORE restore types in [List Restore Jobs] and Get Restore Job.

• MONGO_ATLAS_CLUSTER_METERING_DIMENSION metering dimension in [Query Cost Data].

New: Restore BigQuery datasets

[Restore BigQuery Dataset] is a new method that restores a BigQuery dataset snapshot to a destination dataset.

Updated: Backup policy types and resource selectors

Several new backup policy types and resource selector fields are now available across the backup policies API:

New: IdP group role assignments

Map identity provider groups to Eon roles for automated access control:

• [List Identity Providers].

• [Create IdP Group Role Assignment].

• [List IdP Group Role Assignments].

• [Get IdP Group Role Assignment].

• [Update IdP Group Role Assignment].

• [Delete IdP Group Role Assignment].

New: Manage Eon access with roles and permissions

The new Roles API enables programmatic management of roles within your organization. These methods allow you to create, view, update, and delete roles for fine-grained access control:

• [List Permissions]: See all available permissions in the system. Use this method to discover which permissions can be assigned to roles and whether a permission can be limited to a subset of resources.

• [Create Role]: Create a role with custom permissions.

• [List Roles]: Retrieve all roles in your organization with optional filtering.

• [Get Role]: Retrieve details for a specific role by ID.

• [Update Role]: Modify an existing role’s name, description, or permissions.

• [Delete Role]: Remove a role from your organization.

New: Hold and remove hold on snapshots

Two new snapshot management methods allow you to control snapshot retention by placing or removing holds on snapshots:

• [Hold Snapshot]: Prevents a snapshot from being deleted until the hold is removed.

• [Remove Snapshot Hold]: Removes an existing hold, allowing the snapshot to be subject to normal retention policies.

Updated: 15-minute backup intervals for AWS EC2

High-frequency backup policies now support 15-minute backup intervals for AWS EC2 instances. This enables more granular backup schedules for workloads that require minimal data loss.

The intervalMinutes property now accepts a value of 15 in addition to existing options. The resourceType property in high-frequency plans now accepts AWS_EC2 as a valid value.

Updated: Control Azure VM startup after restore

[Restore Azure VM Instance] now supports an optional startInstanceAfterRestore property in the destination.azureVm object, allowing you to control whether the restored VM automatically starts after the restore operation completes.

Updated: GCP source accounts include folder and organization IDs

New: Take on-demand snapshots

The new [Take Snapshot] method allows you to create on-demand snapshots of your resources outside of scheduled backup policies. Use this method when you need to capture a backup before making critical changes or for ad-hoc backup requirements.

Updated: Backup policies support Google Cloud Storage buckets

Updated: Minimum page size

The pageSize query parameter now has an explicit minimum value of 1 across pagination-enabled API methods. This validation applies to:

• [Query Cost Data]
• List Backup Jobs
• [Get Query Result]
• [List Resources]
• [List Resource Snapshots]
• [List Restore Accounts]
• [List Restore Jobs]
• [List Source Accounts]
• [List Vaults]

Updated: Restore files and buckets to Google Cloud Storage

You can now restore files and buckets to Google Cloud Storage (GCS) destinations. The following restore methods now support an optional destination.gcsBucket parameter:

• [Restore Bucket]: Restore a bucket snapshot to a GCS bucket.

• [Restore Files]: Restore files from a snapshot to a GCS bucket.

New: Manage vaults

Three new methods allow you to create and manage vaults programmatically:

• [Create Vault]: Create a vault in your project with support for customer-managed KMS keys.

• [Get Vault]: Retrieve details about a specific vault.

• [Update Vault]: Modify an existing vault’s display name.

Updated: Group billing data by resource and vault

[Query Cost Data] now supports a new grouping option that combines resource and vault information. Use RESOURCE_AND_VAULT in the groupBy parameter to analyze costs broken down by both resource and vault, providing more detailed cost attribution.

Updated: Default page sizes

New: Rotate API client secrets

Two new methods allow you to rotate your API client secrets to keep your credentials secure:

• [Rotate API Client Secret]: Rotate the client secret for any API client credentials by specifying the client ID.
• [Rotate Current API Client Secret]: Rotate the client secret for the API credentials used in the current request.

New: GCP resource restore methods

Three new restore methods expand your Google Cloud Platform recovery options:

• [Restore GCP Cloud SQL Instance]
• [Restore GCP Disk]
• [Restore GCP VM Instance]

Updated: Vault account information

New: GCP Cloud SQL Instance support

You can now work with Google Cloud SQL instances across the Eon API. The GCP_CLOUD_SQL_INSTANCE resource type is now supported by these APIs:

• Backup policies with [Create Backup Policy], [Update Backup Policy], [Get Backup Policy], and [List Backup Policies].

• Backup jobs with List Backup Jobs and Get Backup Job.

• Resources with [List Resources], [Get Resource], and [List Resource Snapshots].

• Snapshots with [Get Snapshot].

• Billing with [Query Cost Data].

New: Restore Azure VM

The new [Restore Azure VM Instance] method allows you to restore Azure virtual machines to your connected restore accounts.

New: Source and restore account metrics configuration

New metrics configuration endpoints allow you to send metrics for source and restore accounts to Amazon CloudWatch.

New: Query backup costs with the Billing API

The new [Query Cost Data] method allows you to analyze your backup costs by cloud provider, resource type, and individual resources. Use Query Cost Data to track spending patterns, identify cost optimization opportunities, and generate detailed billing reports for your backup operations.

This release introduces quite a few new API methods, as well as some updates to existing methods.

New: Source and restore account methods

These methods for managing source and restore accounts are new in this release:

• Source accounts:
  • [List Source Accounts]
  • [Disconnect Source Account]
  • [Reconnect Source Account]
• Restore accounts:
  • [Disconnect Restore Account]
  • [Reconnect Restore Account]
  • [Get Restore Account Connectivity Configuration]
  • [Update Restore Account Connectivity Configuration]
  • [Delete Restore Account Connectivity Configuration]