hosting

POST `/v1/sites/{siteId}/clones/{cloneId}/retry`

Finish a copy that failed, onto the same new site.

احراز هویت

یک کلید API را به عنوان یک توکن حامل ارسال کنید. این کلید باید دارای مجوز hosting.backup.manage باشد؛ کلیدی که فاقد آن باشد با خطای 403 رد می‌شود، نه 404.

این نقطه پایانی هیچ شناسه سازمانی را دریافت نمی‌کند. کلید شما در حال حاضر سازمان مربوطه را مشخص می‌کند و پاسخ در همان محدوده ارائه می‌شود.

امتحان کنید

هر چیزی را که داخل براکت‌های زاویه‌دار قرار دارد با مقادیر خودتان جایگزین کنید، و نگهدارنده کلید را با کلیدی از داشبورد خود جایگزین نمایید.

curl -X POST https://api.zinndigital.com/v1/sites/{siteId}/clones/{cloneId}/retry \
  -H "Authorization: Bearer zdk_live_…"

وارد شده‌اید؟ کنسول API در داشبورد شما شناسه سازمان واقعی و کلید خودتان را پر می‌کند و درخواست را روی API زنده اجرا می‌کند تا بتوانید پاسخ واقعی را ببینید. این نقطه پایانی را در کنسول API باز کنید

جزئیات

Recovery goes to the step that failed: when the copy of this site was never made a new one is taken, and when it was it is reused. Either way it is restored onto the SAME new site, so a half-built site never has to be deleted to try again. 409 when the copy has not failed; 422 when its new site has been deleted. Requires hosting.backup.manage, because it overwrites the new site's content.

پارامترها

نام	نوع	الزامی	چیست
`siteId (path)`	`Uuid`	بله	Site ID (UUIDv7).
`cloneId (path)`	`Uuid`	بله	The `id` of a row from `listSiteClones`.

پاسخ

نام	نوع	الزامی	چیست
`id`	`Uuid`	بله	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`blueprint_id`	`Uuid`	بله	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`site_id`	`Uuid`	بله	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`site_name`	`string`	بله	—
`site_domain`	`string`	بله	—
`site_status`	`string`	بله	The new site's status, or `deleted` when it no longer exists.
`step`	`SiteCloneStep`	بله	`copying` — the copy of the original is being taken; `waiting` — the new site is still being built; `restoring` — the copy is being put onto it; `done`; `failed`.
`message`	`string`	بله	Why it failed, or what still needs attention. English; shown verbatim.
`can_retry`	`boolean`	بله	Whether `retrySiteClone` will accept this row.
`created_at`	`string`	بله	—
`finished_at`	`object`	خیر	—

خطاهایی که این نقطه پایانی می‌تواند برگرداند

401 · 403 · 404 · 409 · 422 · 429 · 503

POST /v1/sites/{siteId}/clones/{cloneId}/retry