Create an aggregate

09/29/2025 Contributors

You can create a new aggregate within a system using this workflow. Choose the workflow to use based on the type of Cloud Volumes ONTAP deployment:

Single Node
HA pair

Create an aggregate for a single node

You can use this workflow to create an aggregate for a single node system.

Step 1. Select the system

Perform the workflow Get systems and choose the publicId value for the workingEnvironmentId parameter.

Step 2. Create the aggregate

You can issue the REST API call to create an aggregate.

HTTP method and endpoint

This REST API call uses the following method and endpoint.

HTTP method	Path
POST	occm/api/vsa/aggregates

Curl example

curl --request POST \
--location "https://api.bluexp.netapp.com/occm/api/vsa/aggregates" \
--header "Content-Type: application/json"  \
--header "x-agent-id: <AGENT_ID>" \
--header "Authorization: Bearer <ACCESS_TOKEN>" \
--d @JSONinput

Additional input parameters

The JSON input example includes the minimum list of input parameters. You can choose to create an aggregate with Elastic Volumes enabled.

Enable Elastic Volumes aggregates

{
  "name": "ziv01agg04",
  "workingEnvironmentId": "VsaWorkingEnvironment-9e6p8LuF",
  "initialEvAggregateSize": {
    "size": 0,
    "unit": "GB"
  },
  "numberOfDisks": null,
  "diskSize": {
    "size": 0,
    "unit": "GB"
  },
  "providerVolumeType": "gp2"
}

Required parameter: initialEvAggregateSize This field must be provided to create a new aggregate with Elastic Volumes enabled.
Optional parameters: numberOfDisks This field must be kept empty when creating an aggregate with Elastic Volumes enabled.
diskSize This field must be kept empty when creating an aggregate with Elastic Volumes enabled.

Disable Elastic Volumes aggregates

{
  "name": "ziv01agg04",
  "workingEnvironmentId": "VsaWorkingEnvironment-9e6p8LuF",
  "numberOfDisks": null,
  "diskSize": {
    "size": 0,
    "unit": "GB"
  },
  "providerVolumeType": "gp2"
}

Output

None

Create an aggregate for a high availability pair

You can use this workflow to create an aggregate for an HA system.