Create a Server

code examples curl request post \\ \ url 'https //api ionos com/cloudapi/v6/datacenters/{datacenterid}/servers?pretty=true\&depth=integer%3cint32%3e' \\ \ header 'accept application/json' \\ \ header 'content type application/json' \\ \ data '{ "type" {}, "properties" { "bootcdrom" { "id" "", "type" {} }, "bootvolume" { "id" "", "type" {} } }, "entities" { "cdroms" { "type" {}, "items" \[ { "type" {}, "properties" { "requirelegacybios" true, "licencetype" "linux" } } ] }, "volumes" { "type" {}, "items" \[ { "type" {}, "properties" { "size" 100, "requirelegacybios" true, "bootorder" "auto" } } ] }, "nics" { "type" {}, "items" \[ { "type" {}, "properties" { "dhcp" true, "dhcpv6" true, "lan" 2 } } ] }, "securitygroups" { "type" {}, "items" \[ { "type" {}, "properties" { "name" "my security group" } } ] }, "gpus" { "type" {}, "items" \[ { "type" {}, "properties" {} } ] } } }'var myheaders = new headers(); myheaders append("accept", "application/json"); myheaders append("content type", "application/json"); var raw = json stringify({ "type" {}, "properties" { "bootcdrom" { "id" "", "type" {} }, "bootvolume" { "id" "", "type" {} } }, "entities" { "cdroms" { "type" {}, "items" \[ { "type" {}, "properties" { "requirelegacybios" true, "licencetype" "linux" } } ] }, "volumes" { "type" {}, "items" \[ { "type" {}, "properties" { "size" 100, "requirelegacybios" true, "bootorder" "auto" } } ] }, "nics" { "type" {}, "items" \[ { "type" {}, "properties" { "dhcp" true, "dhcpv6" true, "lan" 2 } } ] }, "securitygroups" { "type" {}, "items" \[ { "type" {}, "properties" { "name" "my security group" } } ] }, "gpus" { "type" {}, "items" \[ { "type" {}, "properties" {} } ] } } }); var requestoptions = { method 'post', headers myheaders, body raw, redirect 'follow' }; fetch("https //api ionos com/cloudapi/v6/datacenters/{datacenterid}/servers?pretty=true\&depth=integer\<int32>", requestoptions) then(response => response text()) then(result => console log(result)) catch(error => console log('error', error));require "uri" require "json" require "net/http" url = uri("https //api ionos com/cloudapi/v6/datacenters/{datacenterid}/servers?pretty=true\&depth=integer\<int32>") https = net http new(url host, url port) https use ssl = true request = net http post new(url) request\["accept"] = "application/json" request\["content type"] = "application/json" request body = json dump({ "type" {}, "properties" { "bootcdrom" { "id" "", "type" {} }, "bootvolume" { "id" "", "type" {} } }, "entities" { "cdroms" { "type" {}, "items" \[ { "type" {}, "properties" { "requirelegacybios" true, "licencetype" "linux" } } ] }, "volumes" { "type" {}, "items" \[ { "type" {}, "properties" { "size" 100, "requirelegacybios" true, "bootorder" "auto" } } ] }, "nics" { "type" {}, "items" \[ { "type" {}, "properties" { "dhcp" true, "dhcpv6" true, "lan" 2 } } ] }, "securitygroups" { "type" {}, "items" \[ { "type" {}, "properties" { "name" "my security group" } } ] }, "gpus" { "type" {}, "items" \[ { "type" {}, "properties" {} } ] } } }) response = https request(request) puts response read body import requests import json url = "https //api ionos com/cloudapi/v6/datacenters/{datacenterid}/servers?pretty=true\&depth=integer\<int32>" payload = json dumps({ "type" {}, "properties" { "bootcdrom" { "id" "", "type" {} }, "bootvolume" { "id" "", "type" {} } }, "entities" { "cdroms" { "type" {}, "items" \[ { "type" {}, "properties" { "requirelegacybios" true, "licencetype" "linux" } } ] }, "volumes" { "type" {}, "items" \[ { "type" {}, "properties" { "size" 100, "requirelegacybios" true, "bootorder" "auto" } } ] }, "nics" { "type" {}, "items" \[ { "type" {}, "properties" { "dhcp" true, "dhcpv6" true, "lan" 2 } } ] }, "securitygroups" { "type" {}, "items" \[ { "type" {}, "properties" { "name" "my security group" } } ] }, "gpus" { "type" {}, "items" \[ { "type" {}, "properties" {} } ] } } }) headers = { 'accept' 'application/json', 'content type' 'application/json' } response = requests request("post", url, headers=headers, data=payload) print(response text) responses // successful operation { "id" "15f67991 0f51 4efc a8ad ef1fb31a480c", "type" {}, "href" "\<resource uri>", "metadata" { "etag" "45480eb3fbfc31f1d916c1eaa4abdcc3", "createddate" "2015 12 04t14 34 09 809z", "createdby" "user\@example com", "createdbyuserid" "user\@example com", "lastmodifieddate" "2015 12 04t14 34 09 809z", "lastmodifiedby" "user\@example com", "lastmodifiedbyuserid" "63cef532 26fe 4a64 a4e0 de7c8a506c90", "state" "available" }, "properties" { "templateuuid" "15f67991 0f51 4efc a8ad ef1fb31a480c", "name" "my resource", "hostname" "myhostname", "cores" 4, "ram" 4096, "availabilityzone" "auto", "vmstate" "running", "bootcdrom" {}, "bootvolume" {}, "cpufamily" "intel icelake", "type" "cube", "enabledfeatures" \[ "" ], "placementgroupid" "", "nicmultiqueue" true, "maxnetworkbandwidth" 6 }, "entities" { "cdroms" { "id" "15f67991 0f51 4efc a8ad ef1fb31a480c", "type" {}, "href" "\<resource uri>", "items" \[ { "id" "15f67991 0f51 4efc a8ad ef1fb31a480c", "type" {}, "href" "\<resource uri>", "metadata" { "etag" "45480eb3fbfc31f1d916c1eaa4abdcc3", "createddate" "2015 12 04t14 34 09 809z", "createdby" "user\@example com", "createdbyuserid" "user\@example com", "lastmodifieddate" "2015 12 04t14 34 09 809z", "lastmodifiedby" "user\@example com", "lastmodifiedbyuserid" "63cef532 26fe 4a64 a4e0 de7c8a506c90", "state" "available" }, "properties" { "name" "my resource", "description" "the image/snapshot of ubuntu ", "location" "us/las", "size" 100, "cpuhotplug" true, "cpuhotunplug" true, "ramhotplug" true, "ramhotunplug" true, "nichotplug" true, "nichotunplug" true, "discvirtiohotplug" true, "discvirtiohotunplug" true, "discscsihotplug" true, "discscsihotunplug" true, "exposeserial" true, "requirelegacybios" true, "licencetype" "linux", "applicationtype" "mssql 2019 standard", "imagetype" "hdd", "public" true, "imagealiases" \[ "" ], "requiredfeatures" \[ "" ], "cloudinit" "v1" } } ], "offset" 0, "limit" 1000, " links" { "prev" "\<previous page uri>", "self" "\<this page uri>", "next" "\<next page uri>" } }, "volumes" { "id" "15f67991 0f51 4efc a8ad ef1fb31a480c", "type" {}, "href" "\<resource uri>", "items" \[ { "id" "15f67991 0f51 4efc a8ad ef1fb31a480c", "type" {}, "href" "\<resource uri>", "metadata" { "etag" "45480eb3fbfc31f1d916c1eaa4abdcc3", "createddate" "2015 12 04t14 34 09 809z", "createdby" "user\@example com", "createdbyuserid" "user\@example com", "lastmodifieddate" "2015 12 04t14 34 09 809z", "lastmodifiedby" "user\@example com", "lastmodifiedbyuserid" "63cef532 26fe 4a64 a4e0 de7c8a506c90", "state" "available" }, "properties" { "name" "my resource", "type" "hdd", "size" 100, "availabilityzone" "auto", "image" "d6ad1576 fde9 4696 aa41 1ebd75bdaf49", "imagepassword" "mypass123", "sshkeys" \[ "" ], "bus" "virtio", "licencetype" "linux", "applicationtype" "mssql 2019 standard", "cpuhotplug" true, "ramhotplug" true, "nichotplug" true, "nichotunplug" true, "discvirtiohotplug" true, "discvirtiohotunplug" true, "exposeserial" true, "requirelegacybios" true, "devicenumber" 3, "pcislot" 7, "backupunitid" "25f67991 0f51 4efc a8ad ef1fb31a481c", "userdata" "", "bootserver" "25f67991 0f51 4efc a8ad ef1fb31a481c", "bootorder" "auto" } } ], "offset" 0, "limit" 1000, " links" { "prev" "\<previous page uri>", "self" "\<this page uri>", "next" "\<next page uri>" } }, "nics" { "id" "15f67991 0f51 4efc a8ad ef1fb31a480c", "type" {}, "href" "\<resource uri>", "items" \[ { "id" "15f67991 0f51 4efc a8ad ef1fb31a480c", "type" {}, "href" "\<resource uri>", "metadata" { "etag" "45480eb3fbfc31f1d916c1eaa4abdcc3", "createddate" "2015 12 04t14 34 09 809z", "createdby" "user\@example com", "createdbyuserid" "user\@example com", "lastmodifieddate" "2015 12 04t14 34 09 809z", "lastmodifiedby" "user\@example com", "lastmodifiedbyuserid" "63cef532 26fe 4a64 a4e0 de7c8a506c90", "state" "available" }, "properties" { "name" "my resource", "mac" "00 0a 95 9d 68 16", "ips" \[ "" ], "dhcp" true, "ipv6ips" \[ "" ], "ipv6cidrblock" "2001\ db8\ b06d 8f5a 0609 /80", "dhcpv6" true, "lan" 2, "firewallactive" false, "firewalltype" "ingress", "devicenumber" 3, "pcislot" 7, "vnet" "" }, "entities" { "flowlogs" { "id" "15f67991 0f51 4efc a8ad ef1fb31a480c", "type" {}, "href" "\<resource uri>", "items" \[ { "" "" } ], "offset" 0, "limit" 1000, " links" { "" "" } }, "firewallrules" { "id" "15f67991 0f51 4efc a8ad ef1fb31a480c", "type" {}, "href" "\<resource uri>", "items" \[ { "" "" } ], "offset" 0, "limit" 1000, " links" { "" "" } }, "securitygroups" { "id" "15f67991 0f51 4efc a8ad ef1fb31a480c", "type" {}, "href" "\<resource uri>", "items" \[ { "" "" } ], "offset" 0, "limit" 1000, " links" { "" "" } } } } ], "offset" 0, "limit" 1000, " links" { "prev" "\<previous page uri>", "self" "\<this page uri>", "next" "\<next page uri>" } }, "securitygroups" { "id" "15f67991 0f51 4efc a8ad ef1fb31a480c", "type" {}, "href" "\<resource uri>", "items" \[ { "id" "15f67991 0f51 4efc a8ad ef1fb31a480c", "type" {}, "href" "\<resource uri>", "metadata" { "etag" "45480eb3fbfc31f1d916c1eaa4abdcc3", "createddate" "2015 12 04t14 34 09 809z", "createdby" "user\@example com", "createdbyuserid" "user\@example com", "lastmodifieddate" "2015 12 04t14 34 09 809z", "lastmodifiedby" "user\@example com", "lastmodifiedbyuserid" "63cef532 26fe 4a64 a4e0 de7c8a506c90", "state" "available" }, "properties" { "name" "my security group", "description" "my security group description" }, "entities" { "rules" { "id" "15f67991 0f51 4efc a8ad ef1fb31a480c", "type" {}, "href" "\<resource uri>", "items" \[ { "" "" } ], "offset" 0, "limit" 1000, " links" { "" "" } }, "nics" { "id" "15f67991 0f51 4efc a8ad ef1fb31a480c", "type" {}, "href" "\<resource uri>", "items" \[ { "" "" } ], "offset" 0, "limit" 1000, " links" { "" "" } }, "servers" { "id" "15f67991 0f51 4efc a8ad ef1fb31a480c", "type" {}, "href" "\<resource uri>", "items" \[ { "" "" } ], "offset" 0, "limit" 1000, " links" { "" "" } } } } ], "offset" 0, "limit" 1000, " links" { "prev" "\<previous page uri>", "self" "\<this page uri>", "next" "\<next page uri>" } }, "gpus" { "id" "25f67991 0f51 4efc a8ad ef1fb31a400c", "type" {}, "href" "\<resource uri>", "items" \[ { "id" "25f67991 0f51 4efc a8ad ef1fb31a400c", "type" {}, "href" "\<resource uri>", "metadata" { "etag" "45480eb3fbfc31f1d916c1eaa4abdcc3", "createddate" "2015 12 04t14 34 09 809z", "createdby" "user\@example com", "createdbyuserid" "user\@example com", "lastmodifieddate" "2015 12 04t14 34 09 809z", "lastmodifiedby" "user\@example com", "lastmodifiedbyuserid" "63cef532 26fe 4a64 a4e0 de7c8a506c90", "state" "available" }, "properties" { "name" "my gpu", "vendor" "nvidia", "model" "a100", "type" "passthrough" } } ], "offset" 0, "limit" 1000, " links" { "prev" "\<previous page uri>", "self" "\<this page uri>", "next" "\<next page uri>" } } } }// any erroneous status code 400 (parse error), 401 (auth error), 402 (trial access), 403 (insufficient privileges), 404 (not found), 405 (unsupported http method), 415 (unsupported content type, 422 (validation error), 429 (request rate limit exceeded), 500 (server error), or 503 (maintenance) { "httpstatus" 400, "messages" \[ { "errorcode" "123", "message" "error message example " } ] }