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

Résumé: 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. ...

Cet article concerne Cet article ne concerne pas Cet article n’est associé à aucun produit spécifique. Toutes les versions du produit ne sont pas identifiées dans cet article.
Consulter d’autres ressources

Symptômes

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.

Résolution

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.

Informations supplémentaires

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

Produits concernés

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
Propriétés de l’article
Numéro d’article: 000219143
Type d’article: Solution
Dernière modification: 19 Jun 2025
Version:  3
Trouvez des réponses à vos questions auprès d’autres utilisateurs Dell
Services de support
Vérifiez si votre appareil est couvert par les services de support.