Logo

Command Palette

Search for a command to run...

GET/stacks/:stack_id/servers/:server_id/settings/:id

Required Parameters

stack_idstring
The stack UID
server_idstring
The server uid
idstring
The server setting item ID

Get information about a single server setting.

Related Models:Server Setting

Get information of a single server setting item

Request

GET
/stacks/:stack_id/servers/:server_id/settings/:id
curl -X GET \
  "https://app.cloud66.com/api/3/stacks/:stack_id/servers/:server_id/settings/:id" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

Response

{
  "response": {
    "key": "server.name",
    "value": "Caribou"
  }
}
GET/stacks/:stack_id/servers/:server_id/settings

Required Parameters

stack_idstring
The stack UID
server_idstring
The server UID

Get list of all settings of a server.

Request

GET
/stacks/:stack_id/servers/:server_id/settings
curl -X GET \
  "https://app.cloud66.com/api/3/stacks/:stack_id/servers/:server_id/settings" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

Response

{
  "response": [
    {
      "key": "server.name",
      "value": "Caribou",
      "readonly": true,
      "warning_text": "Warning! Changing this value will also modify your Cloud 66 *.c66.me DNS values"
    }
  ],
  "count": 1,
  "pagination": {
    "previous": null,
    "next": null,
    "current": 1,
    "per_page": 30,
    "count": 1,
    "pages": 1
  }
}
GET/stacks/:stack_id/servers/:server_id/settings

Required Parameters

stack_idstring
The stack UID
server_idstring
The server UID

Get list of all server settings for a server.

Get list of all settings for a server.

Request

GET
/stacks/:stack_id/servers/:server_id/settings
curl -X GET \
  "https://app.cloud66.com/api/3/stacks/:stack_id/servers/:server_id/settings" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

Response

{
  "response": [
    {
      "id": 1,
      "key": "server.timezone",
      "value": "UTC",
      "readonly": false,
      "created_at": "2014-08-29T17:21:25Z",
      "updated_at": "2014-08-29T17:21:25Z"
    }
  ],
  "count": 1,
  "pagination": {
    "previous": null,
    "next": null,
    "current": 1,
    "per_page": 30,
    "count": 1,
    "pages": 1
  }
}
PUT/stacks/:stack_id/servers/:server_id/settings/:id

Required Parameters

stack_idstring
The stack UID
server_idstring
The server UID
idstring
The server setting item ID
valuestring
The server setting item new value

Update value of a server setting item.

Related Models:Server Setting

Request

PUT
/stacks/:stack_id/servers/:server_id/settings/:id
curl -X PUT \
  "https://app.cloud66.com/api/3/stacks/:stack_id/servers/:server_id/settings/:id" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "stack_id": "5999b763474b0eafa5fafb64bff0ba80",
  "server_id": "f8468fc145ea49bac474b30a8fea888d",
  "id": "server-name",
  "value": "newname"
}'

Response

{
  "response": {
    "id": 9,
    "user": "test@cloud66.com",
    "resource_type": "server",
    "action": "server-set: server.name",
    "resource_id": "445",
    "started_via": "api",
    "started_at": "2014-09-01T13:07:35Z",
    "finished_at": null,
    "finished_success": null,
    "finished_message": null
  }
}