Skip to main content

What's new with the Astra Control REST API

Contributors dmp-netapp RSS

NetApp regularly updates the Astra Control REST API to bring you new features, enhancements, and bug fixes.

14 March 2024 (24.02)

Both Astra Control Service and Astra Control Center have been updated with the 24.02 release.

Minor bug fixes

The 24.02 release focuses primarily on fixing a number of minor bugs. No new resource types have been added to the Astra Control API.

Tech preview: Declarative Kubernetes workflows

Astra Control Center 24.02 includes declarative Kubernetes functionality that enables you to perform data management from a native Kubernetes custom resource (CR). This feature is not yet generally available. See Astra Control Center: What's new for more information if needed.

7 November 2023 (23.10)

Both Astra Control Service and Astra Control Center have been updated with the 23.10 release. There are selective enhancements to the REST API to support the new features.

Expanded storage backends

You can enable backup and restore operations for ontap-nas-economy storage backends.

Immutable backups

Astra Control now supports unalterable, read-only backups as an additional security layer against malware and other threats.

Enhanced control over execution hooks

Beginning with this release, execution hooks functionality can be enabled or disabled for additional security (it is disabled by default). If you have not yet created execution hooks for use with Astra Control, you need to enable the execution hooks feature to begin creating hooks. If you created execution hooks prior to this release, the execution hooks functionality stays enabled and you can use hooks as you would normally.

27 July 2023 (23.07)

This release includes selective enhancements to the REST API. Both Astra Control Service and Astra Control Center have been updated with the 23.07 release.

Clone and replication operations

The clone operation now supports live clones only (the current state of the managed application). To clone from a snapshot or backup, you need to use the restore operation. Also, applications can now be replicated between ONTAP storage backends within the same Kubernetes cluster.

Expanded storage backends

Additional storage backends can now be used with Astra Control Center including:

  • NetApp MetroCluster in a stretch configuration

  • Longhorn 1.5.0 and later

New execution hook type

The new execution hook type post-failover is available with Astra Control Center.

27 June 2023 (23.06)

This release includes selective updates to the REST API.

Azure Marketplace

The Azure Marketplace subscriptions are now billed per hour instead of per minute. Also see Set up billing.

Restic optimization

You can enable performance optimization for restic backups using the flag useResticParallel in the new astra.datamover settings API resource. When set to true, the number of backendConnections that restic uses is increased when backing up large volumes to an Azure container. For volumes of 1TB through 4TB, 128 connections are used. For volumes larger than 4TB, 512 backend connections are used.

30 May 2023 (23.05)

This release includes selective updates to the REST API.

Selective restore operations

You can select the destination storage class during restore or clone operations.

Enable dynamic ANF pools for self-managed clusters

When backing up a managed app in a private on-premises cluster that has an ANF storage backend, you can now enable the dynamic ANF pools feature by providing a subscription ID. See Enable dynamic ANF pools for more information.

25 April 2023 (23.04)

This release includes selective updates to the REST API.

Selective restore operations

You can selectively include or exclude application resources during restore operations. This is done using a filter rule based on a specific namespace, name, label, or GroupVersionKind value.

Support for data-only applications

Support for managing applications has been extended to data-only apps.

17 January 2023 (23.01)

This release includes a minor update to the REST API.

Enhanced execution hooks functionality with filters

When using execution hooks, you can now add filters to control which containers a hook will match to. If you create multiple filters for a single execution hook, they are combined with a logical AND operator. You can define up to 10 active filters per execution hook.

22 November 2022 (22.11)

This release includes an expansion and update of the REST API as well as enhanced namespace and LDAP support.

New and enhanced Astra resources

Four new resources types have been added: apiResource, ldapGroup, ldapUser, and task. In addition, several existing resources and endpoints have been enhanced.

Monitoring support for long-running tasks

The new task endpoints provide access to managed task resources and can be used to display the status of internal long-running tasks.

Enhanced namespace usage scenarios

Support has been added for apps that span multiple namespaces as well as cluster resources associated with namespace-qualified resources.

Expanded cloud subscriptions

Multiple account subscriptions can now be added for each of the cloud providers.

Additional workflows

Additional workflows illustrating the Astra Control REST API have been added. See Infrastructure workflows and Management workflows for more information.

Related information

10 August 2022 (22.08)

This release includes an expansion and update of the REST API as well as enhanced security and administrative features.

New and enhanced Astra resources

