Managed

Managed Services List

get
https://api.linode.com/v4/managed/services

Returns a paginated list of Managed Services on your Account. These are the services Linode Managed is monitoring and will report and attempt to resolve issues with.

This command can only be accessed by the unrestricted users of an account.

Request Samples

curl -H "Authorization: Bearer $TOKEN" \
    https://api.linode.com/v4/managed/services

Response Samples

{
  "data": [
    {
      "id": "",
      "created": "2018-01-01T00:01:01",
      "status": "ok",
      "label": "prod-1",
      "body": "it worked",
      "updated": "2018-03-01T00:01:01",
      "region": "",
      "service_type": "url",
      "address": "https://example.org",
      "timeout": 30,
      "consultation_group": "on-call",
      "notes": "The service name is my-cool-application",
      "credentials": []
    }
  ],
  "page": 1,
  "pages": 1,
  "results": 1
}

Responses

200: A paginated list of Managed Services

data
array of objects
id
integer

This Service's unique ID.

created
string

When this Managed Service was created.

status
string
Enum: "disabled""pending""ok""problem"

The current status of this Service.

label
string[a-zA-Z0-9-_ \.]{3,64}

The label for this Service. This is for display purposes only.

body
Nullable
string

What to expect to find in the response body for the Service to be considered up.

updated
string

When this Managed Service was last updated.

region
string

The Region in which this Service is located. This is required if address is a private IP, and may not be set otherwise.

service_type
string
Enum: "url""tcp"

How this Service is monitored.

address
string

The URL at which this Service is monitored.

URL parameters such as ?no-cache=1 are preserved.

URL fragments/anchors such as #monitor are not preserved.

timeout
integer

How long to wait, in seconds, for a response before considering the Service to be down.

consultation_group
string

The group of ManagedContacts who should be notified or consulted with when an Issue is detected.

notes
Nullable
string

Any information relevant to the Service that Linode special forces should know when attempting to resolve Issues.

credentials
array

An array of ManagedCredential IDs that should be used when attempting to resolve issues with this Service.

page
integer

The current page.

pages
integer

The total number of pages.

results
integer

The total number of results.

default: Error

errors
array of objects
reason
string

What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.

field
string

The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.

Managed Service Create

post
https://api.linode.com/v4/managed/services

Creates a Managed Service. Linode Managed will begin monitoring this service and reporting and attempting to resolve any Issues.

This command can only be accessed by the unrestricted users of an account.

Request Body Schema

address
Required
string <url>[3 .. 100] characters

The URL at which this Service is monitored.

URL parameters such as ?no-cache=1 are preserved.

URL fragments/anchors such as #monitor are not preserved.

label
Required
string [3 .. 64] characters [a-zA-Z0-9-_ \.]{3,64}

The label for this Service. This is for display purposes only.

service_type
Required
string

How this Service is monitored.

timeout
Required
integer

How long to wait, in seconds, for a response before considering the Service to be down.

body
string <= 100 characters

What to expect to find in the response body for the Service to be considered up.

consultation_group
string <= 50 characters

The group of ManagedContacts who should be notified or consulted with when an Issue is detected.

credentials
array

An array of ManagedCredential IDs that should be used when attempting to resolve issues with this Service.

notes
string

Any information relevant to the Service that Linode special forces should know when attempting to resolve Issues.

region
string

The Region in which this Service is located. This is required if address is a private IP, and may not be set otherwise.

Request Samples

curl -H "Content-Type: application/json" \
    -H "Authorization: Bearer $TOKEN" \
    -X POST -d '{
      "service_type": "url",
      "label": "prod-1",
      "address": "https://example.org",
      "timeout": 30,
      "body": "it worked",
      "consultation_group": "on-call",
      "notes": "The service name is my-cool-application",
      "credentials": [
        9991
      ]
    }' \
    https://api.linode.com/v4/managed/services

Response Samples

{
  "status": "ok",
  "created": "2018-01-01T00:01:01",
  "updated": "2018-03-01T00:01:01",
  "id": 1234,
  "label": "prod-1",
  "service_type": "url",
  "region": "",
  "address": "https://example.org",
  "timeout": 30,
  "body": "it worked",
  "consultation_group": "on-call",
  "notes": "The service name is my-cool-application",
  "credentials": []
}

Responses

200: Service created.

status
string
Enum: "disabled""pending""ok""problem"

The current status of this Service.

created
string <date-time>

When this Managed Service was created.

updated
string <date-time>

When this Managed Service was last updated.

id
integer

This Service's unique ID.

label
string [3 .. 64] characters [a-zA-Z0-9-_ \.]{3,64}

The label for this Service. This is for display purposes only.

service_type
string
Enum: "url""tcp"

How this Service is monitored.

region
string

The Region in which this Service is located. This is required if address is a private IP, and may not be set otherwise.

address
string <url>[3 .. 100] characters

The URL at which this Service is monitored.

URL parameters such as ?no-cache=1 are preserved.

URL fragments/anchors such as #monitor are not preserved.

timeout
integer

How long to wait, in seconds, for a response before considering the Service to be down.

body
Nullable
string <= 100 characters

What to expect to find in the response body for the Service to be considered up.

consultation_group
string <= 50 characters

The group of ManagedContacts who should be notified or consulted with when an Issue is detected.

notes
Nullable
string

Any information relevant to the Service that Linode special forces should know when attempting to resolve Issues.

credentials
array of objects

An array of ManagedCredential IDs that should be used when attempting to resolve issues with this Service.

default: Error

errors
array of objects
reason
string

What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.

field
string

The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.