hosting

DELETE /v1/sites/{siteId}/cdn/swap

Abandon a CDN move and put the site back.

כל נקודות הקצה מסוג hosting

כל תיעוד המפתחים

אימות

שלחו מפתח API כאסימון נושא (bearer token). על המפתח לכלול את הרשאה hosting.cdn.manage; מפתח שאינו כולל אותה יידחה בסטטוס 403, ולא 404.

נקודת קצה זו אינה דורשת מזהה ארגון. המפתח שלך כבר מזהה את הארגון שאליו הוא שייך, והתגובה מוגבלת אליו בלבד.

נסה זאת

החלף כל דבר בסוגריים זוויתיים בערכים משלך, ואת מציין מיקום המפתח במפתח מלוח הבקרה שלך.

curl -X DELETE https://api.zinndigital.com/v1/sites/{siteId}/cdn/swap \
  -H "Authorization: Bearer zdk_live_…"

מחובר? קונסולת ה-API בלוח הבקרה שלך מזינה את מזהה הארגון האמיתי שלך ואת המפתח שלך, ומריצה את הבקשה מול ה-API הפיזי כך שתוכל לראות את התגובה בפועל. פתח נקודת קצה זו במסוף ה-API

פרטים

Rolls a move back and returns the site to the account it came from. ⭐ Exists because a move can wait on your registrar indefinitely, and that is the correct state rather than a failure — both edges serve the site throughout. Nothing rolls it back on a timer, because doing so would move a site that has been served happily from the destination for days. You say when. ⛔ Refused once the move has completed: the source zone has gone by then, so there is nothing to put the site back onto. ⛔ Also refused once the domain's nameservers have been changed or the new delegation has been seen (cancellable is false): the registry already points at the new zone, and undoing the move would take the site offline. Requires hosting.cdn.manage.

פרמטרים

שםסוגנדרשמה זה
siteId (path)UuidכןSite ID (UUIDv7).

תשובה

שםסוגנדרשמה זה
idstringכן
site_idstringכן
statusstring<pending, creating, repointing, awaiting_delegation, completed, rolled_back, failed>כןawaiting_delegation is the state to render carefully: the move is complete on our side, both edges are serving the site, and it is waiting on your registrar. ⛔…
from_kindstringכן
from_labelstringכן
to_kindstringכן
to_labelstringכן
to_account_idobjectכן
nameserversstring[]כןThe nameservers your domain must be delegated to. ⛔ The field this operation exists to deliver: without it the move never completes, and it does not fail either — it simply…
nameservers_appliedbooleanכןWhether we set them (the domain is registered with us, or with a registrar you have connected) or you must.
delegation_observed_atobjectכןWhen the new delegation was observed answering — never when it was requested. The source zone is not removed until this is set.
old_zone_removedbooleanכןAn observation, not an intention. A source zone we could not delete leaves you being billed by that vendor for a site it no longer serves.
records_copiedintegerכןHow many of your OTHER DNS records were carried to the new zone. ⛔ Moving between two zone-owning CDNs re-delegates the whole domain, so your MX, SPF, DMARC and…
records_source_readbooleanכןWhether your existing records could be read at all. ⛔ Read this with records_copied, never instead of it: 0 is the truthful answer for a domain that has nothing but an…
detailstringכן
created_atstringכן
completed_atobjectכן
in_flightbooleanכןawaiting_delegation counts as in flight. It is the state most likely to be read as finished — the site works, both edges serve it — and starting a second move from there would…
cancellablebooleanכןWhether DELETE can still put the site back. ⛔ Narrower than in_flight: false once the domain's nameservers have been changed or the new delegation has been seen answering,…

שגיאות שנקודה קצה זו עשויה להחזיר

401 · 403 · 404 · 422 · 429