Three new resources types have been added: Certificate, Group, and AppMirror. In addition, the versions of several existing resources have been updated.

LDAP authentication

You can optionally configure Astra Control Center to integrate with an LDAP server to authenticate selected Astra users. See LDAP configuration for more information.

Enhanced execution hook

Support for execution hooks was added with the Astra Control 21.12 release. In addition to the existing pre-snapshot and post-snapshot execution hooks, you can now configure the following types of execution hooks with the 22.08 release:

  • Pre-backup

  • Post-backup

  • Post-restore

Astra Control now also allows same script to be used for multiple execution hooks.

Application replication using SnapMirror

You can now replicate data and application changes among clusters using NetApp SnapMirror technology. This enhancement can be used to improve your business continuity and recovery capabilities.

26 April 2022 (22.04)

This release includes an expansion and update of the REST API as well as enhanced security and administrative features.

New and enhanced Astra resources

Two new resources types have been added: Package and Upgrade. In addition, the versions of several existing resources have been upgraded.

Enhanced RBAC with namespace granularity

When binding a role to an associated user, you can limit the namespaces the user has access to. See the Role Binding API reference and RBAC security for more information.

Bucket removal

You can remove a bucket when it is no longer needed or is not functioning properly.

Support for Cloud Volumes ONTAP

Cloud Volumes ONTAP is now supported as a storage backend.

Additional product enhancements

There are several additional enhancements to the two Astra Control product implementations, including:

  • Generic ingress for Astra Control Center

  • Private cluster in AKS

  • Support for Kubernetes 1.22

  • Support for VMware Tanzu portfolio

See the What's new page at the Astra Control Center and Astra Control Service documentation sites.

14 December 2021 (21.12)

This release includes an expansion of the REST API along with a change to the documentation structure to better support the evolution of Astra Control through the future release updates.

Separate Astra Automation documentation for each release of Astra Control

Every release of Astra Control includes a distinct REST API that has been enhanced and tailored to the features of the specific release. The documentation for each release of the Astra Control REST API is now available at its own dedicated web site along with the associated GitHub content repository. The main doc site Astra Control Automation always contains the documentation for the most current release. See Earlier versions of Astra Control Automation documentation for information about prior releases.

Expansion of the REST resource types

The number of REST resource types has continued to expand with an emphasis on execution hooks and storage backends. The new resources include: account, execution hook, hook source, execution hook override, cluster node, managed storage backend, namespace, storage device, and storage node. See Resources for more information.

NetApp Astra Control Python SDK

NetApp Astra Control Python SDK is an open source package that makes it easier to develop automation code for your Astra Control environment. At the core is the Astra SDK which includes a set of classes to abstract the complexity of the REST API calls. There is also a toolkit script to execute specific administrative tasks by wrapping and abstracting the Python classes. See NetApp Astra Control Python SDK for more information.

5 August 2021 (21.08)

This release includes the introduction of a new Astra deployment model and a major expansion of the REST API.

Astra Control Center deployment model

In addition to the existing Astra Control Service offering provided as a public cloud service, this release also includes the Astra Control Center on-premises deployment model. You can install Astra Control Center at your site to manage your local Kubernetes environment. The two Astra Control deployment models share the same REST API, with minor differences noted as needed in the documentation.

Expansion of the REST resource types

The number of resources accessible through the Astra Control REST API has greatly expanded, with many of the new resources providing a foundation for the on-premises Astra Control Center offering. The new resources include: ASUP, entitlement, feature, license, setting, subscription, bucket, cloud, cluster, managed cluster, storage backend, and storage class. See Resources for more information.

Additional endpoints supporting an Astra deployment

In addition to the expanded REST resources, there are several other new API endpoints available to support an Astra Control deployment.

OpenAPI support

The OpenAPI endpoints provide access to the current OpenAPI JSON document and other related resources.

OpenMetrics support

The OpenMetrics endpoints provide access to account metrics through the OpenMetrics resource.

15 April 2021 (21.04)

This release includes the following new features and enhancements.

Introduction of the REST API

The Astra Control REST API is available for use with the Astra Control Service offering. It has been created based on REST technologies and current best practices. The API provides a foundation for the automation of your Astra deployments and includes the following features and benefits.

Resources

There are fourteen REST resource types available.

API token access

Access to the REST API is provided through an API access token which you can generate at the Astra web user interface. The API token provides secure access to the API.

Support for collections

There is a rich set of query parameters which can be used to access the resources collections. Some of the supported operations include filtering, sorting, and pagination.