open-nomad/website/source/docs/http/validate.html.md

layout	page_title	sidebar_current	description
http	HTTP API: /v1/validate/	docs-http-validate	The '/1/validate/' endpoints are used to for validation of objects.

/v1/validate/job

The /validate/job endpoint is to validate a Nomad job file. The local Nomad agent forwards the request to a server. In the event a server can't be reached the agent verifies the job file locally but skips validating driver configurations.

POST

Description

Validates a Nomad job file

Method

POST

URL

`/v1/validate/job`

Parameters

None

Body

{
  "Job": {
      "Region": "global",
      "ID": "example",
      "ParentID": null,
      "Name": "example",
      "Type": "service",
      "Priority": 50,
      "AllAtOnce": null,
      "Datacenters": [
          "dc1"
      ],
      "Constraints": null,
      "TaskGroups": [
          {
              "Name": "cache",
              "Count": 1,
              "Constraints": null,
              "Tasks": [
                  {
                      "Name": "mongo",
                      "Driver": "exec",
                      "User": "",
                      "Config": {
                          "args": [
                              "-l",
                              "127.0.0.1",
                              "0"
                          ],
                          "command": "/bin/nc"
                      },
                      "Constraints": null,
                      "Env": null,
                      "Services": null,
                      "Resources": {
                          "CPU": 1,
                          "MemoryMB": 10,
                          "DiskMB": null,
                          "IOPS": 0,
                          "Networks": [
                              {
                                  "Public": false,
                                  "CIDR": "",
                                  "ReservedPorts": null,
                                  "DynamicPorts": [
                                      {
                                          "Label": "db111",
                                          "Value": 0
                                      },
                                      {
                                          "Label": "http111",
                                          "Value": 0
                                      }
                                  ],
                                  "IP": "",
                                  "MBits": 10
                              }
                          ]
                      },
                      "Meta": null,
                      "KillTimeout": null,
                      "LogConfig": {
                          "MaxFiles": 10,
                          "MaxFileSizeMB": 10
                      },
                      "Artifacts": null,
                      "Vault": null,
                      "Templates": null,
                      "DispatchPayload": null
                  },
                  {
                      "Name": "redis",
                      "Driver": "raw_exec",
                      "User": "",
                      "Config": {
                          "args": [
                              "-l",
                              "127.0.0.1",
                              "0"
                          ],
                          "command": "/usr/bin/nc"
                      },
                      "Constraints": null,
                      "Env": null,
                      "Services": null,
                      "Resources": {
                          "CPU": 1,
                          "MemoryMB": 10,
                          "DiskMB": null,
                          "IOPS": 0,
                          "Networks": [
                              {
                                  "Public": false,
                                  "CIDR": "",
                                  "ReservedPorts": null,
                                  "DynamicPorts": [
                                      {
                                          "Label": "db",
                                          "Value": 0
                                      },
                                      {
                                          "Label": "http",
                                          "Value": 0
                                      }
                                  ],
                                  "IP": "",
                                  "MBits": 10
                              }
                          ]
                      },
                      "Meta": null,
                      "KillTimeout": null,
                      "LogConfig": {
                          "MaxFiles": 10,
                          "MaxFileSizeMB": 10
                      },
                      "Artifacts": null,
                      "Vault": null,
                      "Templates": null,
                      "DispatchPayload": null
                  }
              ],
              "RestartPolicy": {
                  "Interval": 300000000000,
                  "Attempts": 10,
                  "Delay": 25000000000,
                  "Mode": "delay"
              },
              "EphemeralDisk": {
                  "Sticky": null,
                  "Migrate": null,
                  "SizeMB": 300
              },
              "Meta": null
          }
      ],
      "Update": {
          "Stagger": 10000000000,
          "MaxParallel": 0
      },
      "Periodic": null,
      "ParameterizedJob": null,
      "Payload": null,
      "Meta": null,
      "VaultToken": null,
      "Status": null,
      "StatusDescription": null,
      "CreateIndex": null,
      "ModifyIndex": null,
      "JobModifyIndex": null
  }
}

Returns

```javascript

{ "DriverConfigValidated": true, "ValidationErrors": [ "Task group cache validation failed: 1 error(s) occurred:\n\n* Task redis validation failed: 1 error(s) occurred:\n\n* 1 error(s) occurred:\n\n* minimum CPU value is 20; got 1" ], "Error": "1 error(s) occurred:\n\n* Task group cache validation failed: 1 error(s) occurred:\n\n* Task redis validation failed: 1 error(s) occurred:\n\n* 1 error(s) occurred:\n\n* minimum CPU value is 20; got 1" } ```