hosting

POST `/v1/sites/{siteId}/quota/resources/{resource}/downgrade`

Reduce a site's allowance — refused while the site is over the target.

Նույնականացում

Ուղարկեք API բանալին որպես bearer token: Բանալին պետք է ունենա sites.view թույլտվությունը. առանց դրա բանալին մերժվում է 403, և ոչ թե 404 կարգավիճակով:

Այս վերջնակետը կազմակերպության ID չի ընդունում: Ձեր բանալին արդեն իսկ նույնականացնում է այն կազմակերպությունը, որին պատկանում է, և պատասխանը սահմանափակված է դրանով:

Փորձել

Փոխարինեք անկյունային փակագծերում գտնվող ցանկացած բան ձեր սեփական արժեքներով, և բանալու տեղապահը՝ ձեր վահանակի բանալիով:

curl -X POST https://api.zinndigital.com/v1/sites/{siteId}/quota/resources/{resource}/downgrade \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "target": <number> }'

Մուտք գործե՞լ եք: Ձեր վահանակի API վահանակը լրացնում է ձեր իրական կազմակերպության ID-ն և ձեր սեփական բանալին և գործարկում է հարցումը ուղիղ API-ի դեմ, որպեսզի կարողանաք տեսնել փաստացի պատասխանը: Բացեք այս վերջնակետը API վահանակում

Մանրամասներ

Owner ruling: downgrades are allowed **only when the site is not over the limit**. The check is made against a **live** reading of the box, not a stored sample: a downgrade is an irreversible narrowing the customer meets at their next write, so an hour-old figure could license one that is already breached. ⛔ An **unreadable** usage is a refusal, not a pass. If the box cannot be measured the request answers `422`; "we could not tell, so we allowed it" is how a customer ends up above a ceiling they did not choose. The `422` body names the real numbers — *"This site is using 1.90 GB of disk, which is more than the 1.00 GB you asked for"* — because a customer told only "you cannot reduce this" files a ticket, and one told the figures deletes something. Purchased grants for the resource are revoked so the ceiling **is** the number asked for; staff gestures are deliberately left alone. Requires `sites.view` and `hosting.quota.manage`.

Պարամետրեր

Անուն	Տեսակ	Պահանջվում է	Ինչ է դա
`siteId (path)`	`Uuid`	Այո	Site ID (UUIDv7).
`resource (path)`	`string<disk, inodes>`	Այո	Which metered per-site resource. Only resources the platform actually enforces are addressable — `bandwidth` is modelled and priceable in admin but nothing measures or enforces…

Հարցման մարմին

Անուն	Տեսակ	Պահանջվում է	Ինչ է դա
`target`	`number`	Այո	The new ceiling, in the resource's sold unit. Refused with `422` when the site is currently using more than this, or when its usage cannot be read.

Պատասխան

Անուն	Տեսակ	Պահանջվում է	Ինչ է դա
`resource`	`string<disk, inodes, bandwidth>`	Այո	—
`unit`	`SiteQuotaUnit`	Այո	The unit a quota's figures are expressed in, as a code the client localises — never a word to render raw. `GB` for disk and bandwidth, `files` for inodes. ⛔ This was an unco…
`step`	`integer`	Այո	One purchasable step, in `unit`. A customer buys N of these, never an arbitrary size.
`base`	`number`	Այո	The site's own allowance, copied from the product line's admin-set default when the site was provisioned. `null` means this site has no limit row yet — it has not been through p…
`granted`	`number`	Այո	Extra from grants live right now — staff gestures and purchased upgrades, added together.
`total`	`number`	Այո	The effective ceiling — `base + granted`. `null` when `base` is null.
`used`	`number`	Այո	Measured usage. `null` means unknown — the box was unreachable, or nothing has sampled it yet — and never `0`. A client must render those differently.
`percent`	`integer`	Այո	Usage as a whole percentage of `total`, or `null` when either is unknown.
`measured_at`	`string`	Այո	When the box was last asked. Render the age. A bar drawn from a two-day-old reading looks identical to one drawn a minute ago, and the customer cannot tell.
`reverts_at`	`string`	Այո	When the ceiling next drops, because a temporary grant expires. `null` when no live grant has an expiry. A customer whose limit is about to fall needs to know before it does.
`warn_at_percent`	`integer[]`	Այո	The thresholds at which the platform notifies the customer, ascending.
`price_minor`	`integer`	Այո	Cost of ONE step, in integer minor units of `price_currency`, NET of tax. `null` means no price is published in the caller's currency — the client must then show no upgrade cont…
`price_currency`	`string`	Այո	—
`price_interval`	`string<monthly, yearly>`	Այո	—

Այս վերջնակետի կողմից վերադարձվող սխալները

401 · 403 · 404 · 422 · 429

POST /v1/sites/{siteId}/quota/resources/{resource}/downgrade