# NodeSpec


[API catalog](/reference/api/) · [Docker Engine overview](/reference/api/engine/version/v1.57/) · [Product manual](https://docs.docker.com/engine/) · [OpenAPI specification](/reference/api/engine/version/v1.57.yaml)

API version: 1.57





Schema constraints and annotations:

```json
{
  "example": {
    "Availability": "active",
    "Labels": {
      "foo": "bar"
    },
    "Name": "node-name",
    "Role": "manager"
  },
  "properties": {
    "Availability": {
      "description": "Availability of the node.",
      "enum": [
        "active",
        "pause",
        "drain"
      ],
      "example": "active",
      "type": "string"
    },
    "Labels": {
      "additionalProperties": {
        "type": "string"
      },
      "description": "User-defined key/value metadata.",
      "type": "object"
    },
    "Name": {
      "description": "Name for the node.",
      "example": "my-node",
      "type": "string"
    },
    "Role": {
      "description": "Role of the node.",
      "enum": [
        "worker",
        "manager"
      ],
      "example": "manager",
      "type": "string"
    }
  },
  "type": "object"
}
```



