VxRail: 15G Cluster Deployment Using API Fails if the disk_group_type Object is Missing in the API Request Body.

Summary: This article explains the situation when a disk_group_type object is missing from the API request body. Then the 15G cluster deployment fails, but the error message is misleading, it does not tell the real cause. ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Symptoms

When building the cluster with Dell PowerEdge 15G servers using VxRail public API /v1/system/initialize, it is mandatory to input disk_group_type value in the API request body.

If the disk_group_type object is missing, the cluster deployment validation fails with error: 
" {"message": "Failed to create workflow instance: Input JSON is not valid. The invalid field is storage, error message is \"'encryption_enabled' is a required property\", path of error field is [storage].", "code": "20102003"}}]}"
This error message is misleading, it does not tell the real cause that disk_group_type object is missing.

Cause

This is a code issue in the VxRail 8.0.200 release.
It only impacts 15G cluster initial deployment, and will be fixed in future 8.0.x release.

Resolution

1. Call VxRail public API /v1/system/initialize/nodes to get the "disk_group_type" value from auto-discovered nodes.
For example, below information can be found from the API output: 
"disk_group_config": {
    "recommendation": {
        "type": "2804",
        "description": "Up to 4 Disk Groups (up to 6 capacity drives and 1 cache drive per group)"
    },
    "options": [
        {
            "type": "2804",
            "description": "Up to 4 Disk Groups (up to 6 capacity drives and 1 cache drive per group)"
        }
    ]
}

2.  Add the "disk_group_type" value to the VxRail first run API request body under the "storage" section. (Pay attention, it is not under the "hosts-->storage" section.)
For example: 
"storage": {"disk_group_type": "2804"}

3. Call first run API /v1/system/initialize again to build the cluster.

Additional Information

For more information:

Check the Dell Developer site for samples of how to use VxRail public API:
https://developer.dell.com/apis/5538/versions/8.0.100/vxrail_public_api.yaml

Configure and deploy a new VxRail cluster:
https://developer.dell.com/apis/5538/versions/8.0.100/vxrail_public_api.yaml/paths/~1v1~1system~1initialize/post

Query disk_group_type from auto discovered nodes:
https://developer.dell.com/apis/5538/versions/8.0.100/vxrail_public_api.yaml/paths/~1v1~1system~1initialize~1nodes/get

Affected Products

VxRail, VxRail Appliance Series, VxRail E660, VxRail E660F, VxRail E660N, VxRail E665, VxRail E665F, VxRail E665N, VxRail P670F, VxRail P670N, VxRail P675F, VxRail P675N, VxRail S670, VxRail Software, VXRAIL V670F
Article Properties
Article Number: 000219143
Article Type: Solution
Last Modified: 19 Jun 2025
Version:  3
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.