Skip to main content
POST
Create InfiniBand partition

Authorizations

Authorization
string
header
required

Create an API token using sf tokens create or at https://sfcompute.com/dashboard/tokens.

Body

application/json
name
string
required
Required string length: 1 - 255
Pattern: [a-zA-Z0-9][a-zA-Z0-9._-]{0,254}
Example:

"my-resource-name"

workspace
string
required

Workspace to create this partition in.

Pattern: (wksp_[0-9a-zA-Z_-]{1,21})|(sfc:workspace:[a-zA-Z0-9._-]+(:[a-zA-Z0-9._-]+){1,1})
Example:

"wksp_k3R-nX9vLm7Qp2Yw5Jd8F"

fabric
null | string

InfiniBand fabric to create this partition on, by name. Only instances whose instance SKU is on this fabric (the SKU's infiniband_fabric) can join the partition. Required when the availability zone has more than one fabric.

Required string length: 1 - 255
Pattern: [a-zA-Z0-9][a-zA-Z0-9._-]{0,254}
Example:

"my-resource-name"

region
string | null

Region to create this partition in. Required unless fabric is given; must match the fabric's region when both are given.

availability_zone
string | null

Availability zone within the region. Required unless fabric is given; must match the fabric's availability zone when both are given.

Response

InfiniBand partition created.

object
string
default:infiniband_partition
required
read-only
Allowed value: "infiniband_partition"
id
string
required
Pattern: ibpart_[0-9a-zA-Z_-]{1,21}
Example:

"ibpart_k3R-nX9vLm7Qp2Yw5Jd8F"

resource_path
string
required

A resource path for a infiniband_partition resource. Format: sfc:infiniband_partition:::.

Pattern: sfc:infiniband_partition:([a-zA-Z0-9._-]+:){2}[a-zA-Z0-9._-]+
Example:

"sfc:infiniband_partition:<account_id>:<workspace>:<name>"

workspace
object
required

Workspace this partition belongs to.

name
string
required
Required string length: 1 - 255
Pattern: [a-zA-Z0-9][a-zA-Z0-9._-]{0,254}
Example:

"my-resource-name"

fabric
string
required

InfiniBand fabric serving this partition. Partitions on different fabrics cannot reach each other.

Required string length: 1 - 255
Pattern: [a-zA-Z0-9][a-zA-Z0-9._-]{0,254}
Example:

"my-resource-name"

region
string
required

The geographic region where the hardware is located, e.g. europe-north1.

availability_zone
string
required

An independent failure domain within a region, e.g. a.

created_at
integer<int64>
required

Unix timestamp.

Example:

1738972800