Create a Longview client

post https://api.linode.com/{apiVersion}/longview/clients

Creates a Longview Client. This Client will not begin monitoring the status of your server until you configure the Longview Client application on your Linode using the returning install_code and api_key.

linode-cli longview create \
  --label client789


Learn more...

longview:read_write


Learn more...

Responses

Response body

object

api_key

string

Read-only The API key for this Client, used when configuring the Longview Client application on your Linode.

Returns as [REDACTED] if you do not have read-write access to this client.

apps

object

Read-only The apps this Client is monitoring on your Linode. This is configured when you install the Longview Client application, and is present here for information purposes only.

apache

boolean

Read-only If true, the Apache Longview Client module is monitoring Apache on your server.

mysql

boolean

Read-only If true, the MySQL Longview Client modules is monitoring MySQL on your server.

nginx

boolean

Read-only If true, the Nginx Longview Client module is monitoring Nginx on your server.

created

date-time

Read-only When this Longview Client was created.

integer

Read-only This Client's unique ID.

install_code

string

Read-only The install code for this Client, used when configuring the Longview Client application on your Linode.

Returns as [REDACTED] if you do not have read-write access to this client.

label

string

length between 3 and 32

Filterable This Client's unique label. This is for display purposes only.

updated

date-time

Read-only When this Longview Client was last updated.

Language

Credentials


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.linode.com/v4/longview/clients \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'


xxxxxxxxxx
13
 
1
{
2
  "api_key": "BD1B4B54-D752-A76D-5A9BD8A17F39DB61",
3
  "apps": {
4
    "apache": true,
5
    "mysql": true,
6
    "nginx": false
7
  },
8
  "created": "2018-01-01T00:01:01",
9
  "id": 789,
10
  "install_code": "BD1B5605-BF5E-D385-BA07AD518BE7F321",
11
  "label": "client789",
12
  "updated": "2018-01-01T00:01:01"
13
}

200Longview Client created successfully.

defaultSee Errors for the range of possible error response codes.