API
Get an API keyTry it

Set reverse DNS of a virtual server

The PTR names of a vServer's IPv4 and/or IPv6 address.

WWriteIdempotentbetaNeeds service_vserver
Tool
manitu_vserver_ptr_seton https://mcp.manitu.de/mcp
POST
/v1/vserver/ptr/seton https://api.manitu.de
Try it
Changes the account. Agents say what will happen and wait for an explicit yes before calling it.

Annotations as tools/list sends them

readOnlyHint falsedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Sets the reverse DNS (PTR) name of a virtual server's IPv4 and/or IPv6 address, by its vserver_id from manitu_vserver_list. For mail sent from the server, the name should resolve back to the same address (A/AAAA record) - say so if it does not. Runs in the background (see pending_workflow_list of manitu_vserver_get); the new names appear there once done. A name that is no hostname, or a record for an address the server lacks, is refused per field. Refused with a conflict while another PTR change runs or while the server cannot be changed.

Provide at least one of: ptr_record_ipv4, ptr_record_ipv6.

Arguments

vserver_idinteger | stringrequired

The vserver_id from manitu_vserver_list - never guess one.

pattern ^[1-9][0-9]*$min 1
ptr_record_ipv4string

The name its IPv4 address resolves back to, e.g. "mail.example.com". Left out: unchanged.

min length 1max length 253
ptr_record_ipv6string

The name its IPv6 address resolves back to. Left out: unchanged.

min length 1max length 253
The tool list carries this simplified form: a rule at the root of a schema does not reach every client, so it is said in the description instead.

Result structuredContent, checked against the schema

workflowstringrequired

What is being done, e.g. a reboot.

One of create destroy power_start power_stop power_reboot reinstall ptr_set vnc_enable vnc_disable rescuesystem_enable rescuesystem_disable snapshot_create snapshot_delete snapshot_delete_all snapshot_revert telemetry_await iso_eject
workflow_idstringrequired

The id of this run of the workflow.

created_atstring | nullrequired

When it was asked for.

Format date-time
started_atstring | nullrequired

When it started; null while it waits for the next run - usually a minute or two, at times longer. Nothing to tell the customer unless asked.

Format date-time
workflow_tokenstring | nullrequired

Pass it to manitu_workflow_get to see how far the workflow is - as it is, never built or changed. A secret of this workflow: do not show it to anyone. null if there is none.

taskobjectrequired

The task the customer panel polls for its progress.

task.idintegerrequired
task.authstringrequired

Authentication

One of X-API-Key, Authorization: Bearer … - never more than one in a request. More

Request body JSON; unknown fields are refused

Provide at least one of: ptr_record_ipv4, ptr_record_ipv6.
vserver_idinteger | stringrequired

The vserver_id from manitu_vserver_list - never guess one.

pattern ^[1-9][0-9]*$min 1
ptr_record_ipv4string

The name its IPv4 address resolves back to, e.g. "mail.example.com". Left out: unchanged.

min length 1max length 253
ptr_record_ipv6string

The name its IPv6 address resolves back to. Left out: unchanged.

min length 1max length 253

Response in data; the rest of the body as on every call

workflowstringrequired

What is being done, e.g. a reboot.

One of create destroy power_start power_stop power_reboot reinstall ptr_set vnc_enable vnc_disable rescuesystem_enable rescuesystem_disable snapshot_create snapshot_delete snapshot_delete_all snapshot_revert telemetry_await iso_eject
workflow_idstringrequired

The id of this run of the workflow.

created_atstring | nullrequired

When it was asked for.

Format date-time
started_atstring | nullrequired

When it started; null while it waits for the next run - usually a minute or two, at times longer. Nothing to tell the customer unless asked.

Format date-time
workflow_tokenstring | nullrequired

Pass it to manitu_workflow_get to see how far the workflow is - as it is, never built or changed. A secret of this workflow: do not show it to anyone. null if there is none.

taskobjectrequired

The task the customer panel polls for its progress.

task.idintegerrequired
task.authstringrequired

Statuses

200Success.400The request does not match the declared input schema.401No credential was presented, or it was not recognised.403The credential is not permitted to use this operation.500The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.503The channel this operation forwards through is unavailable.