datacenters

Create a datacenter in the caller's tenant.

Changed on
post/datacenters

Request

  • Base URL: /api/v1 (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v1/datacenters
  • Auth: HTTP bearer

Request body

$schemastring uri

A URL to the JSON Schema for this object.

cpu_overcommit_rationumber double
insecure_skip_verifyboolean
namestring required
tokenstring
urlstring required

Example request

{
  "$schema": "/api/v1/schemas/DatacenterBody.json"
}

Response

Created

$schemastring uri

A URL to the JSON Schema for this object.

cpu_overcommit_rationumber double required

Default vCPU sold per physical core, stamped onto hypervisors as they are discovered here. 1.0 is no overcommit. Changing it does not re-rate existing hypervisors.

created_atstring date-time required
has_tokenboolean required

Whether a Proxmox API token is configured (the token itself is never returned).

idstring required
insecure_skip_verifyboolean required

Whether TLS verification is disabled for this cluster (self-signed certs).

namestring required
updated_atstring date-time required
urlstring required

Example response

{
  "$schema": "/api/v1/schemas/DatacenterView.json"
}

Changes

  • 17fb0e434059Revision changes
    • info

      added the new optional request property

    • info

      added the required property to the response with the status