compute

POST /v1/compute/servers/{serverId}/resize/quote

Get what resizing a server would cost, before the charge.

모든 compute 엔드포인트

모든 개발자 문서

인증

Bearer 토큰으로 API 키를 전송하세요. 키는 반드시 sites.view 권한을 가지고 있어야 하며, 권한이 없는 키는 404가 아닌 403으로 거부됩니다.

이 엔드포인트는 조직 ID를 받지 않습니다. 사용자의 키가 이미 속한 조직을 식별하며, 응답은 해당 조직으로 한정됩니다.

무료 체험하기

대괄호 안에 있는 모든 내용을 사용자 지정 값으로 바꾸고, 키 플레이스홀더는 대시보드의 키로 바꾸세요.

curl -X POST https://api.zinndigital.com/v1/compute/servers/{serverId}/resize/quote \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

로그인하셨나요? 대시보드의 API 콘솔이 실제 조직 ID와 본인의 키를 자동으로 채우고 라이브 API를 대상으로 요청을 실행하므로 실제 응답을 확인할 수 있습니다. API 콘솔에서 이 엔드포인트를 여세요

상세 정보

The provider's own figure for moving this machine to another size. A POST that changes nothing, deliberately: the size being quoted is a body field, and a quote is not a cacheable representation of a resource. ⛔ Showing it is not optional — an upgrade charged at an unstated amount is a refund request (§2.8). ⛔ amount is the provider's own string, unparsed, and it carries no currency field. Inventing one to fit a money type would put a number in front of a customer in the wrong currency, so a client renders it exactly as the provider stated it and labels it as the provider's estimate. 404 for a server that is not the caller's; 422 for a size the provider does not offer or a machine that is not in an operable state. Requires sites.view — reading a price commits to nothing.

매개변수

이름유형필수설명
serverId (path)UuidThe 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.

요청 본문

이름유형필수설명
specstring아니요The target size, as getComputeCatalogue reported it.
plan_codestring아니요The plan to move to, as getComputeCatalogue's tiers[].plan_code.

응답

이름유형필수설명
specstringThe size the figure is for.
plan_codestringThe plan quoted, on an own-account range. "" on the resold range.
price_minorinteger⛔ D24975 (W43-48). OUR price for the plan, in minor units, in the machine's own data centre at its own cadence. On an own-account range this is the only figure; amount and…
currencystringISO currency of price_minor, or "".
intervalstringmonthly or annual — the machine's billing cadence — or "".
amountstringThe provider's figure, verbatim. Rendered as the provider stated it and labelled as the provider's estimate, never reformatted.
detailstringWhatever else the provider said about the change, or "". Blank is common and is not an error.

이 엔드포인트가 반환할 수 있는 오류

401 · 403 · 404 · 422 · 429 · 503