Create aggregate

01/18/2023 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.

1. Select the working environment to use

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

2. Create the aggregate

HTTP method	Path
POST	occm/api/vsa/aggregates

curl example

curl --location --request POST '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

JSON input example: 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.

1. Select the working environment to use

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

2. Create the aggregate

HTTP method	Path
POST	occm/api/aws/ha/aggregates

curl example

curl --location --request POST 'https://cloudmanager.cloud.netapp.com/occm/api/aws/ha/aggregates' --header 'Content-Type: application/json' --header 'x-agent-id: <AGENT_ID>' --header 'Authorization: Bearer <ACCESS_TOKEN>' --d @JSONinput

JSON input example: 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