compute
PUT /v1/compute/servers/{serverId}/reverse-dns
Point one address's PTR at a hostname, or reset it.
प्रमाणीकरण
एपिआई कुञ्जीलाई बियरर टोकन (bearer token) को रूपमा पठाउनुहोस्। कुञ्जीसँग sites.restart अनुमति हुनुपर्छ; अनुमति नभएको कुञ्जीलाई 404 होइन, 403 मार्फत अस्वीकार गरिन्छ।
यो इन्डपोइन्टले कुनै संस्थाको आइडी लिँदैन। तपाईंको कुञ्जीले यस अन्तर्गत पर्ने संस्थालाई पहिल्यै पहिचान गर्छ, र प्रतिक्रिया त्यसैमा सीमित हुन्छ।
प्रयास गर्नुहोस्
कोणीय कोष्ठकभित्र भएका जुनसुकै कुरालाई आफ्नो मानहरूद्वारा बदल्नुहोस्, र मुख्य स्थानहोल्डरलाई तपाईंको ड्यासबोर्डको कुञ्जीद्वारा बदल्नुहोस्।
curl -X PUT https://api.zinndigital.com/v1/compute/servers/{serverId}/reverse-dns \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "ip": <string> }'लगइन गर्नुभएको छ? तपाईंको ड्यासबोर्डमा रहेको API कन्सोलले तपाईंको वास्तविक संस्थाको आईडी र आफ्नै कुञ्जी भरिदिन्छ, र लाइभ API विरुद्ध अनुरोध चलाउँछ ताकि तपाईंले वास्तविक प्रतिक्रिया हेर्न सक्नुहोस्। यो एन्डपोइन्टलाई API कन्सोलमा खोल्नुहोस्
विवरणहरू
⛔ ip is required and is never inferred from the machine: a machine has an IPv4 and an IPv6 address with different default states, so "set the PTR of this server" is not a well-formed request. An empty hostname resets that address to the provider's own default, which is a real thing to want and is not the same as leaving it alone. ⛔⛔ The hostname must resolve forward to this address, and that is checked before anything is written. Receiving mail servers check forward-confirmed reverse DNS, so a PTR whose name does not point back is worse than the supplier's default: it looks configured on the screen and still fails delivery. A name that does not resolve at all is refused too — "we could not look it up" is not evidence the record exists. An ip the machine does not hold is 422, and that refusal is the tenancy boundary: the provider would happily set a PTR for any address on the account, including another customer's. Requires sites.restart.
प्यारामिटरहरू
| नाम | प्रकार | आवश्यक | यो के हो |
|---|---|---|---|
serverId (path) | Uuid | हुन्छ | The server's id, as listComputeServers reports it. Ours (UUIDv7), minted when the order row was written — never the provider's own identifier for the machine. |
अनुरोध बडी
| नाम | प्रकार | आवश्यक | यो के हो |
|---|---|---|---|
ip | string | हुन्छ | Which address to set. ⛔ Required and never inferred: a machine has an IPv4 and an IPv6 with different default states, so "set the PTR of this server" is not a well-formed request.… |
hostname | string | हैन | The name to point at. Empty resets the address to the provider's own default, which is a real thing to want and is not the same as leaving it alone. ⛔ A non-empty name must… |
प्रतिक्रिया
| नाम | प्रकार | आवश्यक | यो के हो |
|---|---|---|---|
data | ComputeReverseDnsRecord[] | हुन्छ | — |
यो इन्डपोइन्टले फर्काउन सक्ने त्रुटिहरू
401 · 403 · 404 · 422 · 429 · 503