Edit PCU groups in Astra DB

After you create a PCU group, you can change the PCU group’s name, description, scoped databases, and allocated capacity.

Prerequisites

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

To edit PCU groups, you must have the Organization Administrator role, Billing Administrator role, or a similar custom role.

Unpark PCU groups 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.

Be aware of immutable settings

You cannot edit the following settings after you create a PCU group:

Cloud provider
Region
Provision type
Cache optimization
Workload type
Reserved capacity, depending on the workload type:
- For committed capacity PCU groups, you cannot decrease the reserved capacity after creating the group. You can increase the reserved capacity at any time, but you cannot decrease the reserved capacity until subscription renewal.
- For flexible capacity PCU groups, you cannot change the reserved capacity. If you want to change a flexible capacity PCU group to a committed capacity PCU group, you must create a new committed capacity PCU group, move your databases to that group, and then delete the flexible capacity PCU group.

The cloud provider, region, provision type, and cache optimization settings apply to all of the group’s allocated capacity (reserved, minimum, and maximum). For example, if you enable cache optimization, then the group’s reserved, minimum, and maximum capacity is all cache optimized.

If you want to change an immutable setting, you must create a new PCU group with the desired settings, and then move your databases to that group.

You can delete flexible capacity PCU groups at any time, but you cannot delete committed capacity PCU groups until the subscription renewal period.

Before you create or edit a PCU group, DataStax recommends that you learn about PCU group options and plan your PCU groups.

Billing and performance implications of PCU group changes

Editing a PCU group can have billing and performance implications, such as the following:

Decreasing the minimum or maximum capacity reduces the total capacity available to the group’s databases. If the group doesn’t have sufficient capacity to support its databases, then database performance suffers.
If you increase the reserved capacity for a committed capacity PCU group, then you permanently increase your RCU commitment for the remainder of the subscription period. RCU increases are irreversible until subscription renewal.
If you increase the minimum capacity for any PCU group, you increase the amount of PCUs that are billed for continuous usage. Whether these are billed at the RCU or HCU rate depends on the group’s configuration. For more information, see Provisioned Capacity Units for Astra DB Serverless
If you add databases to a PCU group, and the group doesn’t have enough capacity to support additional databases, then all databases in the group can experience performance issues like increase latency.

In contrast, if you add databases to a PCU group where the maximum capacity is greater than the minimum capacity, Astra DB can provision additional PCUs up to the maximum, if required to meet the increased demand. These additional PCUs are billed at the HCU rate.
Removing all databases from a PCU group doesn’t eliminate billed charges for that group. PCU groups incur billed charges even if a group has no databases or the databases don’t use all of the minimum capacity.
If you remove a database from a PCU group without moving it to another PCU group, the database returns to standard, on-demand capacity. Databases that aren’t in a PCU group are billed for database usage according to your Enterprise plan’s standard, on-demand usage rates, including reads (RRUs) and writes (WRUs).

For more information, see Provisioned Capacity Units for Astra DB Serverless and Plan your PCU groups in Astra DB.

Edit a committed capacity PCU group

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 edit 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 modify, click More, and then select Edit group.
In the Edit PCU group dialog, you can do the following:
- Change the group’s name and description.
- Add or remove databases from the group.
- Increase the reserved capacity.
  
  You cannot decrease the reserved capacity. Reserved capacity increases are permanent for the remainder of the subscription period.
- Increase or decrease the minimum capacity, as long as it is not less than the reserved capacity.
- Increase or decrease the maximum capacity, as long as it is not less than the minimum.
To acknowledge and approve any modifications to your PCU service agreement that result from the changes you made, select Authorization.
Click Edit PCU group to save your changes.

The DevOps API has separate operations to update a group’s details and the databases in the 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 object that contains the settings for the group that you want to edit. If you want to change the group’s databases, you only need the group’s uuid.

[
  {
    "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"
  }
]

Use the necessary DevOps API endpoint to modify the PCU group:
- Edit name, description, and capacity
- Add a database
- Remove a database
To update the group’s settings, use PUT /v2/pcus:
curl -sS -L -X PUT "https://api.astra.datastax.com/v2/pcus" \ --header "Authorization: Bearer APPLICATION_TOKEN" \ --header "Content-Type: application/json" \ --data '{ "pcuGroupUUID": "PCU_GROUP_ID", "title": "PCU_GROUP_NAME", "description": "PCU_GROUP_DESCRIPTION", "reserved": RESERVED, "min": MINIMUM, "max": MAXIMUM }'
Replace the following, as needed. For any values you don’t want to change, use the values copied from the previous response.
APPLICATION_TOKEN: Provide an application token with the Organization Administrator or Billing Administrator role.

PCU_GROUP_ID: Provide the PCU group uuid that you copied from the previous response.

PCU_GROUP_NAME and PCU_GROUP_DESCRIPTION: Enter a new name and description for the PCU group, or use the values copied from the previous response.

RESERVED: To keep the existing reserved capacity, use the value copied from the previous response. Otherwise, you can increase the reserved capacity, but you cannot decrease the reserved capacity. Reserved capacity increases are permanent for the remainder of the subscription period.

MINIMUM: To keep the existing minimum capacity, use the value copied from the previous response. Otherwise, you can increase or decrease the minimum capacity, as long as it is not less than the reserved capacity.

