Managed

Managed Service Enable

post
https://api.linode.com/v4/managed/services/{serviceId}/enable

Enables monitoring of a Managed Service.

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

Path Parameters

serviceId
Required
integer

The ID of the Managed Service to enable.

Request Samples

curl -H "Content-Type: application/json" \
    -H "Authorization: Bearer $TOKEN" \
    -X POST \
    https://api.linode.com/v4/managed/services/9994/enable

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 enabled.

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.