Compute Service API
The Compute Service API provides services that allows provisioning and life cycle
management of Compute clusters.
Version: 1.4.0
BasePath:
All rights reserved
http://apache.org/licenses/LICENSE-2.0.html
Access
- OAuth AuthorizationUrl:https://identity.nks.europe-west4.nscale.com/oauth2/v2/authorizationTokenUrl:https://identity.nks.europe-west4.nscale.com/oauth2/v2/token
[ Jump to Models ]
Table of Contents
Up
get /api/v1/organizations/{organizationID}/clusters
(apiV1OrganizationsOrganizationIDClustersGet)
List all clusters within the organization.
Path parameters
organizationID (required)
Path Parameter — The organization ID. default: null
Query parameters
tag (optional)
Query Parameter — A set of tags to match against resources in the form "name=value",
thus when encoded you get "?tag=foo%3Dcat&bar%3Ddog". default: null
Return type
Example data
Content-Type: application/json
[ {
"metadata" : {
"modifiedTime" : "2000-01-23T04:56:07.000+00:00",
"creationTime" : "2000-01-23T04:56:07.000+00:00",
"description" : "description",
"deletionTime" : "2000-01-23T04:56:07.000+00:00",
"tags" : [ {
"name" : "name",
"value" : "value"
}, {
"name" : "name",
"value" : "value"
} ],
"organizationId" : "organizationId",
"createdBy" : "createdBy",
"healthStatus" : "unknown",
"provisioningStatus" : "unknown",
"name" : "name",
"modifiedBy" : "modifiedBy",
"id" : "id",
"projectId" : "projectId"
},
"spec" : {
"regionId" : "regionId",
"workloadPools" : [ {
"machine" : {
"image" : {
"selector" : {
"distro" : "rocky",
"variant" : "variant",
"version" : "version"
},
"id" : "id"
},
"disk" : {
"size" : 6
},
"userData" : "userData",
"publicIPAllocation" : {
"enabled" : true
},
"firewall" : [ {
"protocol" : "tcp",
"prefixes" : [ "prefixes", "prefixes" ],
"portMax" : 5,
"port" : 1,
"direction" : "ingress"
}, {
"protocol" : "tcp",
"prefixes" : [ "prefixes", "prefixes" ],
"portMax" : 5,
"port" : 1,
"direction" : "ingress"
} ],
"replicas" : 0,
"flavorId" : "flavorId",
"allowedAddressPairs" : [ {
"macAddress" : "macAddress",
"cidr" : "cidr"
}, {
"macAddress" : "macAddress",
"cidr" : "cidr"
} ]
},
"name" : "name"
}, {
"machine" : {
"image" : {
"selector" : {
"distro" : "rocky",
"variant" : "variant",
"version" : "version"
},
"id" : "id"
},
"disk" : {
"size" : 6
},
"userData" : "userData",
"publicIPAllocation" : {
"enabled" : true
},
"firewall" : [ {
"protocol" : "tcp",
"prefixes" : [ "prefixes", "prefixes" ],
"portMax" : 5,
"port" : 1,
"direction" : "ingress"
}, {
"protocol" : "tcp",
"prefixes" : [ "prefixes", "prefixes" ],
"portMax" : 5,
"port" : 1,
"direction" : "ingress"
} ],
"replicas" : 0,
"flavorId" : "flavorId",
"allowedAddressPairs" : [ {
"macAddress" : "macAddress",
"cidr" : "cidr"
}, {
"macAddress" : "macAddress",
"cidr" : "cidr"
} ]
},
"name" : "name"
} ]
},
"status" : {
"sshPrivateKey" : "sshPrivateKey",
"workloadPools" : [ {
"replicas" : 5,
"name" : "name",
"machines" : [ {
"hostname" : "hostname",
"imageID" : "imageID",
"privateIP" : "privateIP",
"flavorID" : "flavorID",
"publicIP" : "publicIP"
}, {
"hostname" : "hostname",
"imageID" : "imageID",
"privateIP" : "privateIP",
"flavorID" : "flavorID",
"publicIP" : "publicIP"
} ]
}, {
"replicas" : 5,
"name" : "name",
"machines" : [ {
"hostname" : "hostname",
"imageID" : "imageID",
"privateIP" : "privateIP",
"flavorID" : "flavorID",
"publicIP" : "publicIP"
}, {
"hostname" : "hostname",
"imageID" : "imageID",
"privateIP" : "privateIP",
"flavorID" : "flavorID",
"publicIP" : "publicIP"
} ]
} ]
}
}, {
"metadata" : {
"modifiedTime" : "2000-01-23T04:56:07.000+00:00",
"creationTime" : "2000-01-23T04:56:07.000+00:00",
"description" : "description",
"deletionTime" : "2000-01-23T04:56:07.000+00:00",
"tags" : [ {
"name" : "name",
"value" : "value"
}, {
"name" : "name",
"value" : "value"
} ],
"organizationId" : "organizationId",
"createdBy" : "createdBy",
"healthStatus" : "unknown",
"provisioningStatus" : "unknown",
"name" : "name",
"modifiedBy" : "modifiedBy",
"id" : "id",
"projectId" : "projectId"
},
"spec" : {
"regionId" : "regionId",
"workloadPools" : [ {
"machine" : {
"image" : {
"selector" : {
"distro" : "rocky",
"variant" : "variant",
"version" : "version"
},
"id" : "id"
},
"disk" : {
"size" : 6
},
"userData" : "userData",
"publicIPAllocation" : {
"enabled" : true
},
"firewall" : [ {
"protocol" : "tcp",
"prefixes" : [ "prefixes", "prefixes" ],
"portMax" : 5,
"port" : 1,
"direction" : "ingress"
}, {
"protocol" : "tcp",
"prefixes" : [ "prefixes", "prefixes" ],
"portMax" : 5,
"port" : 1,
"direction" : "ingress"
} ],
"replicas" : 0,
"flavorId" : "flavorId",
"allowedAddressPairs" : [ {
"macAddress" : "macAddress",
"cidr" : "cidr"
}, {
"macAddress" : "macAddress",
"cidr" : "cidr"
} ]
},
"name" : "name"
}, {
"machine" : {
"image" : {
"selector" : {
"distro" : "rocky",
"variant" : "variant",
"version" : "version"
},
"id" : "id"
},
"disk" : {
"size" : 6
},
"userData" : "userData",
"publicIPAllocation" : {
"enabled" : true
},
"firewall" : [ {
"protocol" : "tcp",
"prefixes" : [ "prefixes", "prefixes" ],
"portMax" : 5,
"port" : 1,
"direction" : "ingress"
}, {
"protocol" : "tcp",
"prefixes" : [ "prefixes", "prefixes" ],
"portMax" : 5,
"port" : 1,
"direction" : "ingress"
} ],
"replicas" : 0,
"flavorId" : "flavorId",
"allowedAddressPairs" : [ {
"macAddress" : "macAddress",
"cidr" : "cidr"
}, {
"macAddress" : "macAddress",
"cidr" : "cidr"
} ]
},
"name" : "name"
} ]
},
"status" : {
"sshPrivateKey" : "sshPrivateKey",
"workloadPools" : [ {
"replicas" : 5,
"name" : "name",
"machines" : [ {
"hostname" : "hostname",
"imageID" : "imageID",
"privateIP" : "privateIP",
"flavorID" : "flavorID",
"publicIP" : "publicIP"
}, {
"hostname" : "hostname",
"imageID" : "imageID",
"privateIP" : "privateIP",
"flavorID" : "flavorID",
"publicIP" : "publicIP"
} ]
}, {
"replicas" : 5,
"name" : "name",
"machines" : [ {
"hostname" : "hostname",
"imageID" : "imageID",
"privateIP" : "privateIP",
"flavorID" : "flavorID",
"publicIP" : "publicIP"
}, {
"hostname" : "hostname",
"imageID" : "imageID",
"privateIP" : "privateIP",
"flavorID" : "flavorID",
"publicIP" : "publicIP"
} ]
} ]
}
} ]
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Produces
This API call produces the following media types according to the request header;
the media type will be conveyed by the response header.
Responses
200
A list of Compute clusters.
400
Request body failed schema validation, or the request does not contain
all the required fields.
error
401
Authentication failed or the access token has expired.
error
403
Request was denied by authorization, this may be caused by the authorization
token not having the required scope for an API, or the user doesn't have the
necessary privileges on the provider platform.
error
404
Unable to find a resource.
error
500
An unexpected or unhandled error occurred. This may be a transient error and
may succeed on a retry. If this isn't the case, please report it as an issue.
error
Up
delete /api/v1/organizations/{organizationID}/projects/{projectID}/clusters/{clusterID}
(apiV1OrganizationsOrganizationIDProjectsProjectIDClustersClusterIDDelete)
Delete a cluster.
Path parameters
organizationID (required)
Path Parameter — The organization ID. default: null
projectID (required)
Path Parameter — The project ID. default: null
clusterID (required)
Path Parameter — The cluster ID. default: null
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Produces
This API call produces the following media types according to the request header;
the media type will be conveyed by the response header.
Responses
202
The request has been accepted and will be fulfilled asynchronously.
You may poll the resource and monitor its provisioning and health status
to await completion of the operation.
400
Request body failed schema validation, or the request does not contain
all the required fields.
error
401
Authentication failed or the access token has expired.
error
403
Request was denied by authorization, this may be caused by the authorization
token not having the required scope for an API, or the user doesn't have the
necessary privileges on the provider platform.
error
404
Unable to find a resource.
error
500
An unexpected or unhandled error occurred. This may be a transient error and
may succeed on a retry. If this isn't the case, please report it as an issue.
error
Up
put /api/v1/organizations/{organizationID}/projects/{projectID}/clusters/{clusterID}
(apiV1OrganizationsOrganizationIDProjectsProjectIDClustersClusterIDPut)
Update a cluster within the selected cluster manager.
Path parameters
organizationID (required)
Path Parameter — The organization ID. default: null
projectID (required)
Path Parameter — The project ID. default: null
clusterID (required)
Path Parameter — The cluster ID. default: null
Consumes
This API call consumes the following media types via the request header:
Request body
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Produces
This API call produces the following media types according to the request header;
the media type will be conveyed by the response header.
Responses
202
The request has been accepted and will be fulfilled asynchronously.
You may poll the resource and monitor its provisioning and health status
to await completion of the operation.
400
Request body failed schema validation, or the request does not contain
all the required fields.
error
401
Authentication failed or the access token has expired.
error
403
Request was denied by authorization, this may be caused by the authorization
token not having the required scope for an API, or the user doesn't have the
necessary privileges on the provider platform.
error
404
Unable to find a resource.
error
500
An unexpected or unhandled error occurred. This may be a transient error and
may succeed on a retry. If this isn't the case, please report it as an issue.
error
Up
post /api/v1/organizations/{organizationID}/projects/{projectID}/clusters
(apiV1OrganizationsOrganizationIDProjectsProjectIDClustersPost)
Creates a new cluster.
Path parameters
organizationID (required)
Path Parameter — The organization ID. default: null
projectID (required)
Path Parameter — The project ID. default: null
Consumes
This API call consumes the following media types via the request header:
Request body
Return type
Example data
Content-Type: application/json
{
"metadata" : {
"modifiedTime" : "2000-01-23T04:56:07.000+00:00",
"creationTime" : "2000-01-23T04:56:07.000+00:00",
"description" : "description",
"deletionTime" : "2000-01-23T04:56:07.000+00:00",
"tags" : [ {
"name" : "name",
"value" : "value"
}, {
"name" : "name",
"value" : "value"
} ],
"organizationId" : "organizationId",
"createdBy" : "createdBy",
"healthStatus" : "unknown",
"provisioningStatus" : "unknown",
"name" : "name",
"modifiedBy" : "modifiedBy",
"id" : "id",
"projectId" : "projectId"
},
"spec" : {
"regionId" : "regionId",
"workloadPools" : [ {
"machine" : {
"image" : {
"selector" : {
"distro" : "rocky",
"variant" : "variant",
"version" : "version"
},
"id" : "id"
},
"disk" : {
"size" : 6
},
"userData" : "userData",
"publicIPAllocation" : {
"enabled" : true
},
"firewall" : [ {
"protocol" : "tcp",
"prefixes" : [ "prefixes", "prefixes" ],
"portMax" : 5,
"port" : 1,
"direction" : "ingress"
}, {
"protocol" : "tcp",
"prefixes" : [ "prefixes", "prefixes" ],
"portMax" : 5,
"port" : 1,
"direction" : "ingress"
} ],
"replicas" : 0,
"flavorId" : "flavorId",
"allowedAddressPairs" : [ {
"macAddress" : "macAddress",
"cidr" : "cidr"
}, {
"macAddress" : "macAddress",
"cidr" : "cidr"
} ]
},
"name" : "name"
}, {
"machine" : {
"image" : {
"selector" : {
"distro" : "rocky",
"variant" : "variant",
"version" : "version"
},
"id" : "id"
},
"disk" : {
"size" : 6
},
"userData" : "userData",
"publicIPAllocation" : {
"enabled" : true
},
"firewall" : [ {
"protocol" : "tcp",
"prefixes" : [ "prefixes", "prefixes" ],
"portMax" : 5,
"port" : 1,
"direction" : "ingress"
}, {
"protocol" : "tcp",
"prefixes" : [ "prefixes", "prefixes" ],
"portMax" : 5,
"port" : 1,
"direction" : "ingress"
} ],
"replicas" : 0,
"flavorId" : "flavorId",
"allowedAddressPairs" : [ {
"macAddress" : "macAddress",
"cidr" : "cidr"
}, {
"macAddress" : "macAddress",
"cidr" : "cidr"
} ]
},
"name" : "name"
} ]
},
"status" : {
"sshPrivateKey" : "sshPrivateKey",
"workloadPools" : [ {
"replicas" : 5,
"name" : "name",
"machines" : [ {
"hostname" : "hostname",
"imageID" : "imageID",
"privateIP" : "privateIP",
"flavorID" : "flavorID",
"publicIP" : "publicIP"
}, {
"hostname" : "hostname",
"imageID" : "imageID",
"privateIP" : "privateIP",
"flavorID" : "flavorID",
"publicIP" : "publicIP"
} ]
}, {
"replicas" : 5,
"name" : "name",
"machines" : [ {
"hostname" : "hostname",
"imageID" : "imageID",
"privateIP" : "privateIP",
"flavorID" : "flavorID",
"publicIP" : "publicIP"
}, {
"hostname" : "hostname",
"imageID" : "imageID",
"privateIP" : "privateIP",
"flavorID" : "flavorID",
"publicIP" : "publicIP"
} ]
} ]
}
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Produces
This API call produces the following media types according to the request header;
the media type will be conveyed by the response header.
Responses
202
A Compute cluster.
computeClusterRead
400
Request body failed schema validation, or the request does not contain
all the required fields.
error
401
Authentication failed or the access token has expired.
error
403
Request was denied by authorization, this may be caused by the authorization
token not having the required scope for an API, or the user doesn't have the
necessary privileges on the provider platform.
error
409
Resource conflicts with another, usually this means they have the same name.
error
500
An unexpected or unhandled error occurred. This may be a transient error and
may succeed on a retry. If this isn't the case, please report it as an issue.
error
Up
get /api/v1/organizations/{organizationID}/regions
(apiV1OrganizationsOrganizationIDRegionsGet)
Lists compute service compatible regions.
Path parameters
organizationID (required)
Path Parameter — The organization ID. default: null
Return type
Example data
Content-Type: application/json
[ {
"metadata" : {
"modifiedTime" : "2000-01-23T04:56:07.000+00:00",
"creationTime" : "2000-01-23T04:56:07.000+00:00",
"createdBy" : "createdBy",
"healthStatus" : "unknown",
"provisioningStatus" : "unknown",
"name" : "name",
"description" : "description",
"modifiedBy" : "modifiedBy",
"deletionTime" : "2000-01-23T04:56:07.000+00:00",
"id" : "id",
"tags" : [ {
"name" : "name",
"value" : "value"
}, {
"name" : "name",
"value" : "value"
} ]
},
"spec" : {
"features" : {
"physicalNetworks" : true
},
"type" : "openstack"
}
}, {
"metadata" : {
"modifiedTime" : "2000-01-23T04:56:07.000+00:00",
"creationTime" : "2000-01-23T04:56:07.000+00:00",
"createdBy" : "createdBy",
"healthStatus" : "unknown",
"provisioningStatus" : "unknown",
"name" : "name",
"description" : "description",
"modifiedBy" : "modifiedBy",
"deletionTime" : "2000-01-23T04:56:07.000+00:00",
"id" : "id",
"tags" : [ {
"name" : "name",
"value" : "value"
}, {
"name" : "name",
"value" : "value"
} ]
},
"spec" : {
"features" : {
"physicalNetworks" : true
},
"type" : "openstack"
}
} ]
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Produces
This API call produces the following media types according to the request header;
the media type will be conveyed by the response header.
Responses
200
A list of regions.
400
Request body failed schema validation, or the request does not contain
all the required fields.
error
401
Authentication failed or the access token has expired.
error
500
An unexpected or unhandled error occurred. This may be a transient error and
may succeed on a retry. If this isn't the case, please report it as an issue.
error
Up
get /api/v1/organizations/{organizationID}/regions/{regionID}/flavors
(apiV1OrganizationsOrganizationIDRegionsRegionIDFlavorsGet)
Lists all compute compatible flavors that the user has access to.
Path parameters
organizationID (required)
Path Parameter — The organization ID. default: null
regionID (required)
Path Parameter — The region ID. default: null
Return type
Example data
Content-Type: application/json
[ {
"metadata" : {
"modifiedTime" : "2000-01-23T04:56:07.000+00:00",
"creationTime" : "2000-01-23T04:56:07.000+00:00",
"createdBy" : "createdBy",
"name" : "name",
"description" : "description",
"modifiedBy" : "modifiedBy",
"id" : "id",
"tags" : [ {
"name" : "name",
"value" : "value"
}, {
"name" : "name",
"value" : "value"
} ]
},
"spec" : {
"baremetal" : true,
"disk" : 1,
"memory" : 6,
"cpus" : 0,
"cpuFamily" : "cpuFamily",
"gpu" : {
"memory" : 5,
"vendor" : "NVIDIA",
"model" : "model",
"physicalCount" : 5,
"logicalCount" : 2
}
}
}, {
"metadata" : {
"modifiedTime" : "2000-01-23T04:56:07.000+00:00",
"creationTime" : "2000-01-23T04:56:07.000+00:00",
"createdBy" : "createdBy",
"name" : "name",
"description" : "description",
"modifiedBy" : "modifiedBy",
"id" : "id",
"tags" : [ {
"name" : "name",
"value" : "value"
}, {
"name" : "name",
"value" : "value"
} ]
},
"spec" : {
"baremetal" : true,
"disk" : 1,
"memory" : 6,
"cpus" : 0,
"cpuFamily" : "cpuFamily",
"gpu" : {
"memory" : 5,
"vendor" : "NVIDIA",
"model" : "model",
"physicalCount" : 5,
"logicalCount" : 2
}
}
} ]
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Produces
This API call produces the following media types according to the request header;
the media type will be conveyed by the response header.
Responses
200
A list of flavors.
400
Request body failed schema validation, or the request does not contain
all the required fields.
error
401
Authentication failed or the access token has expired.
error
500
An unexpected or unhandled error occurred. This may be a transient error and
may succeed on a retry. If this isn't the case, please report it as an issue.
error
Up
get /api/v1/organizations/{organizationID}/regions/{regionID}/images
(apiV1OrganizationsOrganizationIDRegionsRegionIDImagesGet)
Lists all compute compatible images that the user has access to.
Path parameters
organizationID (required)
Path Parameter — The organization ID. default: null
regionID (required)
Path Parameter — The region ID. default: null
Return type
Example data
Content-Type: application/json
[ {
"metadata" : "metadata",
"spec" : "spec"
}, {
"metadata" : "metadata",
"spec" : "spec"
} ]
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Example data
Content-Type: application/json
{
"error_description" : "error_description",
"error" : "invalid_request"
}
Produces
This API call produces the following media types according to the request header;
the media type will be conveyed by the response header.
Responses
200
A list of images that are compatible with this platform.
400
Request body failed schema validation, or the request does not contain
all the required fields.
error
401
Authentication failed or the access token has expired.
error
500
An unexpected or unhandled error occurred. This may be a transient error and
may succeed on a retry. If this isn't the case, please report it as an issue.
error
[ Jump to Methods ]
Table of Contents
allowedAddressPair - computeClusterMachineStatus - computeClusterNetwork - computeClusterRead - computeClusterSpec - computeClusterStatus - computeClusterWorkloadPool - computeClusterWorkloadPoolStatus - computeClusterWrite - computeImage - error - firewallRule - flavor - flavorSpec - gpuSpec - gpuVendor - image - imageGpu - imageOS - imageSelector - imageSpec - imageVirtualization - machinePool - organizationScopedResourceReadMetadata - osDistro - osFamily - osKernel - projectScopedResourceReadMetadata - publicIPAllocation - regionFeatures - regionRead - regionSpec - regionType - resourceHealthStatus - resourceMetadata - resourceProvisioningStatus - resourceReadMetadata - resourceWriteMetadata - staticResourceMetadata - tag - volume -
Allow multiple MAC/IP address (range) pairs to pass through this network port.
Typically required when the machine is operating as a router.
cidr
macAddress (optional)
String The MAC address to allow.
Compute cluster machine status.
hostname
imageID
flavorID
privateIP (optional)
String Machine private IP address.
publicIP (optional)
String Machine public IP address.
provisioningStatus
healthStatus
Compute cluster network settings.
nodePrefix (optional)
String Network prefix to provision nodes in. Must be a valid CIDR block.
dnsNameservers (optional)
Compute cluster read.
metadata
spec
status (optional)
Compute cluster creation parameters.
regionId
String The region to provision the cluster in.
workloadPools
Compute cluster status.
sshPrivateKey (optional)
String SSH private key that allows access to the cluster.
workloadPools (optional)
A Compute cluster workload pool.
Compute cluster workload pool status.
name
replicas
machines (optional)
Compute cluster create or update.
The image to use for a server.
id (optional)
selector (optional)
Generic error message, compatible with oauth2.
error
String A terse error string expanding on the HTTP error code. Errors are based on the OAuth 2.02 specification, but are expanded with proprietary status codes for APIs other than those specified by OAuth 2.02.
invalid_request
unauthorized_client
access_denied
unsupported_response_type
invalid_scope
server_error
temporarily_unavailable
invalid_client
invalid_grant
unsupported_grant_type
not_found
conflict
method_not_allowed
unsupported_media_type
forbidden
error_description
String Verbose message describing the error.
A firewall rule applied to a workload pool.
direction
String The direction of network traffic to apply the rule to.
ingress
egress
protocol
tcp
udp
port
Integer The port to allow, or start of a port range.
portMax (optional)
Integer The end of a port range, inclusive of this this port, if specified.
prefixes
array[String] A list of CIDR prefixes to allow, it might be any IPv4 or IPv6 in CIDR notation.
A flavor.
baremetal (optional)
Boolean Whether the flavor is for a dedicated machine.
cpus
cpuFamily (optional)
String A free form CPU family description e.g. model number, architecture.
memory
Integer The amount of memory in GiB.
disk
Integer The amount of ephemeral disk in GB.
gpu (optional)
GPU specification.
vendor
model
memory
physicalCount
Integer The physical number of GPUs (cards) available.
logicalCount
Integer The logical number of GPUs available as seen in the OS.
The GPU driver if installed.
vendor
driver
String The GPU driver version, this is vendor specific.
models (optional)
An operating system description.
kernel
family
distro
variant (optional)
String A free form variant e.g. desktop/server.
codename (optional)
String A free form code name e.g. warty/bionic.
version
String Version of the operating system e.g. "24.04".
A server image selector.
distro
variant (optional)
String The operating system variant.
version
String The operating system version to use.
An image.
sizeGiB
Integer Minimum disk size required to use the image in GiB.
virtualization
os
softwareVersions (optional)
gpu (optional)
What type of machine the image is for.
A Compute cluster machine pool.
replicas
flavorId
disk (optional)
firewall (optional)
publicIPAllocation (optional)
image
userData (optional)
byte[] UserData contains base64-encoded configuration information or scripts to use upon launch. format: byte
allowedAddressPairs (optional)
Metadata required by organization scoped resource reads.
name
String A valid Kubernetes label value, typically used for resource names that can be
indexed in the database.
description (optional)
String The resource description, this optionally augments the name with more context.
tags (optional)
id
String The unique resource ID.
creationTime
Date The time the resource was created. format: date-time
createdBy (optional)
String The user who created the resource.
modifiedTime (optional)
Date The time a resource was updated. format: date-time
modifiedBy (optional)
String The user who updated the resource.
deletionTime (optional)
Date The time the resource was deleted. format: date-time
provisioningStatus
healthStatus
organizationId
String The organization identifier the resource belongs to.
A family of operating systems. This typically defines the package format.
Metadata required by project scoped resource reads.
name
String A valid Kubernetes label value, typically used for resource names that can be
indexed in the database.
description (optional)
String The resource description, this optionally augments the name with more context.
tags (optional)
id
String The unique resource ID.
creationTime
Date The time the resource was created. format: date-time
createdBy (optional)
String The user who created the resource.
modifiedTime (optional)
Date The time a resource was updated. format: date-time
modifiedBy (optional)
String The user who updated the resource.
deletionTime (optional)
Date The time the resource was deleted. format: date-time
provisioningStatus
healthStatus
organizationId
String The organization identifier the resource belongs to.
projectId
String The project identifier the resource belongs to.
A public IP allocation settings.
enabled
Boolean Enable public IP allocation.
A set of features the region may provide to clients.
physicalNetworks
Boolean If set, this indicates that the region supports physical networks and
one should be provisioned for clusters to use. The implication here is
the region supports base-metal machines, and these must be provisioned
on a physical VLAN etc.
Information about the region.
The region's provider type.
The health state of a resource.
Metadata required for all API resource reads and writes.
name
String A valid Kubernetes label value, typically used for resource names that can be
indexed in the database.
description (optional)
String The resource description, this optionally augments the name with more context.
tags (optional)
The provisioning state of a resource.
Metadata required by all resource reads.
name
String A valid Kubernetes label value, typically used for resource names that can be
indexed in the database.
description (optional)
String The resource description, this optionally augments the name with more context.
tags (optional)
id
String The unique resource ID.
creationTime
Date The time the resource was created. format: date-time
createdBy (optional)
String The user who created the resource.
modifiedTime (optional)
Date The time a resource was updated. format: date-time
modifiedBy (optional)
String The user who updated the resource.
deletionTime (optional)
Date The time the resource was deleted. format: date-time
provisioningStatus
healthStatus
Metadata required for all API resource reads and writes.
name
String A valid Kubernetes label value, typically used for resource names that can be
indexed in the database.
description (optional)
String The resource description, this optionally augments the name with more context.
tags (optional)
This metadata is for resources that just exist, and don't require
any provisioning and health status, but benefit from a standardized
metadata format.
name
String A valid Kubernetes label value, typically used for resource names that can be
indexed in the database.
description (optional)
String The resource description, this optionally augments the name with more context.
tags (optional)
id
String The unique resource ID.
creationTime
Date The time the resource was created. format: date-time
createdBy (optional)
String The user who created the resource.
modifiedTime (optional)
Date The time a resource was updated. format: date-time
modifiedBy (optional)
String The user who updated the resource.
A tag mapping arbitrary names to values. These have no special meaning
for any component are are intended for use by end users to add additional
context to a resource, for example to categorize it.
A volume. This is currently only valid for VM based flavors.