Park and unpark PCU groups in Astra DB

The Astra DB PCU management features are available only for public preview to qualified participants. Development is ongoing, and the features and functionality are subject to change. This preview is governed by your Agreement and the DataStax Preview Terms.

This preview covers two sets of features:

Core PCU management: Create PCU groups, edit PCU groups, and view PCU group usage
Flexible capacity workloads: Select a workload type in the Astra Portal, park PCU groups, and delete PCU groups

DataStax grants access to each set of features separately. To inquire about access to these features, contact your DataStax account representative.

You can park flexible capacity PCU groups to reduce costs and pause usage when those resources aren’t needed.

Prerequisites

Before you park a PCU group, review the following requirements and considerations.

The PCU group must be eligible to park

The group must be a flexible capacity PCU groups, which means that the reserved capacity is zero.
The PCU group cannot have any multi-region databases assigned to it.

While you can put multi-region databases in flexible capacity PCU groups, you can’t park a PCU group that has a multi-region database assigned to it.

Parking a PCU group doesn’t eliminate all costs

Parking a PCU group can help manage costs, but it doesn’t eliminate all costs. For example:

Databases in parked PCU groups incur billed charges for storage.
When you park a PCU group, the group’s HCUs scale down to zero, which pauses hourly billing for that capacity.

Databases in a parked PCU group are hibernated

A parked PCU group’s databases are placed in Hibernated status until you unpark the group or remove the databases from the parked group.

While hibernated, the databases aren’t available for use, and they don’t record backup snapshots.

Unpark the PCU group before editing

If you need to edit a parked PCU group, unpark the PCU group before you make any changes, including adding or removing databases.

Park flexible capacity PCU groups

Astra Portal
DevOps API

In the Astra Portal header, click Settings.
In the Settings navigation menu, click the name of the current organization, and then select the organization where you want to park a PCU group.
In the Settings navigation menu, click Billing.
In the Provisioned Capacity Unit groups section, find the PCU group that you want to park, click More, and then select Park group.

If this option isn’t available, make sure the group is eligible to park, as explained in the Prerequisites. If the group is eligible to park, contact your DataStax account representative to confirm that you have access to the park/unpark feature for PCU groups.

Use POST /v2/pcus/actions/get to get the list of PCU groups in your organization:
```
curl -sS -L -X POST "https://api.astra.datastax.com/v2/pcus/actions/get" \
--header "Authorization: Bearer APPLICATION_TOKEN" \
--header "Content-Type: application/json" \
--data '{}'
```
Replace APPLICATION_TOKEN with an application token that has the Organization Administrator or Billing Administrator role.

A successful response returns an array of objects representing PCU group settings. If there are no groups, the array is empty.

From the response, copy the uuid for the group that you want to park:

[
  {
    "uuid": "PCU_GROUP_ID",
    "orgId": "ORGANIZATION_ID",
    "title": "group name string",
    "cloudProvider": [ "AWS" ],
    "region": "us-east-2",
    "instanceType": "standard",
    "provisionType": "shared",
    "min": 1,
    "max": 1,
    "reserved": 1,
    "description": "group description string",
    "createdAt": "2021-06-01T12:00:00.000Z",
    "updatedAt": "2021-06-01T12:00:00.000Z",
    "createdBy": "user",
    "updatedBy": "user"
  }
]

To park the group, use POST /v2/pcus/park/PCU_GROUP_ID:
```
curl -sS -L -X POST "https://api.astra.datastax.com/v2/pcus/park/PCU_GROUP_ID" \
--header "Authorization: Bearer APPLICATION_TOKEN" \
--header "Content-Type: application/json"
```
Replace the following:
- APPLICATION_TOKEN: An application token with the Organization Administrator or Billing Administrator role.
- PCU_GROUP_ID: The uuid copied from the previous response. This is the unique identifier for the group that you want to park.

A successful response returns a 200 OK status code.

If the request fails, make sure the group is eligible to park, as explained in the Prerequisites. If the group is eligible to park, contact your DataStax account representative to confirm that you have access to the park/unpark feature for PCU groups.

Unpark flexible capacity PCU groups

Astra Portal
DevOps API

In the Astra Portal header, click Settings.
In the Settings navigation menu, click the name of the current organization, and then select the organization where you want to unpark a PCU group.
In the Settings navigation menu, click Billing.
In the Provisioned Capacity Unit groups section, find the PCU group that you want to unpark, click More, and then select Unpark group.

Use POST /v2/pcus/actions/get to get the list of PCU groups in your organization:
```
curl -sS -L -X POST "https://api.astra.datastax.com/v2/pcus/actions/get" \
--header "Authorization: Bearer APPLICATION_TOKEN" \
--header "Content-Type: application/json" \
--data '{}'
```
Replace APPLICATION_TOKEN with an application token that has the Organization Administrator or Billing Administrator role.

A successful response returns an array of objects representing PCU group settings. If there are no groups, the array is empty.

From the response, copy the uuid for the group that you want to unpark:

[
  {
    "uuid": "PCU_GROUP_ID",
    "orgId": "ORGANIZATION_ID",
    "title": "group name string",
    "cloudProvider": [ "AWS" ],
    "region": "us-east-2",
    "instanceType": "standard",
    "provisionType": "shared",
    "min": 1,
    "max": 1,
    "reserved": 1,
    "description": "group description string",
    "createdAt": "2021-06-01T12:00:00.000Z",
    "updatedAt": "2021-06-01T12:00:00.000Z",
    "createdBy": "user",
    "updatedBy": "user"
  }
]

To unpark the group, use POST /v2/pcus/unpark/PCU_GROUP_ID:
```
curl -sS -L -X POST "https://api.astra.datastax.com/v2/pcus/unpark/PCU_GROUP_ID" \
--header "Authorization: Bearer APPLICATION_TOKEN" \
--header "Content-Type: application/json"
```
Replace the following:
- APPLICATION_TOKEN: An application token with the Organization Administrator or Billing Administrator role.
- PCU_GROUP_ID: The uuid copied from the previous response. This is the unique identifier for the group that you want to unpark.

A successful response returns a 200 OK status code.

When you unpark a PCU group, the group’s minimum PCUs are reprovisioned, hourly billing resumes, and the group’s databases are reactivated. The databases are not immediately available; it can take a few minutes to reprovision the PCUs and return the databases to Active status.