compute
DELETE /v1/compute/servers/{serverId}/add-on
Cancel this machine's add-on and release its licence.
प्रमाणीकरण
एपिआई कुञ्जीलाई बियरर टोकन (bearer token) को रूपमा पठाउनुहोस्। कुञ्जीसँग sites.view अनुमति हुनुपर्छ; अनुमति नभएको कुञ्जीलाई 404 होइन, 403 मार्फत अस्वीकार गरिन्छ।
यो इन्डपोइन्टले कुनै संस्थाको आइडी लिँदैन। तपाईंको कुञ्जीले यस अन्तर्गत पर्ने संस्थालाई पहिल्यै पहिचान गर्छ, र प्रतिक्रिया त्यसैमा सीमित हुन्छ।
प्रयास गर्नुहोस्
कोणीय कोष्ठकभित्र भएका जुनसुकै कुरालाई आफ्नो मानहरूद्वारा बदल्नुहोस्, र मुख्य स्थानहोल्डरलाई तपाईंको ड्यासबोर्डको कुञ्जीद्वारा बदल्नुहोस्।
curl -X DELETE https://api.zinndigital.com/v1/compute/servers/{serverId}/add-on \
-H "Authorization: Bearer zdk_live_…"लगइन गर्नुभएको छ? तपाईंको ड्यासबोर्डमा रहेको API कन्सोलले तपाईंको वास्तविक संस्थाको आईडी र आफ्नै कुञ्जी भरिदिन्छ, र लाइभ API विरुद्ध अनुरोध चलाउँछ ताकि तपाईंले वास्तविक प्रतिक्रिया हेर्न सक्नुहोस्। यो एन्डपोइन्टलाई API कन्सोलमा खोल्नुहोस्
विवरणहरू
Stops the charge and gives the licence back to the vendor. Requires `sites.view` and `billing.payment.manage`, the same pair as buying one. ⛔ Not `sites.delete`: cancelling destroys no customer data, it stops a cost — and putting it behind the wipe key would stop a customer turning off something they are paying for. ⛔⛔ And not `billing.entitlement.manage`, which is what it was until 2026-08-17: no customer role holds that key, so the customer paying $29 a month for the managed service was the one person who could not stop paying it. The machine's recurring price falls by the add-on's amount **from the next period**. The period already paid for is honoured rather than clawed back. ⛔ **The vendor is released before our row is marked**, deliberately. If the vendor call fails we keep an active row and go on paying, which is visible and swept for; the other order loses the licence from our side while the vendor keeps billing it — an orphan no sweep can find, because the row naming the address is gone. ⭐ For a pooled licence (LiteSpeed) the seat goes to `releasing`, not `free`: the serial is IP-bound and the release is manual in the vendor's own portal, so returning it to stock would hand the next customer a serial still locked to somebody else.
प्यारामिटरहरू
| नाम | प्रकार | आवश्यक | यो के हो |
|---|---|---|---|
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. |
प्रतिक्रिया
| नाम | प्रकार | आवश्यक | यो के हो |
|---|---|---|---|
data | ComputeAddOnAssignment | हुन्छ | One machine's add-on — what was bought, what it costs, and where it has got to. ⛔ **Never carries the licence key or the vendor's reference.** Key material belongs in Vault; a s… |
यो इन्डपोइन्टले फर्काउन सक्ने त्रुटिहरू
401 · 403 · 404 · 422 · 429