https://hosting.gcore.com/billmgr. The func parameter selects the action.
Sign in with the existing Hosting Portal account. Contact support and send the company details and the source IP address. What to send is on the reseller page.Support adds that IP address to the allow list and adds the account to the reseller group. Send the calls below from that address. If the host also has IPv6, force the call over the allow-listed IPv4.
authinfo from the IPv6 address is rejected.Authenticate
authinfo is the Hosting Portal username and password, separated by a colon. out=json selects a JSON response. Send both on every call. The password stays in the POST body. The first call is the tariff list below.
Read a failed call
An HTTP error means the call did not return a billing document. A call can also return HTTP 200 and still fail. Then the failure text is indoc.error.msg, and doc.list is absent. Read doc.error before using the list.
Tariffs available to order
Request the virtual server catalog for one location.datacenter is the location id. This call reads Baku:
pricelist, the name in title, the location, and the price for one, three, six, and 12 months. The location on a tariff is the datacenter object (id and value).
Text values sit in $. period is a number of months. This object is one tariff returned by v2.vds.order.pricelist for Buenos Aires:
slist, in the entry whose $name is datacenter. Each value has the location id in $key and the location name in $. Repeat the catalog call with datacenter set to each $key. Each call returns only that location’s tariffs. Together those calls are the full catalog.
To retrieve tariffs from all available locations, run this Python script. It saves the virtual and dedicated server catalogs to separate JSON files for each location:
Pay for the order
Add funds to the account balance before placing orders. Theskipbasket=on parameter charges the order from that balance instead of adding it to the cart. Renewals are also paid from the account balance.
If the account balance is insufficient, the API returns
doc.error with $type set to not_enough_money. The service is not created.An order totaling 4.95 EUR with a balance of 0.00 EUR and no available credit returned this error.Order a virtual server
Takepricelist and datacenter.id from the catalog. This call opens the order form and does not place the order:
domain (the server name), ostempl (the operating system), and order_period (1, 3, 6, or 12). Read ostempl from this response. Ubuntu 22.04 is VM6_ISPsystem_Ubuntu-22.04. The form also returns addon_* fields for that tariff. On KVM-SSD-2-DTA in Baku, public IPv4 is addon_171555 (a count, minimum 1) and IPv6 is addon_171556 (a checkbox). Another tariff uses other ids. Read the names from the form for the tariff being ordered.
Submit the same function with sok=ok and skipbasket=on.
pricelist, datacenter, order_period, domain, and ostempl come from the catalog and the form. A request without sok=ok returns the form and does not order the server. Check the response for doc.error. To find the ordered server and check its status, see Read the service.
Order a dedicated server
Takepricelist and datacenter.id from v2.dedic.order.pricelist. This call opens the order form and does not place the order:
domain (the server name), ostempl (the operating system), and order_period (1, 3, 6, or 12). Read ostempl from this response. The form also returns addon_* fields for that tariff. On tariff 152029 in Sydney the add-ons include public IPv4, IPv6, and traffic. Another tariff uses other ids. Read the names from the form for the tariff being ordered.
Submit the same function with sok=ok and skipbasket=on.
pricelist, datacenter, order_period, domain, and ostempl come from the catalog and the form. A request without sok=ok returns the form and does not order the server. Check the response for doc.error. To find the ordered server and check its status, see Read the service.
Read the service
After the order, list the virtual servers:func=dedic. Read id and item_status on the service. $ is the label and $orig is the status code. An active virtual server returns this object:
Manage the service
Use the service id from the previous section to reboot a server, open its console, reinstall the operating system, or renew the service. Reboot a virtual server withservice.reboot.confirm. The form includes a force checkbox. Add force=on to set it.
service.reboot with the same elid and sok=ok.
Open the virtual server console with vds_open_vnc and the service id. The response field ok has $type url. The value in $ is the console address for that response.
vds_send_reinstall_request. The form requires os_pool and code. os_pool is an OS template key, the same kind of value as ostempl. code is a TOTP token. The call replaces the installed system.
service.prolong. The form returns period for one, three, six, and 12 months, with the price for each. skipbasket=on charges the renewal from the account balance.