Create an aggregate

07/03/2024 Contributors

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

Single Node
HA pair

Create aggregate for single node

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

Step 1. Select the working environment to use

Perform the workflow Get working environments 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://cloudmanager.cloud.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 aggregate for high availability pair

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