MAXIMUM: To keep the existing maximum capacity, use the value copied from the previous response. Otherwise, you can increase or decrease the maximum capacity, as long as it is not less than the minimum.
To add a database to a group, use POST /v2/pcus/association/PCU_GROUP_ID/DATACENTER_ID:
curl -sS -L -X POST "https://api.astra.datastax.com/v2/pcus/association/PCU_GROUP_ID/DATACENTER_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 PCU group’s uuid.

DATACENTER_ID: The database’s datacenter ID to add to the group. This must correspond with the PCU group’s cloud provider and region.
To remove a database from a group use DELETE /v2/pcus/association/PCU_GROUP_ID/DATACENTER_ID:
curl -sS -L -X DELETE "https://api.astra.datastax.com/v2/pcus/association/PCU_GROUP_ID/DATACENTER_ID" \ --header "Authorization: Bearer APPLICATION_TOKEN" \ --header "Content-Type: application/json"
Replace the following:
APPLICATION_TOKEN: Provide an application token with the Organization Administrator or Billing Administrator role.

PCU_GROUP_ID: Provide the PCU group uuid that you copied from the previous response.

DATACENTER_ID: The datacenter ID of the database that you want to remove from the group.
To confirm the changes, use GET /v2/pcus/association/PCU_GROUP_ID:
```
curl -sS -L -X GET "https://api.astra.datastax.com/v2/pcus/association/PCU_GROUP_ID" \
--header "Authorization: Bearer APPLICATION_TOKEN" \
--header "Content-Type: application/json"
```
Response

A successful response includes an array of objects representing the datacenters associated with the given PCU group. This request does not return usage details.

Edit a flexible capacity PCU group

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

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 edit 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 modify, click More, and then select Edit group.
In the Edit PCU group dialog, you can do the following:
- Change the group’s name and description.
- Add or remove databases from the group.
- Increase or decrease the minimum and maximum capacity, as long as the minimum is greater than zero and the maximum is not less than the minimum.
  
  You cannot change the reserved capacity for a flexible capacity PCU group. For more information, see Be aware of immutable settings.
To acknowledge and approve any modifications to your PCU service agreement that result from the changes you made, select Authorization.
Click Edit PCU group to save your changes.

The DevOps API has separate operations to update a group’s details and the databases in the 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 object that contains the settings for the group that you want to edit. If you want to change the group’s databases, you only need the uuid.

[
  {
    "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"
  }
]

Use the necessary DevOps API endpoint to modify the PCU group:
- Edit name, description, and capacity
- Add a database
- Remove a database
To update the group’s settings, use PUT /v2/pcus:
curl -sS -L -X PUT "https://api.astra.datastax.com/v2/pcus" \ --header "Authorization: Bearer APPLICATION_TOKEN" \ --header "Content-Type: application/json" \ --data '{ "pcuGroupUUID": "PCU_GROUP_ID", "title": "PCU_GROUP_NAME", "description": "PCU_GROUP_DESCRIPTION", "reserved": 0, "min": MINIMUM, "max": MAXIMUM }'
Replace the following, as needed. For any values you don’t want to change, use the values copied from the previous response.
APPLICATION_TOKEN: Provide an application token with the Organization Administrator or Billing Administrator role.

PCU_GROUP_ID: Provide the PCU group uuid that you copied from the previous response.

PCU_GROUP_NAME and PCU_GROUP_DESCRIPTION: Enter a new name and description for the PCU group, or use the values copied from the previous response.

MINIMUM and MAXIMUM: To keep the existing capacity, use the values copied from the previous response. Otherwise, you can increase or decrease the minimum and maximum capacity, as long as the minimum is greater than zero and the maximum is not less than the minimum.

You cannot change the reserved capacity for a flexible capacity PCU group. For more information, see Be aware of immutable settings.
To add a database to a group, use POST /v2/pcus/association/PCU_GROUP_ID/DATACENTER_ID:
curl -sS -L -X POST "https://api.astra.datastax.com/v2/pcus/association/PCU_GROUP_ID/DATACENTER_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 PCU group’s uuid.

DATACENTER_ID: The database’s datacenter ID to add to the group. This must correspond with the PCU group’s cloud provider and region.
To remove a database from a group use DELETE /v2/pcus/association/PCU_GROUP_ID/DATACENTER_ID:
curl -sS -L -X DELETE "https://api.astra.datastax.com/v2/pcus/association/PCU_GROUP_ID/DATACENTER_ID" \ --header "Authorization: Bearer APPLICATION_TOKEN" \ --header "Content-Type: application/json"
Replace the following:
APPLICATION_TOKEN: Provide an application token with the Organization Administrator or Billing Administrator role.

PCU_GROUP_ID: Provide the PCU group uuid that you copied from the previous response.

DATACENTER_ID: The datacenter ID of the database to remove from the group.
To confirm the changes, use GET /v2/pcus/association/PCU_GROUP_ID:
```
curl -sS -L -X GET "https://api.astra.datastax.com/v2/pcus/association/PCU_GROUP_ID" \
--header "Authorization: Bearer APPLICATION_TOKEN" \
--header "Content-Type: application/json"
```
Response

A successful response includes an array of objects representing the datacenters associated with the given PCU group. This request does not return usage